laravel搭建cms核心是理清数据来源、管理权限与展示逻辑,通过环境配置、认证接入、内容模块开发及前后端联调四步实现;使用breeze快速集成登录注册,artisan生成模型与控制器,eloquent预加载避免n+1,确保已发布内容安全展示。

用 Laravel 搭建一个完整的 CMS,核心不在于堆砌功能,而在于理清“数据怎么来、谁来管、怎么展示”这三件事。它不是从零写所有代码,而是高效组合 Laravel 自带能力(如认证、迁移、资源路由、Blade)与合理设计(模型关联、权限分层、前后端职责分离)。整个过程可以拆解为可验证的几步:环境就绪 → 用户能登录 → 内容能增删改查 → 前端能安全展示。每一步都有明确输出,比如跑通 php artisan migrate 就代表数据库结构落地,注册成功并登录后台就说明认证链路打通。
快速启动开发环境
推荐使用 Laragon(Windows)或 Laravel Sail(macOS/Linux),它们封装了 PHP、Nginx、MySQL 和 Redis,避免手动配置 php.ini 或 host 文件。创建项目只需一条命令:
composer create-project laravel/laravel cms --prefer-dist- 进入项目目录后,运行
php artisan serve启动本地服务,访问http://127.0.0.1:8000确认首页正常 - 配置
.env文件中的数据库连接(DB_DATABASE、DB_USERNAME、DB_PASSWORD),再执行php artisan migrate验证数据库连通性
接入用户认证与基础权限
Laravel 的 laravel/ui 或更现代的 laravel/breeze 可一键生成登录、注册、密码重置页面和对应逻辑。建议优先选 Breeze(基于 Blade + Alpine.js,轻量无前端构建):
composer require laravel/breeze --dev-
php artisan breeze:install(会自动发布视图、路由、控制器) npm install && npm run build- 再次运行
php artisan migrate创建 users 表等 - 打开
/register页面完成首个用户注册,用该账号登录即可进入受保护区域
构建内容管理核心模块
CMS 的骨架是“文章(Post)”和“分类(Category)”。用 Artisan 命令快速生成模型、迁移和资源控制器:
-
php artisan make:model Category -m→ 编辑迁移文件,添加$table->string('name'); -
php artisan make:model Post -m→ 添加字段如title、content、category_id、published_at -
php artisan migrate执行建表 php artisan make:controller Admin/PostController --resource --model=Post- 在
routes/web.php中添加中间件保护:Route::middleware('auth')->prefix('admin')->group(function () { Route::resource('posts', Admin\PostController::class); });
此时访问 /admin/posts(需已登录)就能看到空列表页——说明路由、控制器、认证中间件全部生效。
连接前后端,让内容真正可见
后台能管内容,前台还得把内容“安全地”呈现出来。关键有两点:一是只显示已发布的文章(whereNotNull('published_at')),二是避免 N+1 查询(用 with('category') 预加载):
- 在
PostController@index中返回已发布的文章:Post::with('category')->whereNotNull('published_at')->get(); - 在
resources/views/welcome.blade.php或新建的home.blade.php中循环展示:@foreach($posts as $post) <h3>{{ $post->title }}</h3> <p>{{ $post->category?->name }}</p> @endforeach - 确保
Post和Category模型中已正确定义 Eloquent 关联(belongsTo/hasMany)
刷新首页,看到真实文章标题和分类名,就标志着 CMS 的数据流已全线贯通。











