CakePHP 项目创建失败主因是PHP版本低于8.1或缺失intl、mbstring、xml扩展；应先验证环境，再用composer create-project cakephp/app:^4.4 my_cake_app --no-dev指定版本与目录并跳过dev依赖。
直接用 composer create-project 就能创建标准 CakePHP 项目，但默认命令拉下来的不是最新稳定版，且容易因 PHP 版本或扩展缺失导致安装失败。
为什么 composer create-project cakephp/app 有时会失败
常见现象是卡在 Installing dependencies 或报错 ext-intl not installed、php >= 8.1.0 required。CakePHP 5.x 要求 PHP 8.1+，而很多本地环境仍是 PHP 7.4 或 8.0；另外 intl、mbstring、xml 这三个扩展缺一不可，尤其是 intl 在 macOS 或某些 Linux 发行版里默认不启用。
- 确认 PHP 版本：
php -v，低于 8.1 就别硬试 CakePHP 5 - 检查扩展：
php -m | grep -E "intl|mbstring|xml"，缺哪个就补哪个（如 Ubuntu 上执行sudo apt install php-intl） - 如果只想快速验证，可降级创建 CakePHP 4.4（LTS）：
composer create-project cakephp/app:^4.4
create-project 的关键参数怎么选
默认命令 composer create-project cakephp/app 会装最新稳定版（目前是 5.x），但没指定目录名时会自动创建 app 文件夹，容易和子模块混淆。更稳妥的做法是显式命名并约束版本。
- 指定项目目录：
composer create-project cakephp/app my_cake_app - 锁定 CakePHP 4.4 LTS：
composer create-project cakephp/app:^4.4 my_cake_app - 跳过 dev 依赖（生产环境推荐）：
--no-dev，例如：composer create-project cakephp/app:^4.4 my_cake_app --no-dev - 若网络慢，加
--prefer-dist强制下载压缩包而非 git 克隆
创建后必须立刻做的三件事
项目生成完只是骨架，不配置就跑不起来，尤其数据库和权限问题最常被忽略。
- 改数据库配置：
config/app_local.php里填好'host'、'username'、'password'和'database'，别只改app.php—— 它会被app_local.php覆盖 - 确保
tmp/和logs/可写：chmod -R 777 tmp logs（开发环境够用；生产环境应设为 Web 用户可写） - 运行迁移前先检查连接：
bin/cake.php database_cli，它比直接bin/cake.php migrations migrate更早暴露配置错误
真正麻烦的不是创建动作本身，而是创建后发现 bin/cake.php server 启动不了，或者访问首页报 Missing Datasource config —— 这些都不是 Composer 的问题，而是本地环境与 CakePHP 运行时契约没对齐。多花两分钟查 phpinfo() 里的扩展列表，比反复重装快得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
