PHP instanceof 運算子完整解析：類別、繼承與介面檢查實戰

前言

instanceof 是 PHP 5 引入的類型運算子，用於檢查物件是否為特定類別的實例、子類別實例，或實作特定介面的實例。取代了舊版的 is_a() 函數，語法更直觀、效能更佳。

三大核心用途

1. 檢查物件是否為某類別實例

class User {}
$user = new User();
var_dump($user instanceof User); // true

2. 檢查繼承關係（父類別/介面）

interface Loggable {}
class BaseModel implements Loggable {}
class User extends BaseModel {}

$user = new User();
var_dump($user instanceof BaseModel); // true（父類別）
var_dump($user instanceof Loggable);  // true（介面）

3. 搭配動態類別名稱避免致命錯誤

PHP 5.1.0 前，若檢查的類別不存在會觸發 __autoload() 甚至致命錯誤。解法：使用字串變數或動態類別引用。

$className = 'NotMyClass';
var_dump($user instanceof $className); // false，不會報錯

常見陷阱與注意事項

非物件變數直接回傳 false

$str = 'hello';
var_dump($str instanceof User); // false，不會報錯

null 值處理

$obj = null;
var_dump($obj instanceof User); // false

命名空間影響

namespace App\Models;
class User {}

$user = new User();
// 在同命名空間下
var_dump($user instanceof User);        // true
var_dump($user instanceof \App\Models\User); // true

// 在其他命名空間需完整路徑
var_dump($user instanceof \User); // false（指向全域 \User）

instanceof vs is_a()

實戰應用場景

表單驗證器中的型別檢查

function validateInput($input) {
    if ($input instanceof \DateTime) {
        return $input->format('Y-m-d');
    }
    if ($input instanceof \Traversable) {
        return iterator_to_array($input);
    }
    return (string)$input;
}

依賴注入容器的服務解析

if ($service instanceof \Psr\Container\ContainerInterface) {
    return $service->get($id);
}

小結

• instanceof 是現代 PHP 型別檢查的標準工具
• 支援類別、父類別、介面三層檢查
• 搭配字串變數可安全處理動態類別名稱
• 完全取代 is_a()，建議所有專案統一使用