必须用composer create-project安装thinkphp 8.0,因它是项目型框架,require仅拉取源码而无骨架目录、.env及post-create-project-cmd钩子,导致public缺失、php think报错;需确保php≥8.1、启用mbstring/openssl/fileinfo等扩展,并设runtime可写。

在macOS上安装ThinkPHP 8.0时,常因PHP扩展缺失(如mbstring、openssl、fileinfo)或runtime目录不可写导致白屏、500错误或php think命令失效,必须逐项验证并修复才能进入开发。
确认系统PHP版本与扩展状态
打开终端,执行php -v,输出必须为PHP 8.1.0或更高版本;若显示8.0.x或更低,说明brew安装的PHP未被优先调用。运行which php确认路径是否为/opt/homebrew/bin/php(Apple Silicon)或/usr/local/bin/php(Intel),否则需修正shell配置文件中的PATH顺序。
执行php -m | grep -E "mbstring|openssl|fileinfo|json|pdo|xml",缺任何一项都必须补装——【fileinfo是TP8启动硬性依赖,缺失会导致autoload失败】。
用Homebrew安装缺失的PHP扩展
macOS不提供独立的php-8.x-xxx扩展包,所有扩展需通过重新编译PHP启用。直接运行:brew reinstall php --with-mbstring --with-openssl --with-fileinfo --with-pdo-mysql(根据你实际数据库选pdo-mysql/pdo-sqlite)。
该命令会触发完整重编译,耗时约3~8分钟,期间不要关闭终端。完成后再次运行php -m验证,确保mbstring、fileinfo、openssl三者全部列出。若仍缺失,检查brew输出末尾是否有Warning: Already linked: /opt/homebrew/Cellar/php/8.3.6类提示——说明已安装但未链接,手动执行brew link php即可。
创建项目并修复权限问题
第一步:进入网站根目录(如~/Sites),执行:composer create-project topthink/think tp8 --stability=stable --prefer-dist --remove-vcs。
第二步:进入项目目录:cd tp8。
第三步:赋予runtime目录完全可写权限:chmod -R 775 runtime。macOS默认禁用group写权限,仅设755会导致日志无法生成、缓存写入失败,【runtime不可写是TP8首页空白最常见原因】。
第四步:启动内置服务器:php think run,访问http://127.0.0.1:8000。若报Class 'think\App' not found,说明vendor/autoload.php未加载,立即检查当前目录是否为tp8根目录(不是tp8/public),且确认ls -l vendor/autoload.php存在且非空。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











