必须先确保php≥8.0、composer可用、路径无中文空格,否则环境启动失败;需验证php -v版本、启用mbstring/openssl等扩展、用composer create-project创建项目,并执行php think run启动内置服务器访问欢迎页。

想用ThinkPHP 8.0写第一个控制器返回“Hello World”,却卡在环境启动失败、php think run报错、浏览器打不开欢迎页——这不是你水平问题,是环境没配对。必须满足PHP ≥ 8.0、Composer可用、路径无中文空格,缺一不可,否则后续所有代码都运行不起来。
确认并安装PHP 8.0+
打开命令行,执行 php -v。如果提示“不是内部或外部命令”,说明PHP未安装或未加入系统PATH;如果版本低于8.0.0,必须升级。
Windows用户直接去 windows.php.net/download/ 下载 php-8.0.x-nts-Win32-vs16-x64.zip(NTS版,x64架构),解压到 C:\php8 这类纯英文无空格路径。
将 C:\php8 添加进系统环境变量PATH,然后务必新开一个命令行窗口再执行 php -v 验证——旧窗口不会自动加载新PATH。
编辑 C:\php8\php.ini(把 php.ini-development 复制重命名),取消以下四行前的分号:
extension=mbstring
extension=openssl
extension=pdo_mysql
extension=fileinfo
保存后重启命令行,运行 php -m | findstr "mbstring openssl" 确认扩展已加载。
安装并配置Composer
访问 getcomposer.org/Composer-Setup.exe 下载安装程序,全程默认选项即可。
安装完成后,在命令行输入 composer --version。若报错“找不到指定模块”,大概率是VC++运行库缺失,去微软官网下载安装 Visual C++ Redistributable for Visual Studio 2019。
为加速国内依赖下载,立即执行:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
创建ThinkPHP 8项目
新建一个纯英文路径文件夹,例如 D:\tp8demo,确保该目录下没有任何文件或子文件夹——Composer不允许往非空目录创建项目。
进入该目录:cd /d D:\tp8demo
执行创建命令:composer create-project topthink/think .
注意末尾的英文句点 .,表示当前目录,不是省略号。
等待安装完成(通常1–3分钟),你会看到 vendor/、app/、public/ 等目录生成。此时项目骨架已就绪。
启动内置服务器并验证
在项目根目录(即含 think 文件的目录)下,执行:php think run
看到输出类似 Server running on https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a 即表示启动成功。
打开浏览器,访问 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a。如果页面显示 ThinkPHP 的蓝色欢迎页,且右下角写着 “ThinkPHP v8.x.x”,说明开发环境已完全跑通。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











