Laravel中如何为auth()助手函数添加自定义扩展方法

以下是两种常用的实现方式，可根据业务复杂度选择：

方案一：通过 Macro 宏快速扩展（优先推荐，无需修改核心配置） #

Laravel 内置的 Illuminate\Auth\SessionGuard 类引入了 Macroable 特性，支持动态扩展自定义方法，全程只需修改一处代码即可完成配置。

• 第一步：在 app/Providers/AppServiceProvider.php 的 boot 方法中注册自定义宏

use Illuminate\Auth\SessionGuard;

public function boot()
{
    // 新增 auth()->seller() 方法
    SessionGuard::macro('seller', function () {
        // 可根据业务调整返回逻辑，示例为返回 seller 守卫对应的用户实例
        return $this->guard('seller')->user();
    });

    // 新增 auth()->author() 方法
    SessionGuard::macro('author', function () {
        // 示例为返回 author 守卫对应的用户ID
        return $this->guard('author')->id();
    });
}

• 第二步：直接调用即可，使用方式和原生 auth()->id()、auth()->user() 完全一致

// 获取 seller 实例
$seller = auth()->seller();
// 判空后获取 author ID
$authorId = auth()->author()?->id;

方案二：自定义 Guard 类（适合复杂业务场景） #

如果自定义方法需要封装大量业务逻辑，不适合写在宏定义中，可以选择继承原生 Guard 类扩展的方式实现：

• 第一步：创建自定义 Guard 类 app/Auth/CustomSessionGuard.php

namespace App\Auth;

use Illuminate\Auth\SessionGuard as BaseSessionGuard;

class CustomSessionGuard extends BaseSessionGuard
{
    // 自定义 seller 方法
    public function seller()
    {
        // 你的业务逻辑
        return $this->guard('seller')->user();
    }

    // 自定义 author 方法
    public function author()
    {
        // 你的业务逻辑
        return $this->guard('author')->user();
    }
}

• 第二步：在 app/Providers/AppServiceProvider.php 的 boot 方法中注册自定义 Guard

use Illuminate\Support\Facades\Auth;
use App\Auth\CustomSessionGuard;

public function boot()
{
    Auth::extend('custom-session', function ($app, $name, array $config) {
        return new CustomSessionGuard(
            $name,
            $app['auth']->createUserProvider($config['provider']),
            $app['session.store'],
            $app['request']
        );
    });
}

• 第三步：修改 config/auth.php 配置，将默认 web 守卫的驱动替换为自定义驱动

'guards' => [
    'web' => [
        'driver' => 'custom-session', // 原默认值为 session，替换为你注册的驱动名
        'provider' => 'users',
    ],
],

• 第四步：调用方式和原生方法一致

auth()->seller();
auth()->author();

注意事项 #

• 如果项目使用的是非 session 类的守卫驱动（比如 token、sanctum），只需要将宏绑定到对应驱动的 Guard 类即可
• 宏扩展方式无需修改核心配置，Laravel 版本升级也不会受影响，普通场景优先选择该方案

内容的提问来源于stack exchange，提问作者Ghiath Al-Khatib