CakePHP 必须通过 composer create-project 安装完整骨架项目，因其依赖特定目录结构、预置路由、中间件及 bin/cake 工具；仅 require cakephp/cakephp 会导致启动失败。
CakePHP 不是靠 composer install 单独装的，而是用 create-project 命令从头拉一个带完整骨架的新项目。
为什么不能直接 composer require cakephp/cakephp
因为 CakePHP 是框架，不是普通库。它依赖特定目录结构（src/、config/、webroot/）、预置路由、基础中间件和命令行工具（bin/cake.php）。只装核心包会导致 bin/cake 找不到、APP_DIR 未定义、请求进不来——启动就报 Class 'Cake\Http\ServerRequest' not found 或 404。
- 官方推荐且唯一可靠的初始化方式是
composer create-project --prefer-dist cakephp/app my_app_name -
cakephp/app是包含全部骨架、默认配置和引导逻辑的 meta 包，cakephp/cakephp只是它的一个子依赖 - 如果已有项目想升级 CakePHP 版本，才用
composer update "cakephp/*"，但前提是项目结构合规
安装时选对版本和 PHP 环境
新版 CakePHP（5.x）要求 PHP ≥ 8.1，而很多老服务器还跑着 PHP 7.4。贸然执行 create-project 可能卡在依赖解析，或装完后 bin/cake server 直接报 ParseError: syntax error, unexpected token "enum"（PHP 7.x 不支持 enum）。
- 查当前 PHP 版本：
php -v；确认是否 ≥ 8.1（CakePHP 5）或 ≥ 7.4（CakePHP 4.4+） - 指定旧版骨架：
composer create-project --prefer-dist cakephp/app:4.4.12 my_app（别用^4.4，避免自动升到不兼容小版本） - 若用 XAMPP/MAMP，注意它们自带的 CLI PHP 和 Web PHP 可能不同版本，
which php和phpinfo()得对得上
bin/cake server 启不动？检查三件事
这是新手最常卡住的地方：命令没报错，但浏览器打不开 http://localhost:8765，或者提示 Connection refused。
- 确保当前目录是项目根目录（含
bin/、config/、webroot/），不是src/或vendor/ - 检查
webroot/是否存在且有index.php；缺失说明骨架拉取失败，删掉重试create-project - 端口被占：默认 8765，可换端口：
bin/cake server -p 8080；Windows 上有时要管理员权限才能绑定端口 - 防火墙/杀软拦截了 PHP CLI 的网络行为（尤其 macOS Monterey+ 或某些国产安全软件）
真正麻烦的不是装不上，而是装完结构不对、环境不匹配、或者误把 CakePHP 当成可插拔组件硬塞进已有项目——它必须从骨架起步，否则后续所有命令、缓存、插件加载都会逐步崩掉。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
