PHP 是弱型別語言,變數類型可隱性轉換,精確判斷類型是撰寫健壯程式的關鍵。本文系統整理 gettype()、is_* 系列函數,並說明常見誤區與最佳實踐。
$type = gettype($var); // 回傳 'boolean', 'integer', 'double', 'string', 'array', 'object', 'resource', 'NULL', 'unknown type'
'resource',PHP 7.1+ 已棄用 'resource' 字串改回 'resource' (同舊),但建議改用 is_resource()。| 函數 | 判斷目標 | 備註 |
|---|---|---|
is_bool() | 布林值 | |
is_int() / is_integer() / is_long() | 整數 | 三者同義 |
is_float() / is_double() / is_real() | 浮點數 | 三者同義 |
is_string() | 字串 | |
is_array() | 陣列 | |
is_object() | 物件 | |
is_resource() | 資源 (資料庫連線、檔案控制代碼等) | |
is_null() | NULL 值 | 等同 $var === null |
is_scalar() | 純量類型 (bool/int/float/string) | 不含 array/object/resource/null |
is_numeric() | 數字或純數字字串 | '123'、'1.23'、0xFF 皆回傳 true |
is_callable() | 可呼叫結構 (函數名、陣列呼叫式、Closure、__invoke 物件) | 可選第二參數檢查語法是否合法 |
is_iterable() | 可迭代 (array 或 Traversable) | PHP 7.1+ |
is_countable() | 可用 count() 計數 | PHP 7.3+ |
is_numeric('123abc') → false,但 is_numeric(' 123 ') → true (自動修剪空白);is_numeric('0xFF') → true (十六進位)。嚴格驗證整數請用 ctype_digit() 或 filter_var($v, FILTER_VALIDATE_INT)。gettype($x) === 'integer' 比 is_int($x) 慢且易打錯字,優先用 is_* 系列。isset($undef) → false,is_null($undef) 觸發 Notice,請搭配 isset() 或 array_key_exists()。is_resource($fp) 為 true,但 gettype($fp) 回傳 'resource' (PHP 8.0+ 為 'resource (stream)'),不可直接比對字串。function sum(int ...$nums): int { // 參數型別、回傳型別
return array_sum($nums);
}
// 搭配 declare(strict_types=1) 強制模式
// 靜態分析工具:PHPStan, Psalm, Phan 可在開發期發現型別錯誤
gettype($var) (除錯/日誌用)。is_XXX($var) (效能最好、語意最清晰)。filter_var($input, FILTER_VALIDATE_INT/FLOAT)。is_callable($cb)。熟練運用類型判斷函數,並逐步引入強型別宣告與靜態分析,能大幅降低 PHP 專案的執行期錯誤率。