PHP composer 如何安装依赖

很多新手刚接触PHP项目时，总会遇到一个头疼的问题：网上下载的项目文件里没有“那些乱七八糟的功能代码”，比如生成二维码、连接数据库的快捷工具，明明别人演示时用得好好的，自己打开项目却找不到。其实这不是文件缺失，是项目依赖没装——而安装PHP项目依赖的核心工具，就是Composer。

先搞懂：Composer到底是什么？

很多人刚听到“依赖管理工具”就头大，其实换个生活化的例子就懂：你想做一杯奶茶，不可能从种茶树、养奶牛开始，直接用现成的茶包、奶精、糖包就够了。Composer就是PHP的“奶茶配料管理员”，它专门负责管理项目里需要用的“现成代码包”（比如二维码生成工具、邮件发送工具），帮你自动下载、安装、统一管理，不用你一个个去网上找、手动解压。

简单说：没有Composer，你要给PHP项目加个功能，可能得去GitHub找源码、复制粘贴、改路径，还容易版本冲突；有了Composer，只需要说一句“我要这个功能的包”，它自动搞定所有事。

第一步：先给电脑装Composer

安装Composer很简单，分Windows、Mac、Linux三种系统，每个系统都有一键安装包，不用手动改代码，跟着步骤点就行：

• Windows用户：去Composer官网下Windows安装程序，双击后会自动检测你电脑里的PHP（如果没装PHP，安装包会提醒你先装，别慌，官网也有简单的PHP安装包），全程点“下一步”就好，最后打开命令提示符，输composer -V，出现版本号就说明装成了。
• Mac/Linux用户：打开终端，复制官网的安装命令，一行一行输就行，最后同样输composer -V验证。

这里要注意：必须保证你电脑里装了PHP 5.3以上的版本，不然Composer用不了——就像奶茶店必须先有杯子，不然配料再多也装不了。

第二步：给你的项目装依赖

Composer装依赖的核心是两个文件，不用手动写，大部分项目的源码里会自带这两个文件：

• composer.json：相当于“配料清单”，写清楚这个项目需要哪些包、什么版本。
• composer.lock：安装时自动生成，固定包的版本，保证每个人装的依赖都一样，不会出兼容问题。

装依赖的步骤超简单，举个生活化的例子：你买了一份网红奶茶的预制包，里面有“配料清单”，你只需要把这个预制包放在你要做奶茶的操作台（也就是你的PHP项目文件夹）里，然后操作：

• 打开命令提示符/终端，用cd命令切换到你的项目文件夹（比如cd D:\php\my-project）。
• 在这个文件夹里，直接输composer install，按回车。

这时候Composer就会自动干活：先看composer.json里的清单，去网上下载对应的包，存到项目里的vendor文件夹（就像奶茶店的配料柜），同时生成composer.lock固定版本，整个过程只要等几分钟，全自动，不用你插手。

第三步：遇到小问题怎么查？

新手最容易遇到的问题是“命令输错”，比如把composer install写成composer intall，这时候终端会提示“找不到命令”，检查拼写改过来就行；如果提示“PHP版本不够”，就去升级PHP，或者在composer.json里调整允许的PHP版本（不懂就搜对应包的要求，一般项目的README里会写）。

还有个小技巧：如果想单独装某个新依赖，比如要装生成二维码的包，不用改composer.json，直接输composer require endroid/qr-code，Composer会自动把这个包加到清单里，同时安装，比手动改方便10倍。

其实Composer的核心逻辑就是“让专业的工具干专业的事”，不用再纠结一个个找代码包，只要跟着步骤来，新手也能轻松给PHP项目装上需要的依赖，不用再被“找不到功能”的问题卡壳啦。