PHP @ 抑制錯誤運算子：用法、陷阱與最佳實踐

PHP 中 @ 運算子可抑制單一運算式的錯誤訊息（Notice、Warning），但濫用會隱藏真實問題，增加除錯難度。本文說明正確用法與替代方案。

基本語法

$file = @file_get_contents('may_not_exist.txt'); // 抑制檔案不存在的 Warning
$value = @$array['missing_key']; // 抑制 Undefined array key Notice

適用場景

• 預期可能失敗且可忽略：如讀取快取檔案、嘗試連接非必要服務。
• 自行處理錯誤：搭配 error_get_last() 捕捉被抑制的錯誤。

$content = @file_get_contents($cacheFile);
if ($content === false) {
    $error = error_get_last();
    // 記錄日誌、嘗試備用方案
    $content = generateContent();
}

嚴重副作用

1. 效能損耗：PHP 內部需暫時修改錯誤報告層級、執行運算式、恢復層級，頻繁使用明顯降低效能。
2. 隱藏致命錯誤：@ 無法抑制 Fatal Error、Parse Error，但會掩蓋前兆 Warning，導致問題爆發時難以追蹤。
3. 自訂錯誤處理器失效：若註冊 set_error_handler()，@ 會導致處理器不被呼叫，破壞統一錯誤處理機制。

現代替代方案

1. 空合併運算子 ??（PHP 7+）

$value = $array['key'] ?? 'default'; // 替代 @$array['key']

2. isset() / array_key_exists() 預檢

if (isset($array['key'])) { $value = $array['key']; }

3. try-catch 捕捉例外（PHP 7+ 可捕捉 Error）

try {
    $content = file_get_contents($file);
} catch (Throwable $e) {
    // 統一處理
}

4. 設定錯誤報告層級

// 開發環境
error_reporting(E_ALL);
ini_set('display_errors', '1');
// 生產環境
error_reporting(E_ALL & ~E_NOTICE & ~E_DEPRECATED & ~E_STRICT);
ini_set('display_errors', '0');
ini_set('log_errors', '1');
ini_set('error_log', '/var/log/php/error.log');

結論

@ 屬於「應急工具」，非「標準作法」。現代 PHP 開發應善用 ??、isset()、例外處理、錯誤日誌，建立可觀測、可維護的錯誤處理體系。