ThinkPHP项目搭建完成后如何运行 快速启动教程

最直接的运行方式是用PHP内置服务器快速启动，适合开发调试；若要支持完整路由、伪静态或多个域名访问，则需配置Web服务器虚拟主机。两者目的不同，不能互相替代。

ThinkPHP项目搭好后，最直接的运行方式是用PHP内置服务器快速启动，适合开发调试；若要支持完整路由、伪静态或多个域名访问，则需配置Web服务器（如Apache/Nginx）虚拟主机。两者目的不同，不能互相替代。

用PHP内置服务器三秒启动（仅开发用）

这是最快看到首页的方法，无需安装Apache或Nginx：

• 确保已在项目根目录（不是public目录），执行命令：
  php -S localhost:8000 -t public/
• 注意：-t public/必须带上，否则会报“Failed to open stream”错误
• 浏览器打开 https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774，即可看到欢迎页
• ThinkPHP 6 还支持更简洁的命令：php think run（效果相同，端口默认也是8000）

用Apache配虚拟主机（支持重写、子域名等正式功能）

要让URL干净（如http://tp6.test/index）、支持PATH_INFO、多应用或多域名，必须走这一步：

• 启用Apache的mod_rewrite和vhost_alias模块（修改httpd.conf，取消对应LoadModule行的注释）
• 确认httpd.conf末尾有Include conf/extra/httpd-vhosts.conf（Windows）或类似加载语句
• 在httpd-vhosts.conf中添加一个<VirtualHost>块，DocumentRoot指向你的public目录
• 修改系统hosts文件，加一行：127.0.0.1 tp6.test（保存为UTF-8无BOM）
• 重启Apache服务（不是刷新页面，而是执行httpd -k restart或通过控制面板操作）

用phpStudy等一键环境快速部署（适合新手）

如果你用的是phpStudy、XAMPP这类集成环境，流程更直观：

立即学习“PHP免费学习笔记（深入）”；

• 把ThinkPHP项目整个文件夹（含public）放到WWW目录下（如D:phpstudy_proWWWmyapp）
• 在phpStudy面板中点【网站】→【创建网站】，根目录选到myapppublic，域名填myapp.test
• 同时修改系统hosts文件，添加127.0.0.1 myapp.test
• 确保Apache已启动，然后访问http://myapp.test即可
• 若想隐藏index.php，需确认.htaccess存在且Apache启用了rewrite模块

常见问题提醒

启动失败时优先检查这几项：

• PHP版本是否≥7.2（ThinkPHP 6 推荐 ≥7.4 或 8.x）
• runtime目录是否有写权限（尤其Linux/macOS下）
• 数据库配置文件（config/database.php）是否填对了账号密码和库名
• 如果访问报500错，把config/app.php里的app_debug设为true，看具体错误提示
• 使用内置服务器时，别误进public目录再执行php -S——必须在项目根目录运行