如何優雅處理PHP 函數參數類型錯誤

M66 2025-08-07

PHP 函數參數類型錯誤的優雅處理方式

在日常PHP 開發中，函數參數類型的正確處理是編寫健壯代碼的基礎。合理使用強制類型、類型檢查和默認值機制，不僅能有效預防運行時錯誤，還能提升代碼的可維護性和可讀性。

強制參數類型

自PHP 7 以來，開發者就可以通過類型聲明指定函數參數的類型。而在PHP 8 及更高版本中，這一特性更加完善。它確保傳入函數的參數類型與預期一致，否則會拋出TypeError異常。

 
// 定義帶有強制類型參數的函數
function addNumbers(int $num1, int $num2)
{
    return $num1 + $num2;
}

// 使用強制類型參數調用函數
$result = addNumbers(1, 2);          // 正確
$result = addNumbers("1", "2");    // 拋出 TypeError 異常

類型檢查

如果不希望函數強制類型，也可以在函數體內部手動檢查參數類型。這種方式提供了更大的靈活性，適用於類型多變的應用場景。

 
// 定義具有類型檢查的函數
function addNumbers($num1, $num2)
{
    if (!is_int($num1) || !is_int($num2)) {
        throw new TypeError("參數類型不匹配");
    }

    return $num1 + $num2;
}

// 使用類型檢查調用函數
$result = addNumbers(1, 2);           // 正確
$result = addNumbers("1", "2");     // 拋出 TypeError 異常

默認值機制

默認參數值在函數設計中非常常見。當未提供參數時，函數會自動使用默認值，避免了調用時出錯。

 
// 定義具有默認參數的函數
function addNumbers($num1, $num2 = 10)
{
    return $num1 + $num2;
}

// 設置默認值調用函數
$result = addNumbers(1);      // 返回 11

實際應用場景

表單驗證

在表單驗證中，處理參數類型至關重要，能有效阻止非法數據被處理或存儲。

 
// 驗證表單輸入
function validateForm(array $data)
{
    // 檢查變量類型並採取相應措施...
}

數據庫查詢

在構建數據庫查詢邏輯時，通過類型約束，可以降低SQL 注入等安全風險。

 
// 執行 SQL 查詢
function executeQuery(string $query, array $params = [])
{
    // 验证参数类型并執行查詢...
}

總結

合理處理PHP 函數的參數類型，不僅能提升代碼健壯性，還能避免潛在的邏輯錯誤與安全風險。無論是採用強制類型聲明、類型檢查，還是結合默認值使用，都是提升代碼質量的有效手段。