当前位置: 首页 > 文档资料 > Composer 中文文档 >

2.1. 简介

优质
小牛编辑
130浏览
2023-12-01

依赖管理

Composer 不是像 Yum 或 Apt 一样的包管理器,虽然它会处理『包』或库,但它管理这些包、库是基于项目的,它会安装这些包、库到你项目的一个目录下(一般是在 vendor 文件夹里),默认情况下不会全局地安装。它做为一个包管理器,也支持一个叫做 " global " 的全局命令,我们可以使用此命令来安装全局的包。

这种扩展包的管理方式,不是 Composer 首创或独家专利,其实 Composer 很大程度上有受到 node 的 npm 和 ruby 的 bundler 的启发。

设想:

  1. 你有一个项目依赖数个库;
  2. 某些库依赖于其他库。

Composer:

  1. 使你可以声明你所依赖的库;
  2. 找到这些库所提供的和需要安装的版本,并安装它们(即下载到你的项目中)。

参见 基本使用 章节获取更多关于“依赖声明” 的内容。

系统要求

Composer 要求 PHP 版本在5.3.2以上才能运行。还需要对PHP做一些设置和编译标志,在安装时会收到所有的不兼容警告。

从源码安装软件替代简单的解压压缩文件,你需要 git,svn,fossil 或者 hg 这取决于软件所用的版本控制工具。

Composer 是多平台的,可以在 Windows,Linux 和 OSX 上良好运行。

安装 - Linux / Unix / OSX

下载 Composer 可执行文件

Compser 提供一个方便的安装器,你可以直接在命令行里直接执行它。免费 下载地址 或者你想知道更多关于这个安装器的信息,这是源码地址  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,你已经准备好使用它了!下面继续进行下一章的简短演示。