ThinkPHP项目搭建完成后怎么运行 快速启动教程
ThinkPHP项目运行方式有三种:PHP内置服务器适合开发调试;配置Apache或Nginx虚拟主机支持完整路由、伪静态和多域名,适用于生产环境;使用phpStudy等集成环境对新手友好,降低配置门槛。需重点检查PHP版本、目录权限及数据库配置,避免常见错误。
项目搭好后,最直接的运行方式——用PHP内置服务器快速启动,开发调试再合适不过了。但若要支持完整路由、伪静态或多个域名访问,就需要配置Web服务器虚拟主机。两者目的不同,不能互相替代。

ThinkPHP项目搭建完成后,最直接的运行方式就是用PHP内置服务器快速启动,适合开发调试;若要支持完整路由、伪静态或多个域名访问,则需配置Web服务器(如Apache/Nginx)虚拟主机。两者目的不同,不能互相替代。
用PHP内置服务器三秒启动(仅开发用)
这是最快看到首页的方法,无需安装Apache或Nginx。操作很简单:确保在项目根目录(不是public目录),执行命令:php -S localhost:8000 -t public/。注意,-t public/必须带上,否则会报“Failed to open stream”错误。然后浏览器打开对应地址,即可看到欢迎页。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加载语句。在httpd-vhosts.conf中添加块,DocumentRoot指向你的public目录。修改系统hosts文件,添加一行127.0.0.1 tp6.test,保存为UTF-8无BOM。最后重启Apache服务,可以执行httpd -k restart或通过控制面板操作。
用phpStudy等一键环境快速部署(适合新手)
如果你用的是phpStudy、XAMPP这类集成环境,流程更直观。把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——必须在项目根目录运行


































