简介
Composer 是一个用于 PHP 依赖管理的工具。它实现了让你声明项目所依赖的库,并帮你完成安装 / 更新过程。
依赖管理
Composer 不是像 Yum 或 Apt 一样的包管理器,虽然它会处理『包』或库,但它管理这些包、库是基于项目的,它会安装这些包、库到你项目的一个目录下(一般是在 vendor 文件夹里),默认情况下不会全局地安装。它做为一个包管理器,也支持一个叫做 " global " 的全局命令,我们可以使用此命令来安装全局的包。
这种扩展包的管理方式,不是 Composer 首创或独家专利,其实 Composer 很大程度上有受到 node 的 npm 和 ruby 的 bundler 的启发。
设想:
你有一个项目依赖数个库;
某些库依赖于其他库。
Composer:
使你可以声明你所依赖的库;
找到这些库所提供的和需要安装的版本,并安装它们(即下载到你的项目中)。
参见 基本使用 章节获取更多关于 “依赖声明” 的内容。
系统要求
Composer 要求 PHP 版本在 5.3.2 以上才能运行。还需要对 PHP 做一些设置和编译标志,在安装时会收到所有的不兼容警告。
从源码安装软件替代简单的解压压缩文件,你需要 git,svn,fossil 或者 hg 这取决于软件所用的版本控制工具。
Composer 是多平台的,可以在 Windows,Linux 和 OSX 上良好运行。
安装 - Linux / Unix /macOS
下载 Composer 可执行文件
Composer 提供一个方便的安装器,你可以直接在命令行里直接执行它。免费 下载地址 或者你想知道更多关于这个安装器的信息,这是源码地址 GitHub 。
这是两种简单的安装 Composer 途径,本地安装(单个项目)和全局安装(提供全局的系统命令)。
本地安装
在你的项目文件夹下,运行安装器。 查看说明 安装页面 。
安装器会检查 PHP 配置然后下载 composer.phar 到你的(工作目录)项目文件夹下。 composer.phar 是 Composer 二进制文件。它是一个 PHAR(PHP 归档文件),可以在命令行上运行。
现在运行
php composer.phar
启动 Composer 。
你也可以添加选项 --install-dir 安装 Composer 到指定目录和添加 --filename 来重命名下载后的文件。当使用以下命令运行下载器 :
php composer-setup.php --install-dir=bin --filename=composer
那么你可以运行
php bin/composer
来启动 Composer 。
全局安装
你可以将 composer.phar 文件放在任何地方。如果你把它放到系统的 PATH 中,你就能全局访问它。在类 Unix 系统中,你甚至可以在使用时不加 php 前缀。
在下载之后,运行安装程序,你可以运行以下命令将 composer.phar 文件移动到你的命令目录:
mv composer.phar /usr/local/bin/composer
如果你只想为你的用户安装它并避免需要 root 权限,你可以用 ~/local/bin 代替一些 Linux 发行版的默认目录。
注意:如果以上命令因为权限失败,你需要使用 sudo 再次运行。
注意:某些版本的 OSX /usr 目录默认不存在。如果你收到 /usr/local/bin/composer: No such file or directory 的错误提示,你必须在运行 mkdir -p /usr/local/bin 命令之前手动创建该目录。
注意:关于更改 PATH 环境变量的更多信息,请阅读 Wiki 百科 或者使用 Google 搜索。
现在只需要运行 composer 命令就可以使用 Composer 而不需要输入 php composer.phar。
安装 - Windows
使用安装程序
这是将 Composer 安装在你机器上的最简单的方法。
下载并且运行 Composer-Setup.exe,它将安装最新版本的 Composer ,并设置好系统的环境变量,因此你可以在任何目录下直接使用 composer 命令。
注意: 请关闭当前的终端窗口。 重新打开一个新的终端窗口进行测试使用:这很重要,因为路径只有在终端启动时才会加载。
手动安装
设置系统的环境变量 PATH 并运行安装命令下载 composer.phar 文件:
在 composer.phar 同级目录下新建文件 composer.bat :
C:\bin>echo @php "%~dp0composer.phar" %*>composer.bat
如果路径尚未设置,则将目录添加到 PATH 环境变量中。有关更改路径变量的信息,请参阅 这篇文章 和 / 或使用 Google。
关闭当前的命令行窗口,打开新的命令行窗口进行测试:
C:\Users\username>composer -V
Composer version 1.0.0 2016-01-10 20:34:53
使用 Composer
现在你已经安装了 Composer,你已经准备好使用它了!下面继续进行
Composer 基本使用。