Laravel同文件枚举加载异常：需先调用主类才可使用

我有一个名为Foo.php的文件，内容如下：

namespace App\Helpers;

enum FooTypes: string {
    case A = "A";
    case B = "B";
}

class Foo {
   const BAR = "Bar";
   // ...
}

以下代码可以正常运行：

use App\Helpers\{ Foo, FooTypes };

echo Foo::BAR;
echo FooTypes::A->value;

但以下代码会抛出"class FooTypes not found"错误：

use App\Helpers\{ Foo, FooTypes };

// echo Foo::BAR;
echo FooTypes::A->value;

看起来必须先调用“主类”Foo，才能使用同文件中声明的枚举FooTypes，这似乎不合理。请问这是什么原因？该如何解决？我不想将枚举拆分到单独文件中。

原因分析 #

这是因为**PHP自动加载机制（尤其是遵循PSR-4规范时）**的默认行为导致的：

• PSR-4规范约定一个文件对应一个类/枚举（或其他可自动加载的符号），自动加载器会根据符号名称去匹配对应的文件。
• 当你仅使用FooTypes时，自动加载器会尝试寻找FooTypes.php文件，但你的枚举定义在Foo.php里，所以找不到；而当你先调用Foo时，Foo.php被加载，文件内的FooTypes枚举也会被PHP解析并注册到内存中，此时才能正常使用。

解决方法 #

1. 手动引入文件 #

在使用FooTypes前，手动加载Foo.php文件，确保文件内的枚举被解析：

require_once app_path('Helpers/Foo.php');
use App\Helpers\FooTypes;

echo FooTypes::A->value;

2. 修改Composer自动加载映射 #

在项目的composer.json中添加类映射，明确告诉自动加载器FooTypes所在的文件：

{
    "autoload": {
        "classmap": [
            "app/Helpers/Foo.php"
        ]
    }
}

修改后执行命令更新自动加载缓存：

composer dump-autoload

之后就能直接使用FooTypes而无需先调用Foo。

3. 临时 workaround（不推荐） #

保持先调用Foo的方式，但这只是临时解决手段，不符合自动加载的设计规范，长期来看可能引发维护问题。

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