在Ubuntu系统中运行PHP应用时,经常会遇到修改了超时相关配置但脚本执行超时限制依旧没有变化的情况,这种问题通常和PHP的运行模式、Web服务器配置以及配置文件的加载优先级有关,需要针对性排查调整。

常见的PHP超时配置项
首先要明确和PHP超时相关的几个核心配置,避免修改了错误的配置项:
- max_execution_time:PHP脚本的最大执行时间,单位是秒,默认值是30,设置为0表示无限制。
- max_input_time:PHP接收POST、GET数据的最大时间,单位秒,默认60。
- default_socket_timeout:PHP socket连接的默认超时时间,单位秒,默认60。
不同运行模式下超时无效的原因与解决
PHP-FPM模式(Nginx常用)
如果是Nginx搭配PHP-FPM的运行环境,超时设置无效大多是因为PHP-FPM和Nginx都有各自的超时配置,只改PHP的配置文件不会生效。
第一步先修改PHP的配置文件,如果是PHP 8.1版本,配置文件路径通常是/etc/php/8.1/fpm/php.ini,找到max_execution_time修改对应的值:
; 修改前 ;max_execution_time = 30 ; 修改后,设置为300秒,即5分钟 max_execution_time = 300
第二步修改PHP-FPM的池配置,路径一般是/etc/php/8.1/fpm/pool.d/www.conf,添加或修改request_terminate_timeout配置,这个配置会覆盖php.ini里的max_execution_time:
; 设置为300秒,和php.ini保持一致,0表示不限制 request_terminate_timeout = 300
第三步修改Nginx的站点配置,在对应的server或者location段添加fastcgi_read_timeout配置,这个参数是Nginx等待PHP-FPM返回结果的超时时间,默认是60秒:
location ~ \.php$ {
fastcgi_pass unix:/run/php/php8.1-fpm.sock;
fastcgi_read_timeout 300;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}修改完成后重启PHP-FPM和Nginx服务让配置生效:
sudo systemctl restart php8.1-fpm sudo systemctl restart nginx
Apache模式(mod_php运行)
如果是Apache使用mod_php方式运行PHP,除了修改php.ini之外,还需要检查Apache的配置是否覆盖了PHP的超时设置。
首先同样修改php.ini文件,路径一般是/etc/php/8.1/apache2/php.ini:
max_execution_time = 300
然后检查Apache的站点配置或者.htaccess文件,看是否有设置php_value max_execution_time,如果有需要同步修改,因为.htaccess里的配置优先级更高:
; 在.htaccess或者Apache配置中添加或修改 php_value max_execution_time 300
修改完成后重启Apache服务:
sudo systemctl restart apache2
其他排查要点
如果修改完上述配置还是无效,可以检查以下几点:
- 确认修改的是当前PHP版本对应的配置文件,可以通过
phpinfo()函数查看Loaded Configuration File项确认加载的php.ini路径。 - 检查脚本中是否有使用
set_time_limit()函数动态修改超时时间,这个函数会覆盖配置文件里的设置。 - 如果是通过浏览器访问脚本,还要检查Nginx或者Apache的代理超时配置,如果是反向代理场景,代理层的超时设置也会影响最终结果。
可以通过简单的测试脚本验证超时设置是否生效:
<?php
// 输出当前最大执行时间
echo "当前max_execution_time:" . ini_get('max_execution_time') . "秒<br>";
// 执行一个耗时操作,比如睡眠200秒,如果设置生效不会超时
sleep(200);
echo "脚本执行完成";
?>访问这个脚本如果可以正常执行完输出最后的内容,说明超时设置已经生效。