ThinkPHP5安装报错90%源于本地环境不匹配：1.PHP版本需≥7.1（推荐7.4/8.0）并启用pdo、mbstring、curl等扩展；2.目录权限不足或磁盘空间不够导致写入失败；3.国内网络需切阿里云镜像并清缓存；4.项目结构不完整或open_basedir限制引发运行时错误。
直接结论：ThinkPHP5安装命令报错，90%不是框架问题，而是本地环境没对齐——尤其是 PHP 版本、扩展、权限、镜像这四点没调好，composer create-project topthink/think 就会卡在各种 Permission denied、require(): failed to open stream 或 your PHP version does not satisfy that requirement。
PHP 版本和扩展不满足要求
ThinkPHP5.1 要求 PHP ≥ 7.1，5.0 最低也需 PHP 5.6；但实际部署中，用 PHP 7.0 或 7.1 安装常失败，因为部分依赖（如 symfony/var-dumper）已放弃兼容。同时必须启用 pdo、mbstring、curl、openssl 和 json 扩展。
- 运行
php -v确认版本，推荐用 PHP 7.4 或 8.0（TP5 兼容性最稳） - 运行
php -m | grep -E "pdo|mbstring|curl"检查关键扩展是否加载 - 若缺失，编辑
php.ini，取消注释对应行（如extension=mbstring），然后重启 Web 服务 - Windows 下注意
extension_dir路径是否指向正确的ext/目录
Composer 权限或磁盘写入失败
Linux/macOS 下用普通用户执行 composer create-project 时，如果目标目录（如 /var/www/html）属主是 www-data 或 root，就会报 mkdir(): Permission denied；Windows 下则常见因防病毒软件或 OneDrive 同步拦截临时文件写入。
- 不要切
root执行（有安全风险），改用chown -R $USER:$USER ./myproject赋权当前目录 - 避免把项目建在系统保护路径下（如 macOS 的
/Library/WebServer/Documents、Linux 的/var/www），优先选家目录下的~/Sites/tp5这类路径 - 检查磁盘空间：
df -h .，Composer 解压依赖时至少需要 200MB 临时空间 - Windows 用户可临时关闭实时防护，或换用 Git Bash（比 CMD/PowerShell 更稳定）
镜像源失效或缓存损坏
国内直连 packagist.org 极易超时或返回不完整 ZIP，导致 corrupted zip file 或 failed to download package；另外 Composer 本地缓存若损坏，重试仍会复现错误。
立即学习“PHP免费学习笔记（深入）”；
- 设阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 清除全部缓存：
composer clear-cache（不是cache-clear） - 临时跳过缓存安装：
composer create-project topthink/think tp5 --no-cache - 确认网络能通：
curl -I https://mirrors.aliyun.com/composer/packages.json
项目结构不完整导致运行时报错
安装命令看似成功，但访问时抛出 require(.../thinkphp/base.php): failed to open stream，说明核心框架文件没拉下来——常见于 Git 方式克隆未初始化子模块，或压缩包下载不全，或 Composer 安装中途被中断。
- 进项目根目录，检查是否存在
thinkphp/目录及其中的base.php文件 - 若缺失，别手动复制，直接删掉整个目录，重新跑安装命令
- 验证 vendor 是否完整：
ls -la vendor/topthink/应含thinkphp-core包 - 入口文件
public/index.php第 16 行的require __DIR__.'/../thinkphp/base.php';路径不能改，目录结构必须是public/→ 上级为框架根 →thinkphp/平级于application/
最容易被忽略的是：安装成功 ≠ 能运行。很多报错发生在第一次访问时，而非 composer 命令行阶段——比如 open_basedir 限制、伪静态未生效、runtime/ 目录不可写，这些都得等浏览器请求进来才暴露。装完务必立刻检查 runtime/log/ 下是否有当天的错误日志文件。
