@ 是 PHP 的錯誤抑制運算子,許多初學者視為「忽略錯誤的萬能鑰匙」。實則不然,濫用 @ 會掩蓋真實問題、嚴重拖慢效能、增加除錯難度。本文深入剖析其運作機制、效能代價、適用場景與現代替代方案。
當 PHP 解析器遇到 @expression 時:
error_reporting 設為 0expressionerror_reporting 值error_get_last() 仍可取得最後錯誤資訊<?php
// 抑制單行表達式錯誤
$value = @$arr['missing_key']; // Notice: Undefined array key
$fp = @fopen('not_exist.txt', 'r'); // Warning: fopen failed
$result = @($a / $b); // Warning: Division by zero
// 抑制函數呼叫錯誤
$json = @json_decode($invalidJson); // Warning: JSON decode error
// 注意:@ 僅影響「當前表達式」,不影響後續程式碼
@$x = 1/0; // 不報錯
echo "繼續執行"; // 正常輸出
?>
<?php
// 效能測試
$iterations = 100000;
$start = microtime(true);
for ($i = 0; $i < $iterations; $i++) {
@$x = @$undefinedVar; // 抑制 Notice
}
$timeWithAt = microtime(true) - $start;
$start = microtime(true);
for ($i = 0; $ < $iterations; $i++) {
$x = $undefinedVar ?? null; // Null 合併運算子
}
$timeNullCoalesce = microtime(true) - $start;
echo "@ 運算子耗時: {$timeWithAt}s\n";
echo "?? 運算子耗時: {$timeNullCoalesce}s\n";
// 典型結果:@ 比 ?? 慢 3-10 倍
?>
原因:@ 會在執行時動態修改 error_reporting,涉及內部狀態切換開銷極大。在循環、高頻呼叫中會明顯拖慢效能。
錯誤。@ 無法抑制:
<?php
@undefined_function(); // Fatal Error: Uncaught Error: Call to undefined function
// 依然會終止腳本並顯示錯誤(視 error_reporting 設定)
?>
錯誤。若註冊了 set_error_handler(),@ 抑制的錯誤仍會傳遞給自訂處理器,但處理器內可透過 error_reporting() === 0 判斷是否被抑制並選擇忽略。
錯誤。@ 僅能用於表達式,不能用於:
@function foo() {} (Parse Error)@if ($x) {} (Parse Error)foreach、try-catch 等<?php
// 取代 @$_GET['page']
$page = $_GET['page'] ?? 1;
// 巢狀陣列安全存取
$city = $data['user']['address']['city'] ?? 'Unknown';
?>
<?php
// 檢查陣列鍵是否存在
if (isset($arr['key'])) { ... }
if (array_key_exists('key', $arr)) { ... } // 包含 null 值的鍵
// 檢查變數是否設定且非空
if (!empty($var)) { ... }
?>
<?php
// 針對可能拋出例外的操作
try {
$pdo = new PDO($dsn, $user, $pass, [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]);
} catch (PDOException $e) {
logError($e->getMessage());
showFriendlyError('資料庫連線失敗');
}
?>
<?php
// fopen 失敗回傳 false
$fp = fopen('data.txt', 'r');
if ($fp === false) {
// 記錄錯誤、顯示友善訊息、嘗試備援方案
error_log("無法開啟 data.txt: " . error_get_last()['message']);
die('系統暫時無法讀取資料,請稍後再試');
}
// 正常處理...
fclose($fp);
?>
<?php
set_error_handler(function($severity, $message, $file, $line) {
if (error_reporting() === 0) {
return false; // 被 @ 抑制,交給 PHP 內部處理(不顯示)
}
// 記錄至 Log、發送告警、顯示友善頁面
error_log("[$severity] $message in $file:$line");
if ($severity & (E_ERROR | E_USER_ERROR)) {
exit(1);
}
return true; // 不執行 PHP 內建處理
});
?>
@include / @require:載入可能不存在的可選設定檔(如 @include __DIR__ . '/local_config.php')@mkdir($dir, 0755, true) 忽略「目錄已存在」Warning)@ 是雙面刃:能暫時隱藏錯誤,卻無法解決問題,反而埋下維護地雷。現代 PHP(7.0+)提供了 ??、??=、型別宣告、嚴格模式、例外處理等更優雅、高效、安全的工具。原則:預設不使用 @,遇到錯誤先思考「為何會錯」並從根源修正,而非掩蓋。