結合property_exists 和get_class 判斷對象屬性的類型

在PHP 中，我們經常需要對對象的屬性進行類型檢查，以確保在運行時訪問或操作屬性時不會出現類型錯誤。雖然PHP 是一種動態語言，但在面對複雜對像或接口交互時，精準地判斷屬性是否存在及其類型，仍然是保證代碼健壯性的重要手段。

本文將介紹如何結合使用property_exists()與get_class()函數，準確判斷對象屬性的存在性與具體類型。

一、背景場景

假設你在開發一個依賴於多態對象結構的業務系統，不同類型的對象可能具有相同名稱但不同類型的屬性。例如：

 class User {
    public Profile $profile;
}

class Admin {
    public AdminProfile $profile;
}

class Guest {
    // 沒有 profile 屬性
}

你希望能傳入任何對象，並且在不破壞類型安全的前提下判斷它是否有profile屬性，以及該屬性的具體類名。

二、使用property_exists()檢查屬性存在性

property_exists()是PHP 內置函數，它允許我們檢測某個屬性是否存在於某個對像或類中。語法如下：

 bool property_exists(object|string $object_or_class, string $property)

示例：

 if (property_exists($object, 'profile')) {
    // 說明對像中定義了 profile 屬性
}

但注意，它不會判斷屬性是否已初始化，僅判斷其是否被聲明。

三、結合get_class()判斷屬性的具體類型

一旦確認對象具有該屬性，我們就可以嘗試獲取其值，並使用get_class()判斷該值的具體類型。

 if (property_exists($object, 'profile')) {
    $profileValue = $object->profile;
    if (is_object($profileValue)) {
        $profileClass = get_class($profileValue);
        echo "屬性 profile 的類型為: $profileClass";
    } else {
        echo "屬性 profile 存在，但不是對象。";
    }
}

四、完整封裝：一個實用的檢測函數

下面是一個實用函數，它接受任意對象，嘗試判斷是否具有指定屬性並輸出屬性的類名：

 function getObjectPropertyClass(object $object, string $property): ?string {
    if (property_exists($object, $property)) {
        $value = $object->$property ?? null;
        if (is_object($value)) {
            return get_class($value);
        }
    }
    return null;
}

使用示例：

 $user = new User();
$user->profile = new Profile();

$className = getObjectPropertyClass($user, 'profile');

if ($className) {
    echo "profile 的類名是：$className";
} else {
    echo "该屬性不存在或不是对象。";
}

五、針對未初始化屬性的處理

在PHP 7.4+ 中，如果屬性是類型化的且未賦值，直接訪問它會拋出錯誤。你可以使用ReflectionProperty來優雅地判斷屬性是否已初始化。

 function isPropertyInitialized(object $object, string $property): bool {
    try {
        $ref = new ReflectionProperty($object, $property);
        return $ref->isInitialized($object);
    } catch (ReflectionException $e) {
        return false;
    }
}

結合使用：

 if (property_exists($object, 'profile') && isPropertyInitialized($object, 'profile')) {
    $profile = $object->profile;
    if (is_object($profile)) {
        echo "類型是：" . get_class($profile);
    }
}

六、實際應用場景舉例

比如你在處理一個從遠程API（例如https://api.gitbox.net/users/123 ）返回的數據對象時，可以使用上述方法動態判斷是否包含如profile 、 settings等屬性，並進一步處理。

這種方式非常適合用於反序列化或處理非標準化對象結構的數據接口。

七、結語

結合使用property_exists()和get_class() ，再配合ReflectionProperty的高級用法，可以讓我們在PHP 中更安全、準確地判斷對象屬性的存在性及其具體類型。這種方法尤其適用於數據驅動設計、接口響應處理或反射相關的編程場景。對於提升代碼的健壯性和可維護性，具有非常實際的價值。