使用 Composer 管理依赖库
###########################

简介
==========

Composer 是 PHP 的一个依赖管理工具。Composer 的优点在于让您仅需要提供一个 **composer.json** 文件，申明需要用到的依赖库，然后一个简单的命令就能将其依赖全部装好，方便了应用的部署和发布，告别手工下载管理的麻烦。

安装
===========

Linux
-------------

你可以执行下面这些命令在你的系统中安装 Composer 。

.. code-block:: console

    $ curl -sS https://getcomposer.org/installer | php
    $ mv composer.phar /usr/local/bin/composer

.. note:: 如果上述命令因为权限执行失败， 请使用 sudo 再次尝试运行 mv 那行命令。

Windows
------------

下载并且运行 `Composer-Setup.exe <https://getcomposer.org/Composer-Setup.exe>`_ ，它将安装最新版本的 Composer ，并设置好系统的环境变量，因此你可以在任何目录下直接使用 composer 命令。

使用
===========

安装完之后，Composer 会在系统中添加一个 composer 命令，该命令是 Composer 所有管理功能的入口。

您可以直接使用 ``composer require`` 命令来安装第三方库并将依赖添加到 **composer.json** 描述文件里。

.. code-block:: console

    $ composer require monolog/monolog

Composer 会将所有的依赖包安装到应用的 **vendor** 目录下，除了库的下载，Composer 还准备了一个自动加载文件，它可以加载 Composer 下载的库中所有的类文件。使用它，你只需要将下面这行代码添加到你应用的引导文件中就可以使用这些库了。

.. code-block:: php

    require 'vendor/autoload.php';

另外，你可以在 https://packagist.org/ 搜索你想要的库，使用 Composer 来安装。

更多更详细的使用请参见： `Composer 中文文档 <http://docs.phpcomposer.com/>`_ 。

.. note:: 如果想要加快依赖包的安装速度，可以参照 http://pkg.phpcomposer.com/ 这里的说明修改镜像地址到国内镜像。