在Laravel中，如果在一个文件中声明了枚举（Enums），并且该文件包含其他类，这些枚举不会被加载，直到主类被调用。

Question

我有一个文件，我们称它为 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 才能使用在同一文件中声明的枚举。但这似乎有些荒谬。这是怎么回事？我该如何解决这个问题？虽然我可以考虑将枚举分离到单独的文件中，但在我的使用场景下这样做确实没有意义。

StuartLC · Answer

由于 use 语句并不真正“加载”文件，直到你实际调用其中的内容为止，

当你调用 Foo::BAR 时，它会加载 App\Helpers\Foo.php 文件，因此你能够使用来自同一文件的 FooTypes 枚举。

这里有一个示例，按照目前的情况可以正常运行，但如果注释掉第一条返回语句，程序将会抛出错误：

// 假设文件位于 app\Helpers\Foo.php
use \App\Helpers;

// 这是一个无效引用，只要不调用它，就不会引发问题
use \Something\That\Dont\Exist;

Route::get('/something', function() {    

    // 正常运行，因为它首先加载了 app\Helpers\Foo.php 文件并能在其中找到 FooTypes 枚举
    return [Helpers\Foo::BAR, Helpers\FooTypes::A];

    // 抛出错误，因为在尝试首先加载 app\Helpers\FooTypes.php 文件
    return [Helpers\FooTypes::A, Helpers\Foo::BAR];

});

Felix Kling · Answer

use 语句纯粹是一种在特定文件中为不同命名空间中的符号（如类、函数、枚举等）提供简写的方式。请参阅 PHP 手册中的使用命名空间：别名/导入。它允许你编写 echo FooTypes::A->value; 而不是 echo \App\Helpers\FooTypes::A->value; ，但这正是它所做的一切。

这一点与如何加载特定符号的定义完全无关。对于这一点，你可能依赖于自动加载，即在首次使用特定类、枚举等时运行回调函数。回调函数通常会包含定义该符号的文件。

明确一点，使用 use 语句为符号定义别名，并不会触发自动加载器运行。只有实际 执行需要该定义的代码 时，才会触发自动加载器。

最常见的约定是将每个定义放入单独的文件中，然后配置自动加载器根据名称加载文件；但这只是一个约定。如果你想采用不同的约定，比如任何以 "Types" 结尾的名称都与不带该后缀的类位于同一文件中，你可以编写一个实现这种约定的自动加载函数。例如：

function my_autoload_callback(string $nameToLoad): void {
    $filePath = PROJECT_ROOT . '/' . str_replace('\', '/', $nameToLoad) . '.php';
    if (file_exists($filePath)) {
        require_once $filePath;
    } else {
        // 尝试去掉末尾的 "Types"
        // 这里应该再进行一次文件存在性检查
        require_once str_replace('Types.php', '.php', $filePath);
        // 我们可以在这里检查是否找到了正确的类
    }
    // 如果函数在这儿还没有加载所需的类，
    //   PHP 将抛出一个 “未找到类” 的错误
}

请注意，自动加载器并不知道它正在查找的是类、接口、特性还是枚举；你唯一能得到的输入是完全限定名称，例如 "App\Helpers\FooTypes" 。