Composer 安装 ThinkPHP 时为什么提示 require 失败？
多数人卡在第一步：执行 composer create-project topthink/think 后报错，常见原因是 PHP 版本或扩展不满足要求。ThinkPHP 6.x 要求 PHP >= 7.2 且必须启用 mbstring、openssl、pdo（哪怕你不用数据库），缺一个都会让 composer install 中断并提示“Your requirements could not be resolved”。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
先运行 php -v 和 php -m | grep -E "mbstring|openssl|pdo" 确认环境；Windows 用户若用 XAMPP/MAMP，注意 CLI 使用的 php.ini 和 Web 使用的不是同一个，需单独配置 CLI 的 php.ini；国内用户务必配镜像源，否则 composer create-project 极易超时失败：composer config -g repo.packagist composer https://packagist.phpcomposer.com（或换为阿里云源）。
ThinkPHP 6 的 composer.json 里 autoload 怎么改才不丢类？
手动加模块或迁移旧代码时，常因修改 autoload 导致 App 类找不到、控制器无法加载——根本原因是 ThinkPHP 6 默认用 PSR-4 自动加载，但路径映射写死在框架核心里，你往 "psr-4" 下追加自定义命名空间时，必须严格匹配目录结构，否则 composer dump-autoload 不生效。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
新增模块如 app/common，应在 composer.json 的 "psr-4" 中加："app\common\": "app/common/"（注意双反斜杠转义）；改完必须运行 composer dump-autoload -o（-o 表示优化，否则开发时可能缓存未更新）；别碰 "think\": "thinkphp/src/" 这行，它是框架核心加载路径，改错会导致整个应用启动失败。
升级 ThinkPHP 版本后 composer update 报 Class ‘thinkFacade’ not found
这是 TP6 升级到 TP6.1+ 或跨大版本（如 6.0 → 6.3）时最典型的兼容问题：Facade 类的位置变了，老项目里直接 use thinkFacade 的写法在新版本中已废弃，实际应通过 thinkacadeXXX（小写 facade）引用。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
检查所有 use thinkFacade、use thinkCache 等语句，替换成对应门面类全名，例如 use thinkacadeCache；确认 config/app.php 中的 ‘default_namespace’ => ‘app\’ 没被意外改成空字符串或错误路径；如果用了第三方扩展包（如 topthink/think-queue），必须核对其兼容的 TP 版本号，composer update 时加 –with-dependencies 避免只升主框架而漏掉依赖包。
部署时 vendor 目录太大，能删掉 composer.lock 或开发依赖吗？
不能删 composer.lock，也不能盲目删 require-dev 包。线上环境若用 composer install –no-dev，确实会跳过 require-dev，但 composer.lock 是锁定所有包精确版本的依据，删了它会导致不同机器安装出不同版本，引发隐性 bug（比如某次 composer install 拿到的是 monolog/monolog v2.9.0，下次可能是 v2.10.0，而后者可能悄悄改了日志格式）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
上线前务必保留 composer.lock，并用 composer install –no-dev –optimize-autoloader；vendor 大主要是测试类、文档、冗余文件，可用 composer install –no-dev –optimize-autoloader –classmap-authoritative 减少自动加载开销；真正该精简的是构建流程：CI/CD 中不要把 node_modules、.git、tests/ 打进发布包，这些和 Composer 本身无关，但常被误认为是 “vendor 太大” 的原因。
复杂点在于：Composer 不只是装包工具，它和 ThinkPHP 的自动加载、门面机制、服务容器初始化深度耦合。任何绕过 composer dump-autoload 直接改 vendor/autoload.php 或手写 include 的做法，短期看似快，后期一定会在调试、热更新、Swoole 长连接场景下崩得无声无息。
评论(0)