composer是cakephp的基础设施，负责依赖、插件、自动加载与版本锁定；必须用composer create-project初始化项目，禁用zip下载或空目录install；插件需composer require安装并addplugin注册；update须精确控制，避免跨大版本升级。
Composer 不是“配合” CakePHP，而是 CakePHP 的基础设施——所有依赖、插件、自动加载、版本锁定都由它驱动；脱离 Composer 运行 CakePHP 项目等于手动拼装引擎还指望车能跑。
composer create-project 是唯一推荐的初始化方式
别下载 ZIP、别 clone 仓库、别在空目录里 run composer install——这些操作会跳过骨架初始化逻辑，导致 src/Application.php 缺失、webroot/index.php 路径常量错位、bin/cake 不可执行等问题。
- 正确命令：
composer create-project cakephp/app:^5.1 my_app（PHP 8.1+）或composer create-project cakephp/app:^4.4 my_app（PHP 7.4–8.0） - 加
--prefer-dist强制走压缩包，比--prefer-source更快更干净 - 国内慢？先切阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 运行后立刻检查：
tmp/和logs/是否可写（Linux/macOS 执行chmod -R 775 tmp logs）
添加插件必须用 composer require，不是复制粘贴
插件不是扔进 plugins/ 目录就生效的静态资源，而是通过 Composer 注册自动加载路径 + CakePHP 运行时注册生命周期的双阶段组件。
- 安装 DebugKit：
composer require cakephp/debug_kit（注意下划线，不是debugkit或cakephp/debugkit） - 启用插件：
bin/cake plugin load DebugKit（自动生成config/bootstrap.php注册语句） - 如果插件命令不识别，先确认是否已调用
$this->addPlugin('DebugKit')（大小写敏感），再运行composer dump-autoload -o - 私有 GitHub 插件？必须在根
composer.json的repositories字段显式声明源地址，否则composer require找不到
composer update 要精确控制，不能无脑全升
composer update 默认重算整个依赖图，极易把 cakephp/cakephp 从 4.4.x 升到 5.0.x，而 CakePHP 5 要求 PHP 8.1+ 且废弃了大量 4.x API（如 Table::find('all') 返回类型变更、Query::select() 参数校验变严）。
- 只更新框架主包：
composer update cakephp/cakephp - 锁死主版本（推荐）：
"cakephp/cakephp": "^4.4"（不是"^4"），避免意外跨大版本 - 升级前查阻塞原因：
composer why-not cakephp/cakephp:5.1.0 - 生产环境更新插件时加
--with-all-dependencies，否则可能漏掉关键补丁依赖
APP_NAME、ROOT 和命名空间必须严格一致
很多“白屏”、“Class 'App\Application' not found”、“bin/cake 命令报错”都源于这三者脱节——它们不是配置项，而是硬编码在启动链路里的常量和类名。
-
webroot/index.php开头的define('ROOT', dirname(__DIR__));必须指向含src/和config/的目录，不是webroot自身 -
src/Application.php的命名空间必须为App，类名必须为Application，文件名大小写完全匹配（Linux 下application.php≠Application.php） - 若改过
config/app_local.php中的'namespace' => 'MyApp'，就必须同步改类名、命名空间、APP_NAME常量，以及所有use MyApp\...引用 - 修改后务必运行
composer dump-autoload -o刷新自动加载映射
最常被忽略的其实是权限和 PHP 版本——Composer 不会在终端明确告诉你 “tmp/logs 不可写”，也不会拦住你在 PHP 8.0 上硬装 CakePHP 5；它只是静默失败，然后留给你一个空白页面或 500 错误。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
