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 库通过BowerNPM管理, 如果你的应用或扩展使用这些库,推荐你遵循以下步骤来管理库中的资源:
(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下面的一个或者几个资源,你可以写如下的类:

<?php
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。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 157,198评论 4 359
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,663评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 106,985评论 0 237
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,673评论 0 202
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 51,994评论 3 285
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,399评论 1 211
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,717评论 2 310
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,407评论 0 194
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,112评论 1 239
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,371评论 2 241
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,891评论 1 256
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,255评论 2 250
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,881评论 3 233
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,010评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,764评论 0 192
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,412评论 2 269
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,299评论 2 260

推荐阅读更多精彩内容