在PHP编程中，递归是处理层级数据、树形结构遍历等场景的常用手段，但递归调用并非可以无限执行，PHP本身对递归深度有隐性或显性的限制，超过限制就会触发错误导致程序中断。下面我们就来详细了解PHP递归深度的相关规则和调整方法。
PHP递归深度的默认限制规则
PHP没有单独设置递归深度的配置项，递归的最大可执行深度主要由两个核心因素决定：一是memory_limit内存限制，二是max_execution_time最大执行时间限制，同时递归调用本身会占用栈空间，当栈空间耗尽或者达到上述两个限制时，递归就会终止。
通常情况下，在默认配置（内存128M、执行时间30秒）的PHP环境中，简单的无额外内存消耗的递归函数，最大深度大概在1000到10000次之间，具体数值和递归函数内部的内存占用、执行耗时直接相关。如果递归函数内部有数组操作、数据库查询等消耗资源的逻辑，可执行的递归深度会明显降低。
影响递归深度的核心配置项
我们可以通过调整以下PHP配置参数，间接提升递归的最大可执行深度：
- memory_limit：设置脚本可使用的最大内存，默认值为128M，递归调用会在内存栈中保存每一层的上下文，内存越大可支持的递归深度越高。
- max_execution_time：设置脚本的最大执行时间，默认值为30秒，递归层数越多总执行时间越长，适当调大该值可避免递归未执行完就被中断。
- max_input_time：如果是通过请求触发递归逻辑，该参数会影响请求数据的解析时间，间接影响递归可执行的时长。
调整递归深度限制的具体方法
方法1：修改php.ini配置文件
如果需要全局调整递归相关的限制，可以直接修改PHP的配置文件php.ini，找到对应的配置项修改后重启PHP服务即可生效：
; 调整最大内存限制为512M，支持更深的递归 memory_limit = 512M ; 调整最大执行时间为120秒，避免递归执行超时 max_execution_time = 120
方法2：运行时通过ini_set函数调整
如果只需要针对单个脚本调整限制，可以在脚本开头使用ini_set函数动态修改配置，这种方式不需要重启服务，仅对当前脚本生效：
<?php
// 临时调整当前脚本的最大内存为256M
ini_set('memory_limit', '256M');
// 临时调整当前脚本的最大执行时间为60秒
ini_set('max_execution_time', 60);
// 定义一个简单递归函数测试深度
function test_recursion($depth = 0) {
echo "当前递归深度：{$depth}" . PHP_EOL;
// 递归调用，每层的深度加1
test_recursion($depth + 1);
}
// 执行递归函数，注意超过限制会报错
test_recursion();方法3：通过.htaccess文件调整（仅Apache环境）
如果服务器使用Apache且开启了AllowOverride，也可以在网站根目录的.htaccess文件中添加配置，调整递归相关的限制：
php_value memory_limit 256M php_value max_execution_time 60
递归过深的优化建议
不建议无限制调大递归相关配置来支持过深的递归，一方面过深的递归会占用大量内存和栈空间，另一方面递归层数过深还会触发段错误导致进程崩溃。如果确实需要处理深层级的业务逻辑，可以参考以下优化思路：
- 将递归逻辑改为迭代循环，使用数组模拟栈结构保存上下文，避免占用系统栈空间。
- 如果必须保留递归，可以拆分递归逻辑，每处理一定层数就将中间结果持久化到缓存或数据库，减少单次递归的深度。
- 提前判断递归的终止条件，避免出现无限递归的情况，同时减少递归函数内部的额外资源消耗。
常见问题说明
有些开发者会误以为存在单独的recursion_limit配置项，实际上PHP官方并没有提供这个配置，所有递归深度的限制都是通过上述通用配置间接生效的。如果递归过程中出现了Fatal error: Maximum execution time exceeded或者Fatal error: Allowed memory size exhausted的错误，就可以对应调整上述配置项。
另外需要注意，PHP的CLI模式（命令行运行脚本）的默认配置通常比FPM模式更宽松，默认执行时间是0（无限制），内存限制也更高，如果是命令行执行的递归脚本，一般不需要额外调整执行时间配置。
PHP递归递归深度限制max_execution_timeini_set递归优化修改时间：2026-06-02 05:15:24