必须完成PHP环境搭建、内置服务器配置和路由规则定义三件事,否则会出现404、白屏等问题;需用Composer创建TP6项目并确保入口为public目录;启用php think run启动内置服务器;最后在route/app.php中配置GET路由并创建对应控制器。

想在本地快速启动ThinkPHP项目并让URL地址更简洁、可控,必须完成PHP环境搭建、内置服务器配置和路由规则定义三件事。这三步缺一不可,否则访问时会出现404、白屏或无法识别控制器方法等问题。
安装ThinkPHP并初始化项目
打开终端,切换到Web根目录(如D:\www或/var/www/html),执行命令创建TP6项目:
composer create-project topthink/think tp6
项目名为tp6,完成后进入该目录:cd tp6。注意:不要跳过这一步直接修改public目录——【入口必须是public目录,其他目录不能被Web直接访问】。
立即学习“PHP免费学习笔记(深入)”;
若提示“command not found: composer”,说明未安装Composer,需先下载安装后再重试。
启用本地开发服务器
ThinkPHP 6自带内置服务器,无需Apache/Nginx即可运行:
php think run
终端会输出类似Swoole http server started on http://127.0.0.1:8000的信息。此时浏览器访问http://127.0.0.1:8000,看到欢迎页即表示服务已就绪。
默认端口为8000,如需更换,可在命令后加参数:php think run -p 8080。该服务仅限本地开发,不可用于生产环境。
配置路由规则
路由文件位于route/app.php,打开后可见默认示例代码。以下操作按顺序进行:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
① 打开config/app.php,确认'with_route' => true(默认已开启);
② 编辑route/app.php,添加一条GET路由:
Route::get('user/:id', 'index/User/read');
③ 在app/controller下新建User.php,写入基础控制器:
④ 保存后访问http://127.0.0.1:8000/user/123,页面应显示“用户ID:123”。若报错“非法请求”,检查是否误用了非GET方式提交,或路由未生效——【修改路由后必须重启内置服务器】。
开启强制路由(可选但推荐)
强制路由能屏蔽未定义的URL访问,提升安全性:
编辑config/route.php,将'url_route_must' => false改为true。
此时再访问http://127.0.0.1:8000/index/hello这类默认URL会直接返回404,只有显式定义过的路由才可访问。
开启后务必为首页定义路由,例如在route/app.php中添加:Route::get('/', 'index/Index/index');


















