php 配置文件管理工具,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" %*

1

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

2

(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下面的一个或者几个资源，你可以写如下的类：

namespace app\assets;

use yii\web\AssetBundle;

class FontAwesomeAsset extends AssetBundle

{

public $sourcePath = '@bower/font-awesome';

public $css = [

'css/font-awesome.min.css',

];

public $publishOptions = [

'only' => [

'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。