Laravel 9.6使用Trait时Filesystem类不存在错误的解决咨询

你在Trait中初始化$filesystem时，未指定完整命名空间，Laravel容器会默认在当前命令类（App\Console\Commands\MakeCustomControllerCommand）的命名空间下查找Filesystem类，导致找不到目标类，抛出Target class [App\Console\Commands\Filesystem] does not exist错误。

以下几种方案都能保留Trait中的$filesystem属性，同时解决依赖注入问题：

方案一：Trait内通过完整命名空间初始化实例 #

直接在Trait中导入Laravel官方的Filesystem类，通过容器解析实例：

<?php

namespace App\Traits;

use Illuminate\Filesystem\Filesystem;

trait Stubs
{
    protected $filesystem;

    // Laravel 5.5+ 会自动调用以initialize{TraitName}命名的初始化方法
    public function initializeStubs()
    {
        $this->filesystem = resolve(Filesystem::class);
    }

    // 你的文件操作逻辑方法
}

方案二：命令类构造注入后传递给Trait #

如果命令类本身依赖构造注入，可在命令类中注入Filesystem，再赋值给Trait的属性：

// Trait文件：App\Traits\Stubs.php
<?php

namespace App\Traits;

use Illuminate\Filesystem\Filesystem;

trait Stubs
{
    protected $filesystem;

    // 可选：提供设置方法统一接收实例
    public function setFilesystem(Filesystem $filesystem)
    {
        $this->filesystem = $filesystem;
    }
}

// 命令类文件：App\Console\Commands\MakeCustomControllerCommand.php
<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use App\Traits\Stubs;
use Illuminate\Filesystem\Filesystem;

class MakeCustomControllerCommand extends Command
{
    use Stubs;

    protected $signature = 'make:custom-controller';

    public function __construct(Filesystem $filesystem)
    {
        parent::__construct();
        // 直接赋值或调用Trait的设置方法
        $this->filesystem = $filesystem;
        // $this->setFilesystem($filesystem);
    }

    public function handle()
    {
        // 使用$this->filesystem执行文件操作
    }
}

方案三：通过File门面获取实例 #

若不需要手动管理实例，可利用Laravel的File门面获取底层Filesystem实例，同时保留$filesystem属性：

<?php

namespace App\Traits;

use Illuminate\Support\Facades\File;

trait Stubs
{
    protected $filesystem;

    public function initializeStubs()
    {
        // 获取门面对应的底层实例
        $this->filesystem = File::getFacadeRoot();
    }
}

修改完成后，运行命令：

php artisan make:custom-controller

此时应不再抛出类不存在的错误，Trait中的$filesystem可正常执行文件操作。

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