CodeIgniter 4通过Registrar合并菜单配置数组遇无限循环求助

问题场景 #

主CodeIgniter 4安装目录下有一个Menu配置文件，其中的$menu变量存储系统菜单结构数组；同时开发了一个可复用模块，模块内也有同名的Menu配置文件，包含模块专属的菜单选项。尝试通过Registrar文件合并两个数组并赋值给主配置的$menu变量时，调用array_merge()合并两个配置属性触发了无限循环错误，错误信息如下：

Xdebug has detected a possible infinite loop, and aborted your script with a stack depth of '256' frames

原Registrar代码：

<?php

namespace Developer\Config;

use Developer\Collectors\Developer;

class Registrar
{
    public static function Menu(): array
    {
        $app_config = config('Menu');
        $sub_config = new Developer\Config\Menu();

        $menu = array_merge($app_config->menu, $sub_config->menu);
        
        return [
            'menu' => $menu,
        ];
    }

    public static function Toolbar(): array
    {
        return [
            'collectors' => [
                Developer::class,
            ],
        ];
    }
}

问题原因 #

当在Registrar的Menu()方法中调用config('Menu')时，CodeIgniter的配置注册机制会检测到当前正在处理Menu配置的注册，进而再次触发Registrar的Menu()方法，形成无限递归调用，最终触发Xdebug的无限循环检测。

解决方法 #

方法一：直接实例化主配置类（最稳妥） #

绕过config()函数的注册流程，直接通过命名空间实例化主目录的Menu配置类，避免递归触发：

<?php

namespace Developer\Config;

use Developer\Collectors\Developer;

class Registrar
{
    public static function Menu(): array
    {
        // 直接实例化全局命名空间下的主Menu配置
        $app_config = new \Config\Menu();
        $sub_config = new Developer\Config\Menu();

        $menu = array_merge($app_config->menu, $sub_config->menu);
        
        return [
            'menu' => $menu,
        ];
    }

    public static function Toolbar(): array
    {
        return [
            'collectors' => [
                Developer::class,
            ],
        ];
    }
}

方法二：调整合并时机，避开Registrar阶段 #

不在Registrar中处理配置合并，而是在应用启动完成后（比如模块路由文件、自定义服务类）执行合并逻辑：

// 示例：在模块的Routes.php文件中添加
if (! is_cli()) {
    $appMenu = config('Menu')->menu;
    $moduleMenu = config('Developer\Config\Menu')->menu;
    // 合并后覆盖主配置的menu数组
    config('Menu')->menu = array_merge($appMenu, $moduleMenu);
}

这种方式不会触发配置注册的递归，因为此时所有配置已经完成加载。

方法三：明确指定配置命名空间（需测试兼容性） #

如果主配置在全局命名空间，模块配置在Developer命名空间，可以尝试明确指定命名空间调用config()，部分场景下可避免循环：

$app_config = config('\Config\Menu');
$sub_config = config('Developer\Config\Menu');

注意：该方法在部分CI4版本中仍可能触发循环，优先推荐方法一。

内容的提问来源于stack exchange，提问作者James