PHP依赖管理工具：Composer

PHP自己有一个叫pecl的代码类库。可以使用工具pear来获取pecl库中的代码。但是现在听说比较难用，于是就诞生了Composer。我就不做太多的介绍了，下面给出一些链接，有兴趣的同学自己可以去看看。有很多别人写好的非常优秀的类库。
英文官网：https://getcomposer.org/
代码库：https://packagist.org/
中文网站：http://www.phpcomposer.com/

Composer的安装

（1）Windows安装Composer
我使用的是XAMPP，在xampp\php的目录下新建一个文件夹取名“composer”，下载composer.phar到此目录。在composer目录新建名为“composer.bat”的命令行文件。添加内容：

@php "%~dp0composer.phar" %*

添加xampp\php目录和xampp\php\composer目录到环境变量中

（2）Mac、Linux安装Composer
对于Mac和Linux而言，把下载到的composer.par文件改名为composer，然后移动到系统的命令目录（对于Mac和Linux而言通常是/usr/local/bin）。
由于Mac自带PHP环境因此就直接可以再teminal里使用composer了，而对于没有自带安装PHP环境的Linux而言就需要安装好PHP环境，并确保在composer的同目录中添加PHP可执行文件的符号链接。

Composer的使用

1. 初始化一个Composer项目

（1）先定位到我项目的根目录：

d:
cd xampp/htdocs/myProject

（2）然后就可以执行composer的命令了：

composer init

2. Composer仓库packagist需要CA证书

Composer使用的是OpenSSl访问了packagegit.org的代码仓库的。所以需要我们提供自己的证书。
我用的是XAMPP，在xampp\perl\vendor\lib\Mozilla\CA目录下有这个证书——cacert.pem。如果没有也可以自己去下载cacert.pem放到自己想放的目录。
然后在php.ini中打开扩展：

extension=php_openssl.dll

最后在php.ini中添加CA证书的路径：

[Mozilla CA]
openssl.cafile= D:\xampp\perl\vendor\lib\Mozilla\CA\cacert.pem

3. 通过composer来管理bower和npm的资源

对于Composer而言，他是一个php类库依赖管理工具。对于bootstrap和jQuery等Css、Javascript库就需要bower和npm来管理。但是我们可以通过给Composer全局（global）安装一个composer asset plugin插件来处理这些前端代码库。命令如下：

composer global require "fxp/composer-asset-plugin:~1.1.1"

Paste_Image.png

composer asset plugin还支持一些自定义的设置，参看 composer asset plugin wiki文档。比如Yii2（我所使用的一个PHP框架）的项目中就使用了Define a custom directory for the assets installation（自定义资源安装目录）这一功能。在默认情况下composer asset plugin插件会把bower和npm的库安装到 'vendor/bower-asset'和 'vendor/npm-asset'目录。通过在composer.json的 "extra"中设置 "asset-installer-paths"可以实现更改安装目录的需求，代码如下：

"extra": {
  "asset-installer-paths": {
    "npm-asset-library": "vendor/npm", 
    "bower-asset-library": "vendor/bower" 
  }
}

在Yii2中使用前端库（Bower and NPM Assets）

大多数 JavaScript、CSS 库通过Bower 和 NPM管理，如果你的应用或扩展使用这些库，推荐你遵循以下步骤来管理库中的资源：
（1）修改应用或扩展的 composer.json文件将库名列入require中，应使用"bower-asset/PackageName"（Bower包）或"npm-asset/PackageName"（NPM包）来对应你所需的前端库。
（2）创建一个资源类并将你的应用或扩展要使用的JavaScript、CSS 文件列入到类中，应设置yii\web\AssetBundle::sourcePath属性为"@bower/PackageName"或 "@npm/PackageName"，因为根据别名Composer会安装Bower或NPM包到对应的目录下。
（3）注意: 一些包会将它们分布式文件放到一个子目录中，对于这种情况，应指定子目录作为yii\web\AssetBundle::sourcePath属性值，例如，yii\web\JqueryAsset使用 "@bower/jquery/dist"而不是 "@bower/jquery"。
（4）Yii2中Bower和NPM中资源的发布默认情况下，当资源被发布的时候，所有在yii\web\AssetBundle::$sourcePath目录下的资源和文件夹都会被发布。当然你也可以通过publishOptions来自定义需要发布的内容。例如，如果只想要发布yii\web\AssetBundle::$sourcePath下面的一个或者几个资源，你可以写如下的类：

 [
      'fonts/',
      'css/',
    ]
  ];
}

以上的例子是定义fontawesome的资源类。通过指定了only选项，只有fonts和css这两个子选项会被发布。

GitHub API rate limit 问题

由于GitHub对不明身份的主机获取代码进行了限制，因此在使用Composer安装或者更新的时候会提示让你输入GitHub的token。
解决办法是：
访问GitHub网站，到Your Profile > Edit Profile > Personal access tokens > Generate new token生成一个token值，复制到Composer的命令行需要输入token的地方即可。如果没有成功的话还可以使用以下命令来单独设置token：

composer config -g github-oauth.github.com your-token

成功后会在C:\Users\Username\AppData\Roaming\Composer（Mac的话是：/Users/Username/.composer）目录下生成一个auth.json文件。这个文件里面就保存了你的GitHub的token。