如何让Laravel 10自动识别auth()->user()为User模型类型

给你几个更高效的解决办法，不用每次都手动加类型注释：

1. 自定义全局辅助函数 #

在项目根目录创建helpers.php文件（已有则直接编辑），添加以下代码：

use Illuminate\Support\Facades\Auth;
use App\Models\User;

/**
 * @return \App\Models\User|null
 */
function user(): ?\App\Models\User
{
    return Auth::user();
}

接着在composer.json的autoload配置里引入这个文件：

"autoload": {
    "files": [
        "helpers.php"
    ],
    // 其他自动加载配置...
}

执行composer dump-autoload生效后，直接调用user()就能让IDE自动识别返回User|null类型，省去重复注释的麻烦。

2. 自定义IDE类型提示文件 #

创建ide_helper_custom.php文件放在项目根目录，添加以下代码：

namespace Illuminate\Support\Facades;

/**
 * @method static \App\Models\User|null user()
 */
class Auth extends Facade {}

在IDE设置中把这个文件加入索引，之后Auth::user()和auth()->user()都会被自动识别为返回User|null类型，无需修改框架核心文件。

3. 在控制器基类中封装方法 #

如果仅在控制器场景下频繁使用，可在app/Http/Controllers/Controller.php中添加封装方法：

use App\Models\User;

/**
 * @return \App\Models\User|null
 */
protected function user(): ?User
{
    return auth()->user();
}

后续所有继承该基类的控制器，直接调用$this->user()就能获得带类型提示的用户实例。

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