网站运行过程中出现白屏、报错、功能异常时，最直接的排查方式就是查看日志。日志记录了程序执行时的每一步信息，包括错误原因、请求参数、执行时间等。很多网站问题无法直接复现，但日志里会留下完整线索。本教程将详细讲解如何为常见网站程序（PHP 类程序如 WordPress、ThinkPHP、Laravel，以及前端 Nginx 服务器）开启日志记录，并告诉你日志文件在哪里、如何读取。 ### 前言介绍 日志记录是网站调试和运维的基础。没有日志，当网站出现 500 错误、接口超时、数据库连接失败时，你只能靠猜。开启日志后，程序会在指定文件里写下错误发生的时间、文件路径、行号以及具体错误描述。本教程覆盖三种最主流的环境：Apache/Nginx 服务器日志、PHP 程序自身错误日志、以及常见框架（ThinkPHP、Laravel、WordPress）的日志配置。无论你是用虚拟主机还是云服务器，都能找到对应方法。 ### 前置准备 1. **服务器访问权限**：你需要能登录服务器（SSH 或远程桌面），或者能通过主机控制面板（如 cPanel、宝塔面板）修改文件。 2. **文件编辑工具**：推荐使用 Notepad++、VS Code 或服务器自带的 vi/vim 编辑器。不要用记事本编辑 Linux 配置文件，否则可能导致格式错误。 3. **网站根目录路径**：确认你的网站程序放在哪个文件夹，例如 `/var/www/html` 或 `D:\wwwroot`。 4. **备份原始配置**：在修改任何配置文件前，先复制一份备份，例如把 `php.ini` 复制为 `php.ini.bak`。 5. **日志查看工具**：Windows 用 Notepad++ 或自带记事本，Linux 用 `tail -f` 命令实时查看日志。 ### 分步操作步骤 #### 1. 开启 PHP 程序自身错误日志（最通用，适用于所有 PHP 网站） PHP 的错误日志是独立于服务器日志的，专门记录 PHP 代码执行时的错误（如语法错误、未定义变量、数据库查询失败）。无论你用什么框架，这一步都能生效。 - **找到 PHP 配置文件**： - Linux 服务器：通常位于 `/etc/php.ini` 或 `/etc/php/7.4/cli/php.ini`（版本号可能不同）。如果你用宝塔面板，可以在面板左侧“软件商店”->“PHP 设置”->“配置文件”中直接编辑。 - Windows 服务器：位于 PHP 安装目录下，例如 `C:\php\php.ini`。 - 虚拟主机用户：无法直接修改 php.ini，可以在网站根目录下新建一个 `.user.ini` 文件（如果支持），或者通过 .htaccess 文件配置（见下文）。 - **修改关键参数**： 打开 php.ini 文件，搜索以下三个参数，并修改为如下值： ``` display_errors = Off log_errors = On error_log = /var/log/php_errors.log ``` - **display_errors Off**：关闭在网页上直接显示错误。生产环境必须关闭，否则可能暴露数据库密码等敏感信息。 - **log_errors On**：开启错误日志记录。 - **error_log**：指定日志文件的绝对路径。Linux 建议放在 `/var/log/` 下，Windows 建议放在 `C:\logs\` 下。路径必须存在且 PHP 有写入权限。 - **设置日志文件权限**（Linux 服务器）： 创建日志文件并赋予写入权限： ```bash sudo touch /var/log/php_errors.log sudo chmod 644 /var/log/php_errors.log sudo chown www-data:www-data /var/log/php_errors.log ``` `www-data` 是常见 Web 用户，具体用户取决于你的服务器配置（也可能是 `nobody` 或 `apache`）。如果不确定，可以执行 `ps aux | grep nginx` 或 `ps aux | grep apache` 查看运行用户。 - **重启 PHP 服务**： - 宝塔面板：在软件商店里重启 PHP。 - 命令行：`sudo systemctl restart php7.4-fpm`（版本号根据实际修改）。 - Windows：在 IIS 管理器中重启 PHP 或重启整个网站池。 - **验证日志是否生效**： 在网站根目录创建一个测试文件 `test_log.php`，写入以下代码： ```php ``` 访问 `http://你的域名/test_log.php`，页面应该空白（因为 display_errors 已关闭）。然后查看 `/var/log/php_errors.log` 文件，如果看到类似 `PHP Notice: Undefined variable` 的记录，说明配置成功。记得删除测试文件。 #### 2. 为 Nginx 服务器开启访问日志和错误日志（适用于 Nginx 用户） Nginx 日志记录的是 HTTP 层面的信息，包括谁访问了哪个 URL、返回了什么状态码（200、404、500）、请求耗时等。当网站出现 502 Bad Gateway 或 404 时，查 Nginx 错误日志最直接。 - **编辑 Nginx 主配置文件**： 宝塔面板用户：左侧“软件商店”->“Nginx”->“设置”->“配置修改”。 手动安装用户：`sudo vi /etc/nginx/nginx.conf`。 - **在 http 块中配置日志格式和路径**： 找到 `http { ... }` 块，在内部添加或修改以下内容： ```nginx http { # 定义日志格式（main 是格式名称，可自定义） log_format main '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" "$http_x_forwarded_for"'; # 指定访问日志路径和使用的格式 access_log /var/log/nginx/access.log main; # 指定错误日志路径和记录级别（debug, info, notice, warn, error, crit） error_log /var/log/nginx/error.log warn; } ``` - `access_log`：记录所有正常请求。如果磁盘空间紧张，可以设置 `off` 关闭。 - `error_log`：记录错误信息。`warn` 级别会记录警告及以上错误，生产环境建议使用 `error` 级别减少日志量。 - **为特定站点单独配置日志**（推荐）： 在 `server` 块中覆盖全局设置，避免所有站点的日志混在一起： ```nginx server { listen 80; server_name example.com; # 单独指定该站点的日志文件 access_log /var/log/nginx/example_access.log main; error_log /var/log/nginx/example_error.log error; # 其他配置... } ``` - **创建日志目录并赋予权限**： ```bash sudo mkdir -p /var/log/nginx sudo chmod 755 /var/log/nginx sudo chown -R www-data:www-data /var/log/nginx ``` - **测试配置并重启 Nginx**： ```bash sudo nginx -t # 测试配置文件语法 sudo systemctl restart nginx # 重启 Nginx ``` - **实时查看日志**： ```bash # 实时查看访问日志 tail -f /var/log/nginx/example_access.log # 实时查看错误日志 tail -f /var/log/nginx/example_error.log ``` #### 3. 为 Apache 服务器开启日志（适用于 Apache 用户） Apache 的日志配置与 Nginx 类似，但语法不同。 - **编辑 Apache 配置文件**： 宝塔用户：软件商店->Apache->设置->配置修改。 手动安装用户：`sudo vi /etc/httpd/conf/httpd.conf` 或 `/etc/apache2/apache2.conf`。 - **开启日志模块并配置**： 确保以下模块已启用（取消注释）： ```apache LoadModule log_config_module modules/mod_log_config.so ``` 在 `` 或全局配置中添加： ```apache # 定义日志格式 LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined LogFormat "%h %l %u %t \"%r\" %>s %b" common # 指定访问日志 CustomLog "/var/log/httpd/access_log" combined # 指定错误日志 ErrorLog "/var/log/httpd/error_log" # 错误日志级别：debug, info, notice, warn, error, crit LogLevel warn ``` - **重启 Apache**： ```bash sudo systemctl restart httpd # CentOS sudo systemctl restart apache2 # Ubuntu/Debian ``` #### 4. 为常用 PHP 框架开启专属日志（ThinkPHP、Laravel、WordPress） 框架通常有自己的日志系统，配置更精细，建议优先使用框架日志，因为它会记录 SQL 语句、请求参数等更详细的信息。 - **ThinkPHP 6/8 开启日志**： 打开 `config/log.php` 文件，修改如下： ```php return [ // 默认日志通道 'default' => env('log.channel', 'file'), 'channels' => [ 'file' => [ // 日志记录级别：debug, info, notice, warning, error, critical, alert, emergency 'level' => ['debug', 'info', 'notice', 'warning', 'error', 'critical', 'alert', 'emergency'], // 单文件日志（true 表示所有日志写入一个文件，false 按天生成文件） 'single' => false, // 日志文件大小限制（单位：MB），超过自动分割 'file_size' => 100, // 日志路径，默认在 runtime/log/ 'path' => app()->getRuntimePath() . 'log', ], ], ]; ``` 日志文件位置：`runtime/log/2025/04/10.log`（按日期生成）。查看时直接打开对应日期的文件。 - **Laravel 开启日志**： Laravel 默认使用 `stack` 通道，同时写入多个地方。推荐修改 `.env` 文件： ```env # 将日志级别设为 debug，记录所有信息 LOG_LEVEL=debug # 使用 daily 模式，每天一个文件，保留 30 天 LOG_CHANNEL=daily ``` 然后打开 `config/logging.php`，确保 `daily` 通道配置正确： ```php 'daily' => [ 'driver' => 'daily', 'path' => storage_path('logs/laravel.log'), 'level' => env('LOG_LEVEL', 'debug'), 'days' => 30, // 保留天数 ], ``` 日志位置：`storage/logs/laravel-2025-04-10.log`。 - **WordPress 开启调试日志**： WordPress 默认不记录错误日志，需要修改根目录下的 `wp-config.php` 文件。在 `/* That's all, stop editing! Happy publishing. */` 这一行之前添加： ```php // 开启调试模式 define('WP_DEBUG', true); // 将错误记录到文件，不显示在页面上 define('WP_DEBUG_LOG', true); // 关闭前端显示 define('WP_DEBUG_DISPLAY', false); @ini_set('display_errors', 0); ``` 日志文件位置：`wp-content/debug.log`。注意：这个文件可能很大，排查完问题后记得将 `WP_DEBUG` 改回 `false`。 ### 常见问题 **Q1：修改 php.ini 后日志文件没有生成？** A：检查三个地方：① error_log 指定的目录是否存在且 PHP 有写入权限（Linux 下执行 `ls -ld /var/log` 查看权限）。② 是否重启了 PHP 服务。③ 在 php.ini 中搜索 `disable_functions`，看是否禁用了 `error_log` 函数。 **Q2：Nginx 日志文件一直在增长，磁盘空间快满了怎么办？** A：配置日志轮转（logrotate）。Linux 系统通常自带 logrotate，创建一个配置文件 `/etc/logrotate.d/nginx`： ```bash /var/log/nginx/*.log { daily # 每天轮转 rotate 30 # 保留 30 天 compress # 压缩旧日志 delaycompress # 延迟一天压缩 missingok # 日志文件不存在不报错 notifempty # 空文件不轮转 sharedscripts postrotate [ -f /var/run/nginx.pid ] && kill -USR1 `cat /var/run/nginx.pid` endscript } ``` 然后执行 `sudo logrotate -f /etc/logrotate.d/nginx` 立即测试。 **Q3：WordPress 开启 debug.log 后网站变慢？** A：`WP_DEBUG` 会记录所有通知和警告，生产环境流量大时确实影响性能。建议只在排查问题时临时开启，排查完立即关闭。或者将日志级别调高，只记录错误：在 `wp-config.php` 中添加 `define('WP_DEBUG_LOG', true);` 后，再添加 `@ini_set('log_errors_max_len', 0);` 限制单条日志长度。 **Q4：日志文件里全是乱码或看不懂的符号？** A：可能是编码问题。用支持 UTF-8 的编辑器打开（如 VS Code），或者用 `cat` 命令在终端查看。如果日志里包含二进制数据，说明程序有 fatal error 导致输出混乱，检查 PHP 代码中是否有 `exit` 或 `die` 输出非文本内容。 **Q5：虚拟主机用户无法修改 php.ini 怎么办？** A：尝试在网站根目录创建 `.htaccess` 文件（Apache 环境），写入： ```apache php_flag display_errors off php_flag log_errors on php_value error_log /home/yourusername/logs/php_errors.log ``` 如果主机商禁止 `.htaccess` 覆盖，联系客服申请开启错误日志，或者使用框架自带的日志功能（如 WordPress 的 `wp-config.php` 方法）。 ### 收尾总结 日志是网站开发者的眼睛。通过本教程，你学会了三种核心日志的配置方法：PHP 通用错误日志、服务器（Nginx/Apache）访问与错误日志、以及主流框架（ThinkPHP、Laravel、WordPress）的专属日志。配置完成后，当网站再次出现白屏、500 错误或功能异常时，直接打开对应的日志文件，搜索 `error`、`fatal`、`exception` 等关键词，就能快速定位到具体文件和行号。记住一个原则：生产环境关闭前端错误显示（display_errors=Off），但必须开启日志记录（log_errors=On）。定期检查日志文件大小，配置日志轮转，避免日志撑爆磁盘。现在就去检查你的服务器，确保日志已经在记录。