PHP 判斷常數、變數、函式是否存在完整速查表

三大檢測函式對照表

基本用法範例

<?php
// 1. 常數
if (defined('MY_CONSTANT')) {
    echo MY_CONSTANT;
}

// 2. 變數
if (isset($myVar)) {
    echo "變數存在: $myVar";
}
// 多變數同時檢測
if (isset($a, $b, $c)) { /* 全部存在 */ }

// 3. 函式
if (function_exists('imap_open')) {
    imap_open(...);
} else {
    echo "imap 擴充未安裝";
}
?>

進階檢測函式

filter_has_var() — 檢測特定輸入來源變數

<?php
// 來源常數：INPUT_GET, INPUT_POST, INPUT_COOKIE, INPUT_SERVER, INPUT_ENV
if (filter_has_var(INPUT_GET, 'id')) {
    $id = filter_input(INPUT_GET, 'id', FILTER_VALIDATE_INT);
}
?>

優點：同時驗證來源與過濾，比 isset($_GET['id']) 更安全。

property_exists() / method_exists() — 類別成員檢測

<?php
class User {
    public $name;
    protected $email;
    public function getName() {}
}

$obj = new User();
var_dump(property_exists($obj, 'name'));   // true
var_dump(property_exists($obj, 'email'));  // true (不受 visibility 影響)
var_dump(method_exists($obj, 'getName'));  // true
var_dump(method_exists('User', 'getName')); // true (類別名也可)
?>

class_exists() / interface_exists() / trait_exists()

<?php
if (class_exists('PDO')) {
    $db = new PDO($dsn);
}
// 第三參數 $autoload = true (預設) 會觸發自動載入
// 僅檢測已載入類別：class_exists('MyClass', false)
?>

extension_loaded() — 擴充模組檢測

<?php
if (extension_loaded('gd')) {
    // 使用 GD 函式
}
?>

常見陷阱與最佳實踐

實務封裝：安全取得設定值

<?php
function getConfig($key, $default = null) {
    // 1. 環境變數
    if (($val = getenv($key)) !== false) return $val;
    // 2. 常數
    if (defined($key)) return constant($key);
    // 3. $_SERVER / $_ENV
    if (isset($_SERVER[$key])) return $_SERVER[$key];
    if (isset($_ENV[$key])) return $_ENV[$key];
    return $default;
}

// 使用
$dbHost = getConfig('DB_HOST', 'localhost');
?>

除錯技巧：列出所有已定義常數/函式/類別

<?php
// 常數
print_r(get_defined_constants(true)['user'] ?? []); // 僅使用者定義

// 函式
$funcs = get_defined_functions();
print_r($funcs['user']); // 使用者定義函式

// 類別
print_r(get_declared_classes());
?>

總結

• 常數：defined('NAME') — 必須加引號。
• 變數：isset($var) 存在且非 null；empty($var) 為空值 (0, '', null, false, [])。
• 函式：function_exists('name') — 必須加引號。
• 類別/介面/特徵：class_exists(), interface_exists(), trait_exists()。
• 輸入變數：filter_has_var(INPUT_TYPE, 'name') 搭配 filter_input() 更安全。
• 擴充模組：extension_loaded('name')。

掌握這組檢測函式，即可撰寫健壯的相容性判斷、優雅降級、條件載入邏輯。