瀏覽器訪問 PHP 頁面,完全空白,無任何輸出,查看頁面源碼也為空。這通常意味著 PHP 引擎遇到致命錯誤並終止執行,且錯誤顯示被關閉。
在腳本**最頂部** (
<?php
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL); // PHP 8.0+ 可用 E_ALL | E_STRICT
?>
或修改 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,僅記錄日志!
/var/log/apache2/error.log 或 /var/log/httpd/error_log/var/log/nginx/error.log (FastCGI 錯誤常在這裡)/usr/local/php/var/log/php-fpm.log 或配置的 error_log 路徑搜索關鍵字:PHP Fatal error、PHP Parse error、500 Internal Server Error。
| 類型 | 典型原因 | 示例 | 解決 |
|---|---|---|---|
| 語法錯誤 | 漏分號、括號不匹配、關鍵字拼寫錯誤 | $a = 1 // 缺分號 | IDE 實時檢查、php -l file.php 語法檢查 |
| 致命錯誤 | 調用未定義函數/類、內存耗盡、執行超時、require 失敗 | Call to undefined function foo() | 檢查拼寫、引入文件、擴展安裝、調大 memory_limit/max_execution_time |
| 邏輯錯誤導致無輸出 | 條件分支全不滿足、循環不進入、輸出被緩存未刷新 | if($x>10) echo 'hi'; // $x=5 | 添加默認輸出、ob_end_flush()、Xdebug 斷點調試 |
| Header 已發送 | 輸出內容前發送 Header (重定向、Session、Cookie) | <?php echo ' '; header('Location:...'); | 確保 Header 前無任何輸出 (含 BOM、空白)、使用輸出緩存 ob_start() |
| 濫用錯誤抑制符 @ | @include('missing.php') 隱藏致命錯誤 | 包含文件有語法錯誤但被 @ 抑制 | 移除 @,修復底層錯誤;生產環境用自定義錯誤處理器 |
header()、session_start() 失效並輸出空白。audit.log 或暫時設為 Permissive 模式測試。dmesg | grep -i php 或 journalctl -u php-fpm,看是否有 Segfault (段錯誤)。<?php
ob_start(); // 腳本開頭開啟緩存
// ... 業務邏輯 ...
ob_end_flush(); // 結束時刷新輸出
?>
某些框架/服務器配置默認開啟輸出緩存,若腳本中途 exit/die 未刷新緩存,導致白屏。
dump($var) 替代 var_dump,美觀、可折疊、不中斷執行。php -l file.php (語法檢查)、php file.php (直接運行 CLI 模式)。php -l 語法檢查display_errors = Off, log_errors = Onopcache.validate_timestamps=0 等)白屏本質是「錯誤被吞沒」。建立「開啟報告 → 看日志 → 定位行 → 修復代碼 → 驗證 → 完善預防」的肌肉記憶,配合現代調試工具,能將排查時間從小時級壓縮到分鐘級。