Laravel中视图、控制器等适用的全局变量最佳实现方案问询

数据老陈

2026-5-13

最佳方案：用Laravel服务容器管理请求级全局上下文

我太懂你这种纠结了——要处理这种依赖请求路由、动态数据库数据的全局变量，之前试过的方法要么繁琐，要么有局限，比如View Composer只能管视图，BaseController手动传值又累还没法在模型里用。其实Laravel的服务容器（Service Container）就是解决这类问题的最佳工具，既符合框架最佳实践，又能满足你“全局可用、请求内缓存、非hack”的需求。

核心思路：封装上下文到服务类，绑定为单例

我们可以把current_page、current_site这类请求级的上下文数据，封装到一个专门的服务类里，然后把这个类绑定到服务容器的单例。这样整个请求周期内，这个类只会被实例化一次，数据库查询也只会执行一次，同时你可以在控制器、模型、视图里随时获取这些数据。

步骤1：创建上下文服务类

先创建一个CurrentContext类，把获取当前站点、页面的逻辑集中在这里：

namespace App\Services;

use App\Models\Page;
use App\Models\Site;

class CurrentContext
{
    protected ?Site $currentSite = null;
    protected ?Page $currentPage = null;

    public function __construct()
    {
        // 从路由参数获取slug（根据你的路由结构调整）
        $siteSlug = request()->route('site_slug');
        $pageSlug = request()->route('page_slug');

        // 查询并缓存当前站点和页面
        $this->currentSite = Site::where('slug', $siteSlug)->firstOrFail();
        $this->currentPage = Page::where('site_id', $this->currentSite->id)
            ->where('slug', $pageSlug)
            ->firstOrFail();
    }

    // 获取当前站点
    public function getCurrentSite(): Site
    {
        return $this->currentSite;
    }

    // 获取当前页面
    public function getCurrentPage(): Page
    {
        return $this->currentPage;
    }

    // 可以根据需求添加更多上下文方法，比如当前用户的权限、站点配置等
}

步骤2：绑定为容器单例

在AppServiceProvider的register方法里，把这个类绑定为单例——这样整个请求周期内，容器只会创建一次这个类的实例，避免重复查询数据库：

namespace App\Providers;

use App\Services\CurrentContext;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    public function register()
    {
        // 绑定CurrentContext为单例
        $this->app->singleton(CurrentContext::class, fn ($app) => new CurrentContext());
    }

    // ...
}

步骤3：共享到所有视图

如果你需要在视图里直接使用$current_site、$current_page，可以在AppServiceProvider的boot方法里用视图 composer 全局共享：

public function boot()
{
    // 全局共享上下文数据到所有视图
    view()->composer('*', function ($view) {
        $context = app(CurrentContext::class);
        $view->with([
            'current_site' => $context->getCurrentSite(),
            'current_page' => $context->getCurrentPage(),
        ]);
    });
}

步骤4：在控制器、模型里使用

控制器：通过依赖注入直接获取，非常优雅：

namespace App\Http\Controllers;

use App\Services\CurrentContext;

class PostController extends Controller
{
    public function index(CurrentContext $context)
    {
        $currentSite = $context->getCurrentSite();
        $currentPage = $context->getCurrentPage();

        // 用这些数据做业务逻辑，比如只查询当前站点的文章
        $posts = $currentSite->posts()->paginate();

        return view('posts.index', compact('posts'));
    }
}

模型：通过app()辅助函数获取上下文，比如在模型的方法里用到当前站点：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    public function scopeForCurrentSite($query)
    {
        $currentSite = app(CurrentContext::class)->getCurrentSite();
        return $query->where('site_id', $currentSite->id);
    }
}

为什么这个方案比其他方法好？

避免重复查询：单例绑定确保整个请求周期内只查一次数据库，数据缓存到内存里，不会像静态方法那样每次调用都查（除非你手动加缓存）。
全局可用但可控：不是那种到处乱飞的全局变量，而是通过容器管理的请求级上下文，符合Laravel的依赖注入思想，可测试性极强——测试时你可以绑定一个mock的CurrentContext，不用真的连数据库。
逻辑集中：所有获取上下文的逻辑都在一个类里，后期维护、修改（比如加缓存、调整查询条件）都很方便。
无局限：不像View Composer只能在视图用，这个方法可以在控制器、模型、甚至命令行（如果命令需要的话，只要你处理好没有请求的情况）里使用。

其他可选方案（适合特定场景）

如果你觉得服务容器的方式有点重，也可以试试这两个简化方案：

方案A：改进静态方法，容器缓存结果

你之前想的Page::current()静态方法，可以改成先从容器取，取不到再查询：

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class Page extends Model
{
    public static function current(): self
    {
        // 先检查容器里有没有缓存的实例
        if (app()->has('current_page')) {
            return app('current_page');
        }

        // 没有的话查询并存到容器
        $page = self::where('slug', request()->route('slug'))->firstOrFail();
        app()->instance('current_page', $page);

        return $page;
    }
}

这种方式调用起来更直接（Page::current()），但缺点是逻辑分散在各个模型里，测试时需要模拟请求参数，灵活性不如服务容器方案。

方案B：中间件+视图共享+容器缓存

写一个中间件，在请求早期获取上下文数据，共享到视图同时存到容器：

namespace App\Http\Middleware;

use App\Models\Page;
use App\Models\Site;
use Closure;
use Illuminate\Http\Request;

class LoadCurrentContext
{
    public function handle(Request $request, Closure $next)
    {
        $site = Site::where('slug', $request->route('site_slug'))->firstOrFail();
        $page = Page::where('site_id', $site->id)->where('slug', $request->route('page_slug'))->firstOrFail();

        // 存到容器
        app()->instance('current_site', $site);
        app()->instance('current_page', $page);

        // 共享到视图
        view()->share(['current_site' => $site, 'current_page' => $page]);

        return $next($request);
    }
}

然后把这个中间件加到需要的路由组里。这种方式适合逻辑简单的场景，但逻辑分散在中间件里，不如服务类集中。

总结

如果你追求符合Laravel最佳实践、可维护性强、全局可用，那服务容器+单例的方案绝对是最优解。它既解决了全局变量的需求，又没有hack的感觉，还能让你的代码更整洁、更易测试。

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

Laravel中视图、控制器等适用的全局变量最佳实现方案问询

核心思路：封装上下文到服务类，绑定为单例 #

步骤1：创建上下文服务类 #

步骤2：绑定为容器单例 #

步骤3：共享到所有视图 #

步骤4：在控制器、模型里使用 #

为什么这个方案比其他方法好？ #

其他可选方案（适合特定场景） #

方案A：改进静态方法，容器缓存结果 #

方案B：中间件+视图共享+容器缓存 #

总结 #