Composer安裝和使用

原文:https://www.fanhaobai.com/2017/05/composer.html

Composer 是一個 PHP 依賴包管理工具,我們通過在 composer.json 配置中申明項目依賴后,它會自動在的項目中安裝完成項目所需依賴。一些常用的項目依賴包列表,見這里。

安裝

下載并安裝

這里在 Linux 環境下全局安裝 Composer。

$ wget https://getcomposer.org/installer
$ php installer --install-dir=/usr/local/bin --filename=composer

如果出現如下錯誤,可以在php installer命令后追加--disable-tls參數。

The "https://getcomposer.org/download/1.4.1/composer.phar.sig" file could not be downloaded: SSL: Connection reset by peer
# 或者
Failed to decode zlib stream

安裝完成后,查看 Composer 版本信息。

$ composer --version
Composer version 1.4.1 2017-03-10 09:29:45

切換中國鏡像

由于國外鏡像存在被墻的問題,所以這里將 Composer 鏡像切換為 中國鏡像

$ composer config -g repo.packagist composer https://packagist.phpcomposer.com

命令

常用命令:

require         # 添加包到composer.json并安裝
update          # 更新composer.json中的包至最新版本,并更新composer.lock文件
remove          # 刪除包及其依賴
create-project  # 創建一個項目并安裝依賴
dump-autoload   # 自動加載
init            # 創建composer.json
install         # 從composer.lock安裝項目的依賴包
config          # 設置配置信息
search          # 查找一個包
self-update     # 更新composer至最新版本
show            # 查看包信息
status          # 查看本地修改的包
validate        # 校驗composer.json和composer.lock

還有一些較少使用的命令,這里不一一列出。

搭建私有倉庫

私有倉庫是團隊開發項目中不可或缺的,這里使用 Satis 來實現這一需求。

下載安裝

這里通過 Composer 方式拉取 Satis 源碼。

$ cd /home/www     # $path
$ composer create-project composer/satis:dev-master --keep-vcs

安裝后的默認目錄名為 /$path/satis。

配置

修改satis.json文件,在這里列舉出倉庫所有包的托管倉庫地址,以 GitHub 上的開源 MongoDB 地址為例,講述配置詳情。

$ cd satis/
$ vim satis.json

內容如下所示:

{
  "name": "Fhb Repository",      //名稱
  "homepage": "http://packagist.fanhaobai.com",  //satis倉庫地址
  "repositories": [             //所有包托管倉庫地址
    {
      "type": "vcs",          //倉庫類型,github|gitlab為vcs
      "url": "git@github.com:fan-haobai/yii2-mongodb.git"  //MongoDB倉庫地址
    },
    ... ...                     //其他需要索引的倉庫地址
  ],
  "require-all": true           //獲取全網所有鏡像,建議不這樣設置
  "archive": {
    "directory": "dist",
    "format": "tar",
    "skip-dev": true
  }
}

需要說明的是,如果包托管倉庫也是采用開源版本管理系統搭建,那么這里require-all可以設置為 true。否則,建議只列舉出需要索引的包名稱以及版本號,因為設置為 true 會掃描全網所有包地址。例如倉庫地址設為 GitHub,那么掃描的全網包數量巨大,非常耗時。所以在本例中修改為如下:

... ....
"require": {
  "yiisoft/yii2-mongodb": "^2.1.0"
}
... ...

運行

$ php bin/satis build satis.json /home/www/packagist -v

-v表示顯示出索引詳細。/home/www/packagist目錄為生成的倉庫目錄,Nginx 配置站點目錄指向此處,即packagist.fanhaobai.com指向此處。因為后續更新包索引也需要運行該命令,所以將該命令寫為build.sh

如果看到Installing xxx/xxx Downloading: 100% ...信息,就說明索引成功,訪問 站點 即可。

{% asset_img bb8a-6ddaa3977.png %}

發布包

這里將 Satis 作為 Composer 包私有倉庫,以 GitHub 作為包代碼托管倉庫,列出大致的包發布流程:

  1. 先將需要發布的包發布到代碼管理倉庫,例如 GitHub;

直接 fork 阿里云 OSS 官方 SDK 封裝,地址為:git@github.com:fan-haobai/yii2-aliyun-oss.git,并打一個 V1.0.0 版本的標簽,這樣 Satis 默認可以將 tag 名稱作為包版本號。

  1. 在配置文件satis.json中增加包倉庫地址,以及索引版本;
"repositories": [
  ... ...
  {
    "type": "vcs",
    "url": "git@github.com:fan-haobai/yii2-aliyun-oss.git"
  }
  ... ...
"require": {
  ... ...
  "chonder/yii2-aliyun-oss": "^1.0.0"    #包composer.json中的name
  ... ...
}
  1. 執行build.sh腳本更新索引;

出現以下內容即為包索引更新成功。

Installing chonder/yii2-aliyun-oss (V1.0.0) Downloading: 100% Extracting archive

安裝包

切換包倉庫地址

需要安裝 Satis 索引的 Composer 包,只需在項目的composer.json文件中將 repositories 配置為 Satis 倉庫地址即可。

{
  "config": {
    "process-timeout": 1800,
    "secure-http": false
  },
  "repositories": [{
    "type": "composer",
    "url": "http://packagist.fanhaobai.com"
  }]
}

config 項用于設置超時時間和 https,如果 Satis 站點是 http 協議,則將secure-http設置為 false。

安裝包

在項目的composer.josn同目錄下,運行:

$ composer require chonder/yii2-aliyun-oss:^1.0.0

出現如下信息則安裝包成功。

Package operations: 1 install, 0 updates, 0 removals       
  - Installing chonder/yii2-aliyun-oss (V1.0.0): Downloading (100%)
Writing lock file
Generating autoload files
最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,698評論 6 539
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 99,202評論 3 426
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,742評論 0 382
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,580評論 1 316
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 72,297評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,688評論 1 327
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,693評論 3 444
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,875評論 0 289
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 49,438評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 41,183評論 3 356
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 43,384評論 1 372
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,931評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,612評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,022評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,297評論 1 292
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 52,093評論 3 397
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 48,330評論 2 377

推薦閱讀更多精彩內容