必须使用php 8.0+版本,因thinkphp 8.0依赖联合类型等新语法;需启用mbstring、openssl、fileinfo、pdo_mysql扩展;安装composer并配置阿里云镜像;create-project须在空目录执行且指定当前目录(.),web服务器documentroot必须指向public目录。

php -v 必须输出 ≥ 8.0.0 的版本,否则 composer create-project 会直接失败——不是报错慢,是根本跑不起来。
确认 PHP 8.0+ 已就位且扩展启用
很多卡在第一步的人,其实 php -v 看着有输出,但版本是 7.4 或扩展没开。ThinkPHP 8.0 用到了联合类型(|)、属性升级等 PHP 8.0+ 语法,7.x 运行时直接抛 ParseError。
操作要点:
- 从
windows.php.net下载php-8.0.x-nts-Win32-vs16-x64.zip(NTS 版,x64 架构) - 解压到纯英文路径,如
C:\php8,**严禁中文、空格、C:\根目录** - 把
C:\php8加进系统Path,然后**新开 CMD 再验证**:php -v和php -m | findstr "mbstring openssl fileinfo pdo_mysql" - 编辑
php.ini(复制php.ini-development重命名),确保以下几行已取消注释:extension=mbstring、extension=openssl、extension=fileinfo、extension=pdo_mysql
Composer 安装与国内源加速
Composer 不是可选工具,是 ThinkPHP 8.0 的唯一安装入口。官方包默认走海外源,不换镜像,create-project 可能卡死或超时。
关键动作:
- 下载
Composer-Setup.exe安装,默认选项即可 - 若执行
composer --version报 “找不到指定模块”,大概率缺 VC++ 运行库,去微软官网装Visual C++ Redistributable for Visual Studio 2019 - 立即配置阿里云镜像:
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
用 create-project 拉取项目并设对入口
ThinkPHP 8.0 的入口文件 index.php 在 public/ 目录下,不是项目根目录。很多新手把整个项目当网站根目录,结果访问首页 404 或暴露 app/、config/。
实操步骤:
- 新建空文件夹,如
D:\tp8demo,确保里面**没有任何文件或子目录**(Composer 拒绝往非空目录创建) - 执行:
cd /d D:\tp8demo && composer create-project topthink/think .(注意末尾是英文句点.,不是省略号) - 安装完成后,检查是否存在
D:\tp8demo\public\index.php - 临时验证可用:
php think run,看到Server running on http://127.0.0.1:8000即成功
Web 服务器必须指向 public 目录
内置 php think run 只适合调试。一旦要用 Apache/Nginx/PHPStudy,就必须让 Web 服务器 DocumentRoot 指向 public/,而不是项目根目录。否则 URL 重写失效、静态资源 404、路由全挂。
常见环境处理方式:
-
PHPStudy v8.1:在“网站设置”里把“运行目录”改为
/public(开头带斜杠) -
Apache:虚拟主机
DocumentRoot设为D:/tp8demo/public,且<directory></directory>块中启用AllowOverride All -
Nginx:
root指向D:/tp8demo/public,并启用try_files $uri $uri/ /index.php?$query_string
最容易被忽略的是:改完配置后忘记重启服务,或者没确认 public/.htaccess(Apache)或 nginx.conf(Nginx)是否真正生效——建议先访问 public/index.php 看能否显示欢迎页,再测路由。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











