PHP 5 核心函數速查大全：分類索引、常用範例與現代替代建議

PHP 內建函數超過 1000 個，記憶不切實際，善用「分類索引 + 高頻核心」才是高效開發關鍵。本文將官方函數庫按功能域重新組織，標註高頻必會函數、常見誤區、PHP 7/8 現代替代方案，並提供可離線查閱的結構化速查表。

一、函數分類導覽圖

二、高頻函數「避坑」與現代替代速查

三、字串處理「黃金組合」實戰範例

<?php
// 1. 安全截取 UTF-8 字串 (mbstring)
function mbTruncate(string $str, int $length, string $suffix = '...'): string
{
    if (mb_strlen($str) <= $length) return $str;
    return mb_substr($str, 0, $length) . $suffix;
}

// 2. 靈活分割：多字元分隔符 + 過濾空值
$tags = array_filter(array_map('trim', preg_split('/[,，;；\s|]+/', $input)));

// 3. 模板替換：陣列鍵值對應
$template = 'Hello {name}, your order {id} is {status}.';
$data = ['name' => 'John', 'id' => 'A123', 'status' => 'shipped'];
echo strtr($template, $data); // 最快、單次遍歷、不重複替換

// 4. 安全輸出 HTML
echo htmlspecialchars($userInput, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
// 或使用現代模板引擎自動逃逸

// 5. 密碼驗證常數時間比較 (防時序攻擊)
if (hash_equals($expectedHash, $providedHash)) { /* ... */ }
?>

四、陣列操作「函數式風格」最佳實踐

<?php
$users = [
    ['id' => 1, 'name' => 'Alice', 'age' => 28, 'roles' => ['admin']],
    ['id' => 2, 'name' => 'Bob', 'age' => 35, 'roles' => ['editor']],
    ['id' => 3, 'name' => 'Charlie', 'age' => 22, 'roles' => ['viewer']],
];

// 篩選 + 映射 + 索引重建 (鏈式，PHP 7.4+ 箭頭函數)
$adultAdmins = array_values(array_filter($users, fn($u) => $u['age'] >= 18 && in_array('admin', $u['roles'])));

// 分組索引：按角色分組
$byRole = [];
foreach ($users as $u) {
    foreach ($u['roles'] as $role) {
        $byRole[$role][] = $u['name'];
    }
}

// 唯一值統計
$roleCounts = array_count_values(array_merge(...array_column($users, 'roles')));

// 多鍵排序：年齡降冪、名稱升冪
array_multisort(
    array_column($users, 'age'), SORT_DESC,
    array_column($users, 'name'), SORT_ASC,
    $users
);

// 記憶體友善：大陣列分塊處理
function chunkProcess(array $data, int $size, callable $fn): void
{
    foreach (array_chunk($data, $size, true) as $chunk) {
        $fn($chunk);
        unset($chunk); // 及時釋放
    }
}
?>

五、檔案與資料流：現代資源管理模式

<?php
// 1. 讀取大檔案：生成器逐行 (記憶體常數)
function readLines(string $path): Generator
{
    $fp = fopen($path, 'r');
    try {
        while (($line = fgets($fp)) !== false) {
            yield rtrim($line, "\r\n");
        }
    } finally {
        fclose($fp);
    }
}

foreach (readLines('huge.log') as $line) {
    if (str_contains($line, 'ERROR')) { /* ... */ }
}

// 2. 原子寫入：臨時檔 + rename (防止部分寫入被讀取)
function atomicPut(string $path, string $data): void
{
    $tmp = $path . '.tmp.' . bin2hex(random_bytes(8));
    file_put_contents($tmp, $data);
    rename($tmp, $path); // 同檔案系統下原子
}

// 3. CSV 標準讀寫
function readCsv(string $path): Generator
{
    $fp = fopen($path, 'r');
    $header = fgetcsv($fp);
    while (($row = fgetcsv($fp)) !== false) {
        yield array_combine($header, $row);
    }
    fclose($fp);
}

function writeCsv(string $path, iterable $rows, array $header): void
{
    $fp = fopen($path, 'w');
    fputcsv($fp, $header);
    foreach ($rows as $row) {
        fputcsv($fp, array_intersect_key($row, array_flip($header)));
    }
    fclose($fp);
}
?>

六、離線速查工具推薦

• Dash / Zeal / Velocity：離線文檔瀏覽器，支援 PHP 官方文檔、Laravel、Symfony 等 200+ Docset
• PHPStorm / VS Code (PHP Intelephense)：滑鼠懸停即時顯示簽名、說明、連結官方文檔
• php.net/download-docs.php：下載 CHM/HTML 版官方手冊（含中文）
• 自建速查表：將本文表格匯出 Markdown/Notion/Obsidian，按專案需求精簡

七、總結：建立你的「核心函數肌肉記憶」

1. 背誦 30-50 個最高頻函數（字串、陣列、檔案、日期、資料庫、JSON、安全）
2. 遇到新需求先查分類表，而非盲目搜尋
3. 重構時主動替換棄用函數，技術債利息極高
4. 善用 IDE 智慧提示，減少查閱成本
5. 關注 PHP 版本釋出說明，掌握新函數（如 str_contains, str_starts_with, array_is_list, fsync 等）

函數是 PHP 的詞彙，框架是語法，架構是文章。詞彙貧乏，寫不出好文章。從今天開始，每天掌握一個新函數的現代用法。