github-actions-creator/docs/php.md

PHP (Laravel) 项目：内容管理系统 (CMS)

概述

使用 PHP 和 Laravel 构建一个功能齐全的 CMS，支持多角色用户、文章、页面管理和媒体库。

功能需求

1. 后台管理 (Admin)

• 仪表盘: GET /admin/dashboard - 显示网站统计信息。
• 用户管理: GET, POST, PUT, DELETE /admin/users - 管理用户及角色（Admin, Editor, Author）。
• 角色权限管理: (可选) GET, POST /admin/roles - 定义角色权限。

2. 内容管理

• 文章管理: GET, POST, PUT, DELETE /admin/posts - 使用富文本编辑器创建/编辑文章，支持分类、标签、特色图片和发布状态。作者/编辑有权限限制。
• 页面管理: GET, POST, PUT, DELETE /admin/pages - 管理“关于我们”等静态页面。
• 媒体库: GET /admin/media - 网格化显示和上传媒体文件，支持从编辑器调用。

3. 前台显示

• 首页: GET / - 显示最新文章列表。
• 详情页: GET /blog/{slug} - 显示单篇文章。
• 静态页: GET /{slug} - 显示静态页面。
• 分类/标签页: GET /category/{slug}, GET /tag/{slug} - 显示该分类/标签下的文章。

技术栈

• 语言: PHP 8.1+
• 框架: Laravel 10.x
• 数据库: MySQL 或 PostgreSQL
• 前端: Blade + Bootstrap 5 / Tailwind CSS
• 认证: Laravel Breeze
• 授权: Laravel Gates & Policies

项目结构

/laravel-cms
├── app/
│   ├── Http/Controllers/ # Admin/ & Front/ 控制器
│   ├── Models/           # Eloquent 模型 (User, Post, Page, etc.)
│   └── Policies/         # 授权策略
├── database/             # Migrations, Factories, Seeders
├── resources/views/      # Blade 视图 (admin/, front/, layouts/)
├── routes/web.php        # 路由定义
└── composer.json

任务步骤

1. 初始化: 创建 Laravel 项目并安装 Laravel Breeze。
2. 数据库: 创建 posts, pages, categories 等迁移，并定义模型关系。
3. 模型与工厂: 创建 Eloquent 模型及对应的 Factory。
4. 路由: 在 web.php 中使用路由组和中间件组织后台 (/admin) 和前台路由。
5. 后台开发: 创建后台管理的控制器和 Blade 视图。
6. 授权: 使用 Policies 控制用户对文章等资源的 CUD 权限。
7. 前台开发: 创建用于展示文章和页面的控制器和视图。
8. 富文本集成: 在编辑视图中集成 JS 富文本编辑器。
9. 数据填充: 创建 Seeder 填充初始数据（如管理员用户）。
10. 测试: 使用 Pest 或 PHPUnit 编写 Feature 和 Unit 测试。

先行任务: 设计数据库 ER 图和后台管理界面的线框图。