Laravel开发的CMS前端维护模式最优实现方案咨询

针对你的需求，结合缓存+前端路由组专属中间件是性能与可控性兼顾的最优方案，完全适配共享主机环境，且能通过后台面板一键控制。

核心思路 #

1. 用数据库存储维护模式状态（支持后台修改），但通过缓存读取避免重复DB查询，保证性能
2. 仅给前端路由组绑定维护检查中间件，后台路由完全跳过，减少不必要的性能消耗
3. 中间件在请求生命周期早期执行，一旦检测到维护模式直接返回页面，终止后续请求逻辑，最大化性能

具体实现步骤 #

1. 准备存储与缓存逻辑 #

先创建一个settings表存储维护模式状态（也可以用Laravel的settings扩展包，手动建表更轻量）：

CREATE TABLE settings (
    id INT AUTO_INCREMENT PRIMARY KEY,
    key VARCHAR(255) UNIQUE NOT NULL,
    value TEXT,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

2. 创建前端维护模式中间件 #

生成中间件并编写检查逻辑，优先读取缓存，缓存失效时从数据库拉取并重新缓存：

<?php

namespace App\Http\Middleware;

use Closure;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\DB;
use Illuminate\Http\Request;

class FrontendMaintenanceMiddleware
{
    public function handle(Request $request, Closure $next)
    {
        // 管理员直接跳过检查
        if (auth()->check() && auth()->user()->is_admin) {
            return $next($request);
        }

        // 缓存1小时，后台修改时主动清除缓存
        $isMaintenance = Cache::remember('frontend_maintenance_mode', 3600, function () {
            return (bool) DB::table('settings')->where('key', 'frontend_maintenance_mode')->value('value');
        });

        if ($isMaintenance) {
            $message = Cache::remember('frontend_maintenance_message', 3600, function () {
                return DB::table('settings')->where('key', 'frontend_maintenance_message')->value('value') ?? '网站正在维护，请稍后访问';
            });
            // 直接返回维护页面，终止后续请求流程
            return response()->view('frontend.maintenance', ['message' => $message], 503);
        }

        return $next($request);
    }
}

3. 注册并绑定中间件到前端路由组 #

在app/Http/Kernel.php的routeMiddleware数组中注册中间件：

protected $routeMiddleware = [
    // ...其他中间件
    'frontend.maintenance' => \App\Http\Middleware\FrontendMaintenanceMiddleware::class,
];

然后给所有前端路由绑定该中间件：

// routes/web.php
Route::middleware(['frontend.maintenance'])->group(function () {
    // 所有前端路由
    Route::get('/', 'Frontend\HomeController@index');
    Route::get('/article/{id}', 'Frontend\ArticleController@show');
    // ...其他前端路由
});

// 后台路由不绑定该中间件，不受维护模式影响
Route::prefix('admin')->group(function () {
    Route::get('/', 'Admin\DashboardController@index');
    // ...其他后台路由
});

4. 后台添加维护模式控制界面 #

编写后台控制器方法，用于更新维护状态并清除缓存：

<?php

namespace App\Http\Controllers\Admin;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\DB;

class SettingsController extends Controller
{
    public function updateFrontendMaintenance(Request $request)
    {
        $request->validate([
            'frontend_maintenance_mode' => 'boolean',
            'maintenance_message' => 'nullable|string|max:255',
        ]);

        // 更新维护状态
        DB::table('settings')->updateOrInsert(
            ['key' => 'frontend_maintenance_mode'],
            ['value' => $request->frontend_maintenance_mode ? '1' : '0']
        );

        // 更新提示信息
        if ($request->filled('maintenance_message')) {
            DB::table('settings')->updateOrInsert(
                ['key' => 'frontend_maintenance_message'],
                ['value' => $request->maintenance_message]
            );
        }

        // 清除缓存，让新设置立即生效
        Cache::forget('frontend_maintenance_mode');
        Cache::forget('frontend_maintenance_message');

        return back()->with('success', '维护模式设置已更新');
    }
}

后台视图添加开关表单：

<!-- resources/views/admin/settings/maintenance.blade.php -->
<form action="{{ route('admin.settings.maintenance.update') }}" method="POST">
    @csrf
    <div class="form-group">
        <label class="form-label">开启前端维护模式</label>
        <input type="checkbox" name="frontend_maintenance_mode" 
            {{ DB::table('settings')->where('key', 'frontend_maintenance_mode')->value('value') ? 'checked' : '' }}>
    </div>
    <div class="form-group mt-3">
        <label class="form-label">维护提示信息</label>
        <input type="text" class="form-control" name="maintenance_message" 
            value="{{ DB::table('settings')->where('key', 'frontend_maintenance_message')->value('value') }}">
    </div>
    <button type="submit" class="btn btn-primary mt-3">保存设置</button>
</form>

性能优势说明 #

• 缓存优先：99%的请求直接读取缓存，DB查询仅在缓存失效或后台修改后触发，性能接近原生配置读取
• 早期终止请求：中间件在路由解析后立即执行，一旦触发维护模式直接返回页面，不会执行控制器逻辑和视图渲染，资源消耗极低
• 精准作用范围：仅对前端路由生效，后台路由无额外性能开销

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