学习网站

Composer 中文网

资源包 Packagist

Packagist / Composer 中国全量镜像

如何安装 Composer

下载 Composer

安装前请务必确保已经正确安装了PHP。打开命令行窗口并执行php -v查看是否正确输出版本号。

打开命令行并依次执行下列命令安装最新版本的 Composer：

php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"

php composer-setup.php

php -r "unlink('composer-setup.php');"

执行第一条命令下载下来的composer-setup.php脚本将简单地检测php.ini中的参数设置，如果某些参数未正确设置则会给出警告；然后下载最新版本的composer.phar文件到当前目录。

上述 3 条命令的作用依次是：

下载安装脚本 －composer-setup.php－ 到当前目录。

执行安装过程。

删除安装脚本。

局部安装

上述下载 Composer 的过程正确执行完毕后，可以将composer.phar文件复制到任意目录（比如项目根目录下），然后通过php composer.phar指令即可使用 Composer 了！

全局安装

全局安装是将 Composer 安装到系统环境变量PATH所包含的路径下面，然后就能够在命令行窗口中直接执行composer命令了。

Mac 或 Linux 系统：

打开命令行窗口并执行如下命令将前面下载的composer.phar文件移动到/usr/local/bin/目录下面：

sudo mv composer.phar /usr/local/bin/composer

Windows 系统：

找到并进入 PHP 的安装目录（和你在命令行中执行的php指令应该是同一套 PHP）。

将composer.phar复制到 PHP 的安装目录下面，也就是和php.exe在同一级目录。

在 PHP 安装目录下新建一个composer.bat文件，并将下列代码保存到此文件中。

@php "%~dp0composer.phar" %*

最后重新打开一个命令行窗口试一试执行composer --version看看是否正确输出版本号。

最后

提示：不要忘了经常执行 composer selfupdate 以保持 Composer 一直是最新版本哦！

Packagist 镜像使用方法

有两种方式启用本镜像服务：

系统全局配置：即将配置信息添加到 Composer 的全局配置文件config.json中。见“方法一”

单个项目配置：将配置信息添加到某个项目的composer.json文件中。见“方法二”

方法一：修改 composer 的全局配置文件（推荐方式）

打开命令行窗口（windows用户）或控制台（Linux、Mac 用户）并执行如下命令：

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

方法二：修改当前项目的composer.json配置文件：

打开命令行窗口（windows用户）或控制台（Linux、Mac 用户），进入你的项目的根目录（也就是composer.json文件所在目录），执行如下命令：

composer config repo.packagist composer https://packagist.phpcomposer.com

上述命令将会在当前项目中的composer.json文件的末尾自动添加镜像的配置信息（你也可以自己手工添加）：

"repositories": {

"packagist": {

"type": "composer",

"url": "https://packagist.phpcomposer.com"

}

}

以 laravel 项目的composer.json配置文件为例，执行上述命令后如下所示（注意最后几行）：

{

"name": "laravel/laravel",

"description": "The Laravel Framework.",

"keywords": ["framework", "laravel"],

"license": "MIT",

"type": "project",

"require": {

"php": ">=5.5.9",

laravel/framework": "5.2.*"

},

"config": {

"preferred-install": "dist"

},

"repositories": {

"packagist": {

"type": "composer",

"url": "https://packagist.phpcomposer.com"

}

}

}

OK，一切搞定！试一下composer install来体验飞一般的速度吧！

镜像原理：

一般情况下，安装包的数据（主要是 zip 文件）一般是从github.com上下载的，安装包的元数据是从packagist.org上下载的。

然而，由于众所周知的原因，国外的网站连接速度很慢，并且随时可能被“墙”甚至“不存在”。

“Packagist 中国全量镜像”所做的就是缓存所有安装包和元数据到国内的机房并通过国内的 CDN 进行加速，这样就不必再去向国外的网站发起请求，从而达到加速composer install以及composer update的过程，并且更加快速、稳定。因此，即使packagist.org、github.com发生故障（主要是连接速度太慢和被墙），你仍然可以下载、更新安装包。