萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 變數資料類型判斷函數完全指南:gettype、is_* 系列、類型檢測最佳實踐

PHP 是弱型別語言,變數類型可隱性轉換,精確判斷類型是撰寫健壯程式的關鍵。本文系統整理 gettype()、is_* 系列函數,並說明常見誤區與最佳實踐。

1. 取得類型字串:gettype()

$type = gettype($var); // 回傳 'boolean', 'integer', 'double', 'string', 'array', 'object', 'resource', 'NULL', 'unknown type'
  • 回傳值為小寫英文字串,非類型常數。
  • 資源型別回傳 'resource',PHP 7.1+ 已棄用 'resource' 字串改回 'resource' (同舊),但建議改用 is_resource()。

2. 布林判斷系列:is_* 函數 (回傳 true/false)

函數判斷目標備註
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+

3. 常見誤區與避坑指南

  • is_numeric() 陷阱:is_numeric('123abc') → false,但 is_numeric(' 123 ') → true (自動修剪空白);is_numeric('0xFF') → true (十六進位)。嚴格驗證整數請用 ctype_digit() 或 filter_var($v, FILTER_VALIDATE_INT)。
  • gettype() vs === 比較:gettype($x) === 'integer' 比 is_int($x) 慢且易打錯字,優先用 is_* 系列。
  • NULL vs 未定義:isset($undef) → false,is_null($undef) 觸發 Notice,請搭配 isset() 或 array_key_exists()。
  • 資源類型:is_resource($fp) 為 true,但 gettype($fp) 回傳 'resource' (PHP 8.0+ 為 'resource (stream)'),不可直接比對字串。

4. 現代 PHP 型別宣告與靜態分析 (PHP 7.0+)

function sum(int ...$nums): int {  // 參數型別、回傳型別
    return array_sum($nums);
}
// 搭配 declare(strict_types=1) 強制模式
// 靜態分析工具:PHPStan, Psalm, Phan 可在開發期發現型別錯誤

5. 快速決策樹

  1. 需要知道確切類型字串?→ gettype($var) (除錯/日誌用)。
  2. 只要判斷「是否為某類型」?→ is_XXX($var) (效能最好、語意最清晰)。
  3. 需驗證使用者輸入為數字?→ filter_var($input, FILTER_VALIDATE_INT/FLOAT)。
  4. 需檢查可呼叫?→ is_callable($cb)。
  5. 撰寫新程式碼?→ 加上型別宣告 + strict_types + 靜態分析,減少執行期判斷需求。

熟練運用類型判斷函數,並逐步引入強型別宣告與靜態分析,能大幅降低 PHP 專案的執行期錯誤率。

copyright © 萬盛學電腦網 all rights reserved