PHP错误日志,解决不显示不记录日志文件等疑难杂症

PHP不显示错误日志,适用于 Ningx + php-fpm +PHP 以及 Apache +mod/cgi+ PHP 方式加载运行的PHP。

表现特征为:web访问显示404(nginx)、配置php.ini、配置php-fpm.conf 不记录日志。

本文版本信息:

PHP 5.6.34

Nginx 1.12

Apache2.1

Nginx + php-fpm

这种方式加载运行的PHP,执行调用逻辑如下。

nginx => php-fpm => php

1.nginx日志

nginx 一般只用于记录网络请求状态日志,没有php相关日志。

大多数情况下用于分析200、500、等状态码的地址。

2018/05/16 17:42:33 [error] 27980#0: *1803 open() "/www/wwwroot/example/themes/images/sprite_index.png" failed (2: No such file or directory), client: 113.90.0.1, server: example.com, request: "GET /themes/images/sprite_index.png HTTP/1.1", host: "example.com", referrer: "http://example.com/themes/css/color.css"

nginx 加载PHP 一般情况下,我们采用的是 fastcgi_pass 方式将请求移交给 php-fpm 去分发解析处理。

fastcgi_pass  unix:/tmp/php-cgi-56.sock;
# 或者
fastcgi_pass 127.0.0.1:9000;

关于PHP的日志,我们到 php-fpm 日志中查看。

2.php-fpm

php-fpm 是负责调度和管理 php-cgi 的管理器,调度 nginx 和 php-cgi 之间通讯请求的传话员。在这里就可以和 php-cgi 直接交互,也可以干涉 php 的一些初始化参数配置。

配置文件:php-fpm.conf

配置文件一般位于php目录下,编译可通过 --enalbe-fpm 选项开启,位置如 php/etc/php-fpm.conf

; 配置 php-fpm 日志输出地址
error_log = /www/server/php/56/var/log/php-fpm.log


; 错误级别可用级别为:
; alert(必须立即处理),error(错误情况),warning(警告情况),notice(一般重要信息),debug(调试信息).默认: notice.
log_level = notice

; 重定向运行过程中的stdout和stderr到主要的错误日志文件中.
; 如果没有设置, stdout 和 stderr 将会根据FastCGI的规则被重定向到 /dev/null .默认值: 空.
catch_workers_output = 1

; php_value,php_admin_value 用于配置 php.ini 里面的项的值,可直接配置具体值
; php_flag,php_admin_flag 用于配置 php.ini 里面项的开关,可使用on/off,1/0,true/false,yes/no.
; 以上四种指令,包含admin字符的指令均不会被 php 脚本 ini_set 函数所覆盖,反之可能会被 ini_set 指令冲洗掉。
php_flag[display_errors] = on
php_admin_value[error_log] = /var/log/php56/php_error_admin.log
php_admin_flag[log_errors] = on
php_admin_value[memory_limit] = 32M

自此,也就意味着,php.ini 配置可能会被 php-fpm 覆盖掉,也可能会被具体执行的php脚本覆盖掉。

优先级别由低至高如下,php.ini < php-fpm.conf < *.php

对于一个庞大陌生的项目,nginx 返回404,最好的解决办法是,检查php.ini配置项之后,再去使用 php-fpm php_admin* 指令指定下。最后通过 phpinfo() 检查一下,配置项是否设置正常。

php-fpm.log 常规日志如下

[16-May-2018 17:31:18] ERROR: FPM initialization failed
[16-May-2018 17:31:30] NOTICE: Finishing ...
[16-May-2018 17:31:30] NOTICE: exiting, bye-bye!
[16-May-2018 17:31:31] NOTICE: fpm is running, pid 27896
[16-May-2018 17:31:31] NOTICE: ready to handle connections
[16-May-2018 17:32:12] NOTICE: Finishing ...
[16-May-2018 17:32:12] NOTICE: exiting, bye-bye!
[16-May-2018 17:32:13] NOTICE: fpm is running, pid 28330
[16-May-2018 17:32:13] NOTICE: ready to handle connections
[16-May-2018 17:32:38] NOTICE: Terminating ...
[16-May-2018 17:32:38] NOTICE: exiting, bye-bye!
[16-May-2018 17:32:49] NOTICE: fpm is running, pid 28727
[16-May-2018 17:32:49] NOTICE: ready to handle connections

3.php.ini

关于 php.ini 日志,也是和php脚本息息相关的,这里可以列举了如下方式,快速显示和定位错误。

; 这个是 php5.6 默认的配置,脚本中都将不能使用这些函数,如果使用则会抛出Warning级别的一个错误。
; 我们在基础上增加一些关于php 错误捕获,错误重定向的一些函数,避免错误被项目重定向到空或者某个未知空间。
; 同样也可以在这里禁止 ini_set 函数,避免项目使用这个函数将我们的配置文件重写掉。
; 增加的函 ini_set,error_reporting,set_error_handler,set_exception_handler,register_shutdown_function

;disable_functions = passthru,exec,system,chroot,chgrp,chown,shell_exec,popen,ini_alter,ini_restore,dl,openlog,syslog,readlink,symlink,popepassthru

; 增加后的配置
disable_functions = passthru,exec,system,chroot,chgrp,chown,shell_exec,popen,ini_alter,ini_restore,dl,openlog,syslog,readlink,symlink,popepassthru,ini_set,error_reporting,set_error_handler,set_exception_handler,register_shutdown_function


; 开启错误级别
error_reporting = E_ALL
;error_reporting = E_ALL | ~E_NOTICE


; 开启显示错误,开启则将错误直接输出到用户端浏览器(stderr),反之则记录在日志error_log(stdout)
; 一般生产环境这项是关闭的,对于调试错误可以暂时开启来显示错误或者定位到错误文件。
; php脚本运行时也可以通过 ini_set 函数重写掉这项值,前提是保障在运行正常的代码前加入,但也可能被后面的代码所覆盖。
; 所以还是推荐禁用掉 ini_set 函数解决根本。
display_errors = On


; 设置是否将脚本运行的错误信息记录到服务器错误日志或者error_log之中
log_errors = On


; 开启日志长度,默认1024,0为不限制,调试时可扩大长度避免产生大量错误没有记录到。
log_errors_max_len = 10240

; 捕获错误
;track_errors = On
track_errors = Off

; 日志输出的文件路径
; 该文件一定是可以被web用户可写的,例如当前的 php-fpm 加载器的用户,可以在 php-fpm.conf 中查看。
; 如果没有权限也可能会造成日志文件不被创建,不被写入的状况。
error_log =  /var/log/php56/php_error.log


; 以下两个配置项可以用于手工调试时方便使用。
;error_prepend_string = "-- error start --" 要在错误信息之前输出的自定义内容
;error_append_string = "-- error end --" 要在错误信息之后输出的自定义内容

自此,主要涉及php的日志就只有两个, php-fpm.conf 和 php.ini 。

优先推荐通过配置php.ini 来设置错误项,之后还不能解决再去考虑通过php-fpm.conf 去覆盖错误项(php_admin*),终极方案就是通过禁用捕获错误、重定向的相关错误函数来保证配置不会被项目覆盖,以此来调试解决掉项目的错误。

Apache + PHP

相对于Apache配置的PHP来说,获取错误日志的方式就非常简单。只需要短短两行就可以配置完毕。

1.fcgi_mod

fcgi 配置的apache虚拟主机配置文件

<VirtualHost *:80>
      ServerName "localhost"
      ServerAlias www.localhost.com
      FcgidInitialEnv PHPRC "/usr/local/php/php56/"
      FcgidWrapper "/usr/local/php/php56/bin/php-cgi" .php
      DocumentRoot "/mnt/www/default/wwwroot"

      # 以下为错误日志和访问日志。
      ErrorLog  "/mnt/www/default/log/error.log"
      CustomLog "/mnt/www/default/log/access.log" common
</VirtualHost>

php_module 配置的方式也可以通过 php_value,php_admin_value 配置php.ini里面设置项,fcgi_mod 找了很久没有找到相应的配置项。

关于防止项目中重写php.ini,也可通过禁用函数来避免。参考上文禁用函数以及开启日志。

一般情况下,Apache的日志会非常准确的定位出来,记录在你所配置的ErrorLog文件中。

总结

这里简单总结下,很多的陌生项目或者有问题却找不到,而且也没有显示出来的项目调错会很头疼。

对于此类项目中,一般是都重定向了错误的输出方式,据此可以禁用掉相关的函数避免项目使用。

常规的项目可以通过常规配置日志的方式来解决记录日志,如果一切都不正常则可能是日志的权限问题。

最后一个则是,确保每一次修改完配置文件,php-fpm的进程或apache的进程都能够全部结束,再运行。

手工排错,推荐使用  debug_backtrace(); 

对此,列出以下检查范围,可供参考。

  1. php.ini 位置是否正确,对比phpinfo,避免修改错文件
  2. php.ini 配置项错误日志全部开启,可选择禁用函数
  3. php-fpm.conf 重写php.ini重要选项配置
  4. php-fpm 或者 apache进程全部结束后,再启动,之后再去验证测试。
  5. 确保配置中的文件目录存在,目录下php执行所属用户拥有可写权限。
  6. 最终确认项目是否有缓存,避免业务没有执行到,误以为配置错。

(完) 

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏沈唁志

怎么快速集成QQ微博等第三方授权登录功能?

日常项目中经常会用到QQ授权登录或者微信授权登录,方便了用户,否则需要手机验证码等等的操作,授权登录只需要一键操作

12410
来自专栏菜鸟程序员

Android 调试桥

22330
来自专栏云计算教程系列

【基础干货】Linux Shell基础教程

shell,也称为“命令行界面”或“CLI”,是与远程Linux服务器交互的主要方法。shell是一个丰富的界面,用于处理文件,管理系统和编写常见任务脚本。如果...

15940
来自专栏好好学java的技术栈

手把手从零开始带你学git和GitHub

版本: 想想你平时用的软件,在软件升级之后,你用的就是新版本的软件。你应该见过这样的版本号:v2.0 或者 1511(表示发布时为15年11月),如下图:

12920
来自专栏MongoDB中文社区

使用mlaunch和m快速搭建MongoDB测试集群

不知道大家在使用MongoDB的时候有没有遇到突然想要一个集群但是手边又没有的时候?特别是我已经升级到4.0了,突然想要一个3.2的集群怎么办?然后去下载,改配...

13310
来自专栏云计算教程系列

在Ubuntu 16.04如何使用Percona将MySQL类别的数据库备份到指定的对象存储上呢?

数据库通常会在您的基础架构中存储一些最有价值的信息。因此,在发生事故或硬件故障时,必须具有可靠的备份以防止数据丢失。

17030
来自专栏从零开始学自动化测试

python接口自动化17-响应时间与超时(timeout)

前言 requests发请求时,接口的响应时间,也是我们需要关注的一个点,如果响应时间太长,也是不合理的。 如果服务端没及时响应,也不能一直等着,可以设置一个t...

64260
来自专栏企鹅号快讯

那些实用的Nginx规则

1. 概述 大家都知道Nginx有很多功能模块,比如反向代理、缓存等,这篇文章总结下我们这些年实际环境中那些有用的Nginx规则和模块,大部分是用法的概括及介绍...

27750
来自专栏L宝宝聊IT

LVS负载均衡群集--NAT+DR模式

17780
来自专栏我的博客

php+ftp

$ftp_server = “122.207.221.101”;//主机ip或者域名 $conn_id = ftp_connect($ftp_server) o...

37850

扫码关注云+社区

领取腾讯云代金券