萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 空白頁面除錯指南:錯誤顯示設定與排查技巧

為什麼會出現空白頁?

PHP 遇到**致命錯誤** (Fatal Error、Parse Error) 時,若**錯誤顯示關閉**,會直接輸出空內容 (HTTP 200/500 但 Body 為空)。這是生產環境預設行為 (安全),開發環境必須開啟顯示。

方法一:修改 `php.ini` (全局、永久)

; 開發環境
display_errors = On
display_startup_errors = On
error_reporting = E_ALL
log_errors = On
error_log = /var/log/php_errors.log

; 生產環境
display_errors = Off
display_startup_errors = Off
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT
log_errors = On
error_log = /var/log/php_errors.log

修改後必須重啟 PHP-FPM / Apache。

方法二:運行時設置 (當前腳本、臨時)

<?php
// 放在文件**最頂部**,任何輸出之前
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
error_reporting(E_ALL);
// 或者
error_reporting(-1); // 所有錯誤
?>

注意:`parse error` (語法錯誤) 發生在編譯階段,`ini_set` 不會生效,**必須改 `php.ini`**。

方法三:Web 服務器配置 (Apache/Nginx)

Apache (.htaccess / httpd.conf)

php_flag display_errors on
php_value error_reporting 32767

Nginx + PHP-FPM (fastcgi_param)

# nginx.conf location ~ \.php$ {
    fastcgi_param PHP_VALUE "display_errors=1\nerror_reporting=-1";
# }

方法四:代碼級排查大法 (無權限改配置時)

**「Echo 大法」/ 二分法定位**:在關鍵節點輸出標記,縮小錯誤範圍。

<?php
echo "Checkpoint 1: Script start\n"; // 或 error_log()

$action = $_GET['id'] ?? '';
echo "Checkpoint 2: Got id=$action\n";

if ($action === '') {
    $action = 1;
    echo "Checkpoint 3: Set default action=1\n";
}

if ($action == 1) {
    echo "Checkpoint 4: Enter action 1 branch\n";
    // 疑似問題代碼區塊
    require 'some_file.php'; // 可能這裡語法錯誤/致命錯誤
    echo "Checkpoint 5: After require\n";
} elseif ($action == 2) {
    echo "Checkpoint 4b: Enter action 2 branch\n";
}

echo "Checkpoint 6: Script end\n";
?>

瀏覽器查看輸出,**最後一條 Checkpoint 之後的代碼即為問題區**。

進階除錯工具

  1. Xdebug + IDE (PhpStorm/VS Code):斷點、單步執行、變量檢查、堆疊追蹤、**最強利器**。
  2. 錯誤日誌:`tail -f /var/log/php_errors.log` 實時查看。
  3. Whoops / Filp/Whoops:漂亮的錯誤頁面 (開發環境 `composer require filp/whoops`)。
  4. VarDumper (Symfony/Laravel):`dump($var)` 替代 `var_dump`,格式化、可摺疊。

常見導致空白頁的錯誤類型

  • 語法錯誤:缺少分號、括號不匹配、關鍵字拼寫錯誤。
  • 致命錯誤:調用未定義函數/類、內存耗盡 (`memory_limit`)、執行超時 (`max_execution_time`)、`require` 失敗 (文件不存在)。
  • 輸出緩衝問題:`ob_start()` 後未 `ob_end_flush()`,或 headers already sent 導致 `header()`/`session_start()` 失敗 (通常有警告,但若關閉顯示則空白)。
  • 編碼問題:文件含 BOM (UTF-8 with BOM) 導致 `header()` 失敗。

生產環境應急查看錯誤

<?php
// 僅允許特定 IP 臨時開啟顯示 (極度謹慎,事後立即移除)
$allowedIPs = ['1.2.3.4', '127.0.0.1'];
if (in_array($_SERVER['REMOTE_ADDR'], $allowedIPs)) {
    ini_set('display_errors', '1');
    error_reporting(E_ALL);
}
?>
copyright © 萬盛學電腦網 all rights reserved