PHP 內置函數超過 5000 個,新手易迷失。本文精選**高頻、實用、易混淆**的核心函數,按場景分類整理,附帶參數說明、返回值、常見坑點、對比示例,可作為桌面速查手冊。
| 函數 | 說明 | 注意 |
|---|---|---|
strlen($str) | 字節長度 | 中文 UTF-8 佔 3 字節,GBK 佔 2 字節 |
mb_strlen($str, 'UTF-8') | 字符長度(多字節安全) | 需 mbstring 擴展,處理中文必用 |
mb_internal_encoding('UTF-8') | 設置 mbstring 內部編碼 | 建議入口文件統一設置,避免重複傳參 |
strtolower($str) // 全小寫
strtoupper($str) // 全大寫
ucfirst($str) // 首字符大寫
ucwords($str) // 每個單詞首字母大寫
mb_strtolower($str) // 多字節安全版
mb_convert_case($str, MB_CASE_TITLE, 'UTF-8') // 標題大小寫(更智能)
| 函數 | 用途 | 返回值 | 大小寫 | 二進制安全 |
|---|---|---|---|---|
strcmp($a, $b) | 比較 | <0, =0, >0 | 敏感 | 是 |
strcasecmp($a, $b) | 比較 | <0, =0, >0 | 不敏感 | 是 |
strpos($hay, $needle, $offset) | 首次出現位置 | int/false | 敏感 | 是 |
stripos() | 首次出現 | int/false | 不敏感 | 是 |
strrpos() | 最後出現 | int/false | 敏感 | 是 |
strstr($hay, $needle) | 從首次出現到結尾 | string/false | 敏感 | 是 |
stristr() | 同上 | string/false | 不敏感 | 是 |
坑點: strpos 返回 0 表示開頭匹配,必須用 === false 判斷未找到。
// 替換
str_replace($search, $replace, $subject, $count) // 區分大小寫,支持陣列
str_ireplace() // 不區分大小寫
substr_replace($str, $replacement, $start, $length) // 替換部分
// 分割
explode($delimiter, $string, $limit) // 字符串 → 陣列
implode($glue, $pieces) // 陣列 → 字符串 (別名 join)
str_split($string, $length) // 固定長度分割
// 正則分割(性能較差,非必要勿用)
preg_split($pattern, $string, $limit, $flags)
substr($str, $start, $length) // 截取,$start 可為負數(從末尾)
mb_substr($str, $start, $length, 'UTF-8') // 多字節安全
str_pad($str, $length, $pad_string, $pad_type) // 填充:STR_PAD_LEFT/RIGHT/BOTH
htmlspecialchars($str, ENT_QUOTES, 'UTF-8') // XSS 防護必用,轉義 & " ' < >
htmlentities($str, ENT_QUOTES, 'UTF-8') // 所有 HTML 實體
strip_tags($str, '
這是新手最容易混淆、導致安全漏洞的地方。
| 函數 | 檢測條件 | 返回 true 的情況 | 返回 false 的情況 | 適用場景 |
|---|---|---|---|---|
isset($var) |
變量存在且 != null | $a=0, $a='', $a=false, $a='0' | 未定義、$a=null | 檢查 $_GET/$_POST 是否傳遞了鍵(不管值是否為空) |
empty($var) |
變量為「空值」 | 未定義、null、false、0、'0'、''、[] | 非空字符串、非零數字、非空陣列、對象 | 檢查用戶輸入是否「有實際內容」 |
is_numeric($var) |
純數字或數字字符串 | '123', '1.23', '0xFF', 123 | '123abc', '', '1,234' | 驗證數量、ID、價格等數值類輸入 |
<?php
// 1. 必填字段:存在且非空
if (!isset($_POST['username']) || empty($_POST['username'])) {
exit('用戶名必填');
}
// 2. 數字字段:存在且是數字
if (!isset($_POST['age']) || !is_numeric($_POST['age'])) {
exit('年齡必須為數字');
}
// 3. 可選字段:不存在時給默認值
$age = isset($_POST['age']) && is_numeric($_POST['age']) ? (int)$_POST['age'] : 18;
// 4. 日期驗證
if (isset($_POST['birth'])) {
$parts = explode('-', $_POST['birth']);
if (count($parts) !== 3 || !checkdate($parts[1], $parts[2], $parts[0])) {
exit('日期格式無效');
}
}
// 運行時修改配置(僅影響當前腳本)
ini_set('display_errors', 1);
ini_set('error_reporting', E_ALL);
ini_set('max_execution_time', 300); // 5分鐘
ini_set('memory_limit', '256M');
ini_set('default_socket_timeout', 60); // 流超時
// 讀取配置
$maxTime = ini_get('max_execution_time'); // 返回字符串
$magicQuotes = ini_get('magic_quotes_gpc'); // PHP 5.4+ 已移除,歷史項目兼容用
// 獲取所有配置
$all = ini_get_all();
array_merge($a, $b) // 合併(數字鍵重新索引,字符串鍵後覆蓋前)
$a + $b // 聯合(保留第一個陣列的鍵,不覆蓋)
array_filter($arr, $callback) // 過濾
array_map($callback, $arr) // 映射轉換
array_reduce($arr, $callback) // 歸約
array_column($arr, 'key') // 提取列(PHP 5.5+)
array_key_exists($key, $arr) // 檢查鍵存在(比 isset 更準確,null 值也返回 true)
in_array($needle, $arr, true) // 嚴格模式第三參數 true
file_get_contents($file) // 讀整個文件 → 字符串
file_put_contents($file, $data, FILE_APPEND|LOCK_EX) // 寫入/追加/鎖定
file($file) // 讀整個文件 → 陣列(每行一個元素)
fopen/fread/fwrite/fclose // 流式操作大文件
is_file / is_dir / is_readable / is_writable
filesize / filemtime / filectime
pathinfo($path) // 返回 ['dirname','basename','extension','filename']
realpath($path) // 規範化絕對路徑(解析符號鏈接、相對路徑)
glob($pattern) // 模式匹配文件
scandir($dir) // 列出目錄
is_int / is_float / is_string / is_array / is_object / is_bool / is_null / is_resource
is_scalar() // int/float/string/bool
is_callable() // 可調用
gettype($var) // 返回類型字符串
=== false 判斷。+ 或 array_replace。htmlspecialchars($str, ENT_QUOTES, 'UTF-8')。JSON_UNESCAPED_UNICODE。LOCK_EX,讀取大文件用流。abs($a-$b) < 0.0001 或 bccomp。$_GET['x'] ?? '' (PHP 7+)。收藏本文,下次查函數直接 Ctrl+F。掌握這 80% 高頻函數,應付 95% 業務開發綽綽有餘。