如何在 XAMPP 中配置 PHP 的 max_execution_time 执行超时时间

如何在 XAMPP 中配置 PHP 的 max_execution_time 执行超时时间

直接修改 php.ini 并重启 Apache 服务，是唯一可靠且永久生效的方法；其他临时方案在 XAMPP 集成环境中要么效果有限，要么不推荐用于生产部署。

如何定位并修改 XAMPP 的 php.ini 配置文件

XAMPP 自带的 PHP 配置文件路径是固定的：位于安装目录下的 php\php.ini（例如 C:\xampp\php\php.ini）。无需在 Apache 目录或控制面板中寻找“PHP 设置”选项——那些只是快捷入口，最终生效的修改必须落实到这个核心文件。

• 使用记事本、Notepad++ 或 VS Code 等文本编辑器，以管理员身份打开 php.ini，否则保存时可能因权限不足而失败。
• 在文件中搜索 max_execution_time 参数，你会找到默认配置行：max_execution_time = 30。
• 将其修改为你所需的秒数，例如在进行大数据导出或复杂计算时，可设置为 max_execution_time = 600（即10分钟）。
• 请注意，避免为图方便而设置为 0。在 XAMPP 默认的 Web SAPI（Apache 模块）运行模式下，设为 0 可能导致脚本无限期挂起，无法被正常中断，从而耗尽服务器资源。

修改后为何必须重启 Apache 服务？

核心原因在于，XAMPP 的 Apache 是将 PHP 作为模块（mod_php）加载的，php.ini 配置文件仅在 Apache 服务启动时被读取一次。修改后若不重启，通过 phpinfo() 函数查看到的仍是旧的超时值。

• 正确步骤是：在 XAMPP 控制面板中，先点击 Stop 按钮停止 Apache 服务，再点击 Start 按钮重新启动。直接使用 Restart 按钮有时可能无法完全重载配置。
• 重启后，务必创建一个简单的 PHP 测试脚本进行验证：，输出的数值应与你的设置一致。
• 如果输出仍为 30，很可能修改了错误的文件（例如误改了 php.ini-development 或 php.ini-production 等备份配置文件）。

ini_set() 与 set_time_limit() 函数在 XAMPP 中是否有效？

这两个函数可以用于临时调试，但存在明确的局限性：

• ini_set('max_execution_time', '600') 必须放置在脚本的最开始位置，且仅对当前单次请求生效。更重要的是，如果 php_admin_flag[disable_functions] 指令禁用了 ini_set 函数（XAMPP 默认未禁用），则该代码将完全失效。
• set_time_limit(600) 会从函数调用时刻起重新计算执行时间，但多次调用可能被 Apache 自身的 Timeout 指令所覆盖（XAMPP 默认值为 300 秒）。
• 这两个函数均无法绕过 Apache 自身的超时控制机制。而 XAMPP 的 Apache 配置并未提供便捷修改 Timeout 的图形界面。因此，它们仅适用于临时调整，并非一劳永逸的解决方案。

别忘了同步调整 max_input_time 这个关键参数

许多情况下，脚本执行超时并非源于处理时间过长，而是卡在了“接收请求数据”的阶段。例如，在上传大型文件或处理海量 POST 数据时，输入解析可能率先超时。在 XAMPP 的 php.ini 中，max_input_time 默认值为 -1，这意味着它会自动继承 max_execution_time 的设置——因此，当你修改后者时，前者通常也会同步更新。

但如果你曾手动设置过 max_input_time 为特定值，则需要单独检查并修改它。否则，在上传大文件时，连接可能在30秒内就被切断，数据尚未传输完毕，脚本甚至还未开始正式执行。

另一个极易被忽略的要点是：XAMPP 的 Apache 模块不支持在 .htaccess 文件中使用 php_value max_execution_time 这类指令。强行添加不仅无效，还可能引发 500 内部服务器错误。因此，所有 PHP 配置的修改，都应回归到 php.ini 文件中进行，这才是确保 XAMPP 环境稳定运行的最稳妥路径。