Composer如何用create-project装框架_Composer框架快速安装方法【入门】

Composer初始化框架项目：为什么必须用create-project，以及如何一次做对

在PHP开发中，用Composer安装框架是第一步，但这一步踩坑的人实在太多了。一个核心结论是：create-project是初始化一个完整、可运行框架项目的唯一可靠方式。它不是什么“可选方案”，而是强制路径。如果你试图用composer require去安装框架核心库（比如lara vel/framework或yiisoft/yii2），结果只会得到一堆孤零零的类文件扔在vendor/目录里——没有入口文件、没有配置文件、也没有命令行工具，项目根本启动不了。

为什么不能用 require 装框架

道理其实很简单：框架不是普通的依赖包。一个框架需要一整套预置的项目结构才能工作，这包括index.php入口文件、config/配置目录、artisan或yii这样的命令脚本，以及路由引导逻辑等等。而require命令的设计初衷只是管理依赖，它只管往vendor/里塞代码，根本不会生成这些骨架文件。

结果就是各种令人头疼的现象：

• 执行 php artisan serve，直接报错 Command "serve" is not defined。
• 访问 http://localhost，返回404，因为Web服务器的根目录指向了一个空的项目根目录，而不是正确的public/或web/子目录。
• 想运行./yii migrate，却发现连vendor/bin/yii这个文件都不存在。

create-project 必加的关键参数

不过，光知道用create-project还不够。如果什么参数都不加，在国内的网络环境下，大概率会卡在下载环节，或者装错版本。要想一次成功，必须组合使用下面这几个关键参数：

• --prefer-dist：强制使用压缩包安装。这比从源码库克隆要快上3到5倍，而且能完美避开Git权限或网络连接问题。
• --no-scripts：跳过安装后的自动脚本（比如php init、php artisan key:generate）。这能防止因为网络超时而导致整个安装过程中断。脚本可以等安装完成后再手动补跑。
• --stability=stable：强制安装稳定版。这对Yii2尤其重要，能避免误拉到dev-master开发分支。国内镜像同步有时滞后，装到开发分支常导致cookieValidationKey缺失、命令找不到等问题。
• --no-interaction：关闭交互式向导。比如Lara vel安装时会问你是否要安装Breeze或Jetstream。在CI/CD或批量部署时，这个参数是必需的。

来看一个Lara vel 11的静默安装示例：composer create-project lara vel/lara vel:^11.0 myapp --no-interaction --no-scripts --prefer-dist

装完必须立刻做的三件事

骨架生成成功，不等于项目就绪了。如果漏掉下面任何一步，后续调试就会充斥着“找不到类”、“密钥未设置”、“权限拒绝”这类让人抓狂的低级报错。

• 复制环境文件：运行 cp .env.example .env（Lara vel），或者进入项目目录后运行 php init（Yii2）。
• 生成应用密钥：运行 php artisan key:generate（Lara vel），或者在运行php init时选择Development模式（Yii2）。
• 设置存储目录权限：执行 chmod -R 775 storage bootstrap/cache（Linux/macOS），否则日志写不进去，缓存也刷新不了。

需要留意的是，像Slim和ThinkPHP的skeleton项目默认已经包含了.env和基础配置，但Lara vel 10+和Yii2仍然需要手动触发初始化。

Web 服务器入口路径最容易错

这是新手最容易栽跟头的地方：所有主流PHP框架都要求Web服务器的根目录（root）指向一个特定的子目录，而不是项目的根目录。可以说，90%的404错误和白屏问题都源于此。

• Lara vel / Slim / ThinkPHP：root 指向 public/。内置服务器启动命令是：php -S localhost:8000 -t public。
• Yii2：root 指向 web/。启动命令需要两步：cd web && php -S localhost:8000 router.php（注意，router.php必须显式指定）。
• 直接把整个项目文件夹拖进XAMPP的htdocs/下面？这肯定会失败。在Apache或Nginx配置里，root路径写错一级，就可能直接暴露.env或app/目录，带来安全风险。

最后给个忠告：在本地开发阶段，不必硬着头皮去配置Nginx。优先使用框架自带的内置服务器命令来验证项目，它能绕过所有Web服务器配置的干扰，直接暴露最本质的问题。