PHP的max_execution_time参数用于限制脚本的最大执行时间，默认值为30秒，当脚本执行时间超过这个限制时，PHP会抛出致命错误并终止脚本运行。合理调整这个参数可以避免因长时间运行的任务导致程序异常中断。
一、通过php.ini配置文件全局设置
这是最基础的全局设置方式，修改后会对所有PHP脚本生效，适合需要统一调整超时时间的场景。
首先找到PHP的配置文件php.ini，不同环境下的路径可能不同，可以通过phpinfo()函数查看配置文件的具体位置。在配置文件中找到max_execution_time项，修改其数值即可，单位是秒。
; 设置脚本最大执行时间为60秒 max_execution_time = 60
修改完成后需要重启PHP服务（比如Apache、Nginx+PHP-FPM）才能让配置生效。如果是共享主机环境，可能没有权限修改php.ini，此时可以选择其他方式调整。
二、使用ini_set函数动态设置
如果无法修改全局配置文件，或者只需要对单个脚本调整超时时间，可以在脚本运行时使用ini_set函数动态修改参数。
这种方式仅对当前执行的脚本有效，不会影响其他脚本的运行，灵活性更高。
<?php
// 设置当前脚本最大执行时间为120秒
ini_set('max_execution_time', 120);
// 模拟长时间运行的任务
sleep(100);
echo '任务执行完成';
?>
需要注意的是，ini_set函数的修改作用范围是当前请求，脚本执行结束后配置会恢复为默认值。另外，部分服务器可能禁用了ini_set函数，此时这种方式会失效。
三、通过set_time_limit函数设置
PHP还提供了set_time_limit函数来专门设置脚本的超时时间，功能和ini_set('max_execution_time', $seconds)类似，但使用更简洁。
该函数的参数是允许脚本运行的最大秒数，设置为0表示没有时间限制。
<?php
// 设置脚本最大执行时间为180秒
set_time_limit(180);
// 执行耗时操作
for ($i = 0; $i < 1000000; $i++) {
// 模拟计算任务
$result = $i * 2;
}
echo '计算完成';
?>
如果调用set_time_limit时脚本已经运行了一定时间，那么新的超时时间会从调用时刻开始计算，而不是从脚本启动开始计算。
四、不同运行模式下的注意事项
1. PHP-FPM模式
在PHP-FPM运行模式下，除了max_execution_time参数，还需要注意PHP-FPM自身的request_terminate_timeout配置，这个参数的优先级更高，如果脚本执行时间超过了这个值，会被PHP-FPM直接终止。
可以在PHP-FPM的池配置文件中调整这个参数：
; 设置PHP-FPM请求终止超时时间为300秒 request_terminate_timeout = 300
2. 命令行模式
PHP在命令行（CLI）模式下运行时，max_execution_time默认值为0，也就是没有时间限制，此时通过配置文件或ini_set设置的超时时间可能不会生效，需要手动调用set_time_limit函数来限制执行时间。
五、超时时间设置的建议
- 不要盲目将超时时间设置得过长，避免异常脚本长时间占用服务器资源，建议根据实际任务的耗时合理设置。
- 对于确实需要长时间运行的任务，比如大文件处理、批量数据导入，建议使用队列异步处理，而不是直接调整超时时间。
- 修改全局配置前，先确认服务器是否有足够的资源支撑更长的脚本执行时间，避免影响其他服务的运行。
通过以上几种方式，开发者可以根据不同的场景灵活调整PHP的超时时间，解决脚本执行超时的问题。如果调整后出现不生效的情况，可以先通过phpinfo()函数查看当前max_execution_time的实际值，排查配置是否被正确加载。
PHPmax_execution_time超时时间设置脚本执行时间修改时间：2026-07-15 03:27:23