Homebrew安装php@8.2是Mac上运行ThinkPHP 6+最稳选择,需执行brew link --force php@8.2并source ~/.zshrc使PATH生效;手动启用pdo.so和mbstring.so扩展;重装Homebrew版Composer确保php -v与composer --version版本一致。

装对版本,别碰系统PHP
Mac 自带的 PHP(比如 7.3 或更老)已停更、缺扩展、不兼容 ThinkPHP 6+。Homebrew 安装的 php@8.2 是当前最稳选择——它被主流框架广泛验证,扩展支持完整,Xdebug 和 Composer 兼容性好。运行:
brew install php@8.2-
brew link --force php@8.2(这步必须,否则php -v仍显示系统旧版) -
source ~/.zshrc(确保 shell 加载了 Homebrew 路径)
验证:which php 应输出 /opt/homebrew/bin/php,php -v 显示 PHP 8.2.x。
启用 ThinkPHP 硬依赖扩展
ThinkPHP 6+ 启动即报 Class 'PDO' not found?不是代码问题,是 Homebrew 的 php@8.2 默认不启用任何扩展。需手动打开:
- 查配置位置:
php --ini→ 记下 “Loaded Configuration File” 路径(通常是/opt/homebrew/etc/php/8.2/php.ini) - 编辑该文件,取消注释两行:
extension=pdo.soextension=mbstring.so - 保存后重启终端,再执行
php -m | grep -E "pdo|mbstring"确认已加载
让 Composer 绑定你装的 PHP
运行 composer install 却提示 vendor/autoload.php not found?大概率是 Composer 在调用 /usr/bin/php(系统旧版),而非你刚装的 php@8.2。
- 检查:
which composer;若输出/usr/bin/composer,说明是系统旧版,删掉:sudo rm /usr/bin/composer - 重装 Homebrew 版:
brew uninstall composer && brew install composer - 验证一致性:
php -v和composer --version输出的 PHP 版本号应完全一致
项目级隔离,避免全局误切
不同 ThinkPHP 项目可能要求不同 PHP 版本(如老项目锁死 8.1,新项目用 8.3)。全局 brew link 切换容易串扰。推荐在项目根目录建 bin/php:
- 创建文件:
echo '#!/bin/sh\nexec /opt/homebrew/opt/php@8.1/bin/php "$@"' > bin/php - 赋权:
chmod +x bin/php - 后续命令统一用:
./bin/php think serve或./bin/php -S 127.0.0.1:8000 -t public/ - 这样既不污染 shell,又保证每个项目用自己指定的 PHP 版本和配置
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











