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

项目搭好后，最直接的运行方式——用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——必须在项目根目录运行