ThinkPHP 8.0轻量级CMS开发实录【练手】

想用 ThinkPHP 8.0 搭一个能真正跑起来的轻量级 CMS 练手，不是只写个首页或模拟后台，而是要让栏目能嵌套、文章能按分类自动匹配模板、URL 能带 .html 后缀且不 404、静态页生成后还能被动态路由兜底——这些卡点不手动填平，项目连首页都加载不全。

初始化项目并确认 PHP 环境

打开命令行，先执行 php -v，必须看到 PHP 8.0+（如 8.2.15），低于此版本 composer 会静默降级安装 ThinkPHP 6，后续所有路由和模型功能都将失效。

若版本不符，不要继续下一步。去 phpEnv 或 XAMPP 控制面板里切换 PHP 版本，再手动把新 PHP 路径（如 D:\phpEnv\php\php-8.2）加到系统环境变量 Path 最前面，删掉旧路径，重启终端。

运行：composer create-project topthink/think tp-cms --no-interaction

进到 tp-cms 目录，检查 vendor/autoload.php 是否真实存在——缺失则执行 composer install 补全依赖，别删项目重装。

配置 CMS 必需的四类核心路由

打开 config/route.php，删除默认的 Route::get('/', ...) 和 Route::get('/hello', ...)，全部替换成以下结构：

前台域名隔离

Route::domain('www', ['middleware' => []]);

栏目页规则（带正则防路径遍历）

Route::rule('category/^[\w-]+$','index/category/index')->ext('html');

文章页通配规则

Route::rule('article/\d+','index/article/read')->ext('html');

静态化兜底（无后缀也能跳）

Route::rule('news/\d+','index/article/read')->redirect('/news/:id.html', 301);

注意：别用 Route::rule('article/:id', ...) 这种裸参数写法，TP8 不再隐式推导控制器，不写完整命名空间会直接 404。

建立栏目与文章模型及关联

执行命令：php think make:model model/Category

在 app/model/Category.php 中补全：use think\Model; class Category extends Model { protected $table = 'cms_category'; }

同理创建文章模型：php think make:model model/Article

在 Article.php 中添加关联方法：public function category() { return $this->belongsTo(Category::class, 'category_id', 'id'); }

这一步漏写 belongsTo，模板里调用 {$article->category->name} 就会报错，N+1 查询问题也会立刻暴露。

实现模板自动匹配逻辑

方法一：重写 View 驱动（推荐）

在 app/common.php 末尾追加：view()->config(['view_path' => app()->getAppPath() . 'view/']);
然后在 app/middleware/ViewMatch.php 中写匹配逻辑：根据请求 URL 解析出 category/news → 自动加载 view/category_news.html。

方法二：中间件拦截（更可控）

新建 app/middleware/TemplateResolver.php，在 handle 方法中解析 request->url()，提取二级路径，拼接为 $template = 'category_' . $path[1];
再调用 View::fetch($template)，避免硬编码模板名。

方法三：控制器内手动指定（仅限调试）

在 index/controller/Category.php 的 index 方法末尾加：return View::fetch('category_' . $name);
但上线前必须切回前两种方式，否则每新增一个栏目都要改控制器。

生成静态 HTML 页面

创建命令行指令：php think make:command BuildStatic

在 app/command/BuildStatic.php 的 execute 方法中，查询所有已发布文章：$articles = Article::where('status', 1)->select();

对每篇文章执行：file_put_contents(public_path() . '/news/' . $article->id . '.html', View::fetch('article_detail', ['article' => $article]));

最后运行：php think build:static，生成的 HTML 文件必须落在 public/news/ 目录下，否则 Nginx/Apache 无法直接响应。