萬盛學電腦網

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

PHP 判斷變數型別完整指南:gettype()、is_* 系列與最佳實務

核心函式:gettype()

<?php
$vars = [
    'string' => 'hello',
    'int' => 42,
    'float' => 3.14,
    'bool' => true,
    'array' => [1,2,3],
    'object' => new stdClass(),
    'null' => null,
    'resource' => fopen('php://memory', 'r'),
];

foreach ($vars as $name => $value) {
    echo "$name: " . gettype($value) . "\n";
}
/*
string: string
int: integer
float: double
bool: boolean
array: array
object: object
null: NULL
resource: resource
*/
?>

官方建議:改用 is_* 系列函式

gettype() 回傳字串需比對,效能較差且未來可能變更。官方建議使用型別檢查函式:

函式檢查型別備註
is_int() / is_integer() / is_long()整數
is_float() / is_double() / is_real()浮點數
is_bool()布林值
is_string()字串
is_array()陣列
is_object()物件
is_null()null
is_resource()資源
is_scalar()純量 (int/float/string/bool)
is_callable()可呼叫函式、閉包、實作 __invoke 的物件
is_iterable()可迭代陣列、Traversable 物件 (PHP 7.1+)
is_countable()可計數陣列、Countable 物件 (PHP 7.3+)
is_numeric()數值或數值字串'123', '1.23', -5 皆 true

封裝通用型別檢測函式

<?php
function getType(mixed $var): string {
    if (is_null($var)) return 'null';
    if (is_bool($var)) return 'boolean';
    if (is_int($var)) return 'integer';
    if (is_float($var)) return 'float';
    if (is_string($var)) return 'string';
    if (is_array($var)) return 'array';
    if (is_object($var)) return get_class($var); // 回傳類別名
    if (is_resource($var)) return 'resource (' . get_resource_type($var) . ')';
    return 'unknown';
}

// 測試
var_dump(getType(42));           // integer
var_dump(getType('hello'));      // string
var_dump(getType(new DateTime())); // DateTime
?>

型別判斷陷阱

1. 數值字串

2. 浮點數精度

3. 布林轉換

4. 物件 vs 陣列

 1];
is_array($obj);    // false
is_object($obj);   // true
is_iterable($obj); // true (可 foreach)
is_countable($obj); // true (可 count)

PHP 8.0+ 型別系統增強

union types / mixed

 "整數: $value",
        is_float($value) => "浮點數: $value",
        is_string($value) => "字串: $value",
    };
}

typeof 操作符 (非標準,但常見模式)

實務應用場景

API 參數驗證

 $rule) {
        $value = $input[$field] ?? null;
        
        if (str_starts_with($rule, 'required')) {
            if ($value === null || $value === '') {
                $errors[$field] = '此欄位為必填';
                continue;
            }
        }
        
        if (str_contains($rule, 'int') && !is_int($value)) {
            $errors[$field] = '必須為整數';
        }
        // ... 其他型別規則
    }
    return $errors;
}

除錯輸出變數結構

";
    var_dump($var); // 內建最完整
    // 或使用 symfony/var-dumper: dump($var);
    echo "
"; }

總結建議

  1. 型別檢查優先用 is_* 系列:語意明確、效能佳、IDE 可靜態分析
  2. 除錯/日誌用 get_debug_type() (PHP 8.0+) 或 gettype()
  3. 嚴格模式宣告:declare(strict_types=1); 讓型別宣告生效
  4. 善用 PHPStan/Psalm 靜態分析:編譯期發現型別錯誤
  5. 避免過度動態型別判斷:多態、介面、抽象類別才是正道
copyright © 萬盛學電腦網 all rights reserved