PHP 核心函數速查手冊：日期、字串、陣列、JSON 與輸出控制

前言

PHP 內建超過 1000 個函數，掌握高頻核心函數是高效開發的關鍵。本文按功能分類整理實戰常用函數，附帶參數說明與最佳實踐。

一、日期時間處理

date() 格式字符速查

Y - 4位年份    y - 2位年份
m - 月份(01-12)  n - 月份(1-12)  M - 縮寫月名  F - 完整月名
d - 日(01-31)   j - 日(1-31)    D - 縮寫週名  l - 完整週名
H - 24時(00-23) h - 12時(01-12) i - 分(00-59) s - 秒(00-59)
a - am/pm       A - AM/PM
c - ISO 8601    r - RFC 2822    U - Unix 時間戳

二、檔案引入與自動載入

現代專案請使用 Composer PSR-4 自動載入，避免手動 require。

三、輸出與格式化

常用格式化佔位符

• %s 字串
• %d 有號整數
• %f 浮點數 (預設 6 位小數)
• %.2f 保留 2 位小數
• %x 十六進位小寫
• %08x 8 位十六進位前導零

四、字串操作核心函數

五、陣列操作大全

建立與基本屬性

$arr = ['k0' => 'a', 'k1' => 'b', 'k2' => 'c'];
count($arr);           // 3
array_keys($arr);      // ['k0','k1','k2']
array_values($arr);    // ['a','b','c'] (重新索引)
array_key_exists('k1', $arr); // true
in_array('b', $arr);   // true (值搜尋)

指標操作 (內部指標)

current($arr);  // 'a'
next($arr);     // 'b'
prev($arr);     // 'a'
end($arr);      // 'c'
reset($arr);    // 'a'
key($arr);      // 當前鍵
each($arr);     // ['key'=>'k0','value'=>'a',0=>'k0',1=>'a'] 並前進

增刪改 (修改原陣列)

排序 (全部修改原陣列，返回 bool)

進階操作 (返回新陣列，不修改原陣列)

array_merge($a, $b);           // 合併 (數字鍵重排，字串鍵後蓋前)
array_combine($keys, $values); // 鍵值組合成關聯陣列
array_slice($arr, 2, 3);       // 切片 (保留鍵名需第4參數 true)
array_chunk($arr, 2, true);    // 分塊
array_unique($arr);            // 去重 (保留首次出現鍵名)
array_filter($arr, fn($v)=>$v>0); // 過濾
array_map(fn($v)=>$v*2, $arr);    // 映射
array_reduce($arr, fn($c,$v)=>$c+$v, 0); // 歸約求和
array_column($users, 'name');      // 提取欄位
array_keys($arr, 'value');         // 反向搜尋鍵名

陣列運算

$a + $b;        // 聯集 (左優先保留鍵名)
array_diff($a, $b);   // 差集 (值比較)
array_intersect($a, $b); // 交集 (值比較)
array_diff_key($a, $b);  // 鍵名差集

六、JSON 處理最佳實踐

$data = ['id' => 1, 'name' => '中文', 'tags' => ['a', 'b']];

// 編碼
$json = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_THROW_ON_ERROR);
// {"id":1,"name":"中文","tags":["a","b"]}

// 解碼為關聯陣列 (推薦)
$arr = json_decode($json, true, 512, JSON_THROW_ON_ERROR);

// 解碼為物件
$obj = json_decode($json, false, 512, JSON_THROW_ON_ERROR);
// $obj->name

// 錯誤處理 (PHP 7.3+ JSON_THROW_ON_ERROR 拋出 JsonException)
try {
    $data = json_decode($invalidJson, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
    log_error('JSON 解析失敗: ' . $e->getMessage());
}

七、效能微優化提醒

• isset($arr['key']) 比 array_key_exists('key', $arr) 快 (語言結構 vs 函數)
• in_array 大陣列 O(n)；頻繁查找請改 isset($lookup[$val]) 或 array_flip 後查鍵
• array_push($arr, $v) 比 $arr[] = $v 慢 (函數調用開銷)
• 大量字串拼接用 implode 或 sprintf，避免循環 .=
• 啟用 OPcache，預編譯腳本大幅降低函數調用開銷

結語

熟練運用核心函數是 PHP 開發者的基本功。建議將本文作為桌邊速查，遇到陌生函數優先查閱 PHP 官方手冊，注意版本差異與棄用提醒。