Packagist镜像

Packagist 镜像

请各位使用本镜像的同学注意&＃xff1a;

本镜像已经依照 composer 官方的数据源安全策略完全升级并支持 https 协议&＃xff01;请各位同学 按照下面所示的两个方法将 http://packagist.phpcomposer.com 修改为 https://packagist.phpcomposer.com

还没安装 Composer 吗&＃xff1f;请往下看如何安装 Composer 。

用法&＃xff1a;

有两种方式启用本镜像服务&＃xff1a;

• 系统全局配置&＃xff1a; 即将配置信息添加到 Composer 的全局配置文件 config.json 中。见“例1”
• 单个项目配置&＃xff1a; 将配置信息添加到某个项目的 composer.json 文件中。见“例2”

例1&＃xff1a;修改 composer 的全局配置文件&＃xff08;推荐方式&＃xff09;

打开命令行窗口&＃xff08;windows用户&＃xff09;或控制台&＃xff08;Linux、Mac 用户&＃xff09;并执行如下命令&＃xff1a;

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


例2&＃xff1a;修改当前项目的 composer.json 配置文件&＃xff1a;

打开命令行窗口&＃xff08;windows用户&＃xff09;或控制台&＃xff08;Linux、Mac 用户&＃xff09;&＃xff0c;进入你的项目的根目录&＃xff08;也就是 composer.json 文件所在目录&＃xff09;&＃xff0c;执行如下命令&＃xff1a;

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


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

"repositories": {"packagist": {"type": "composer","url": "https://packagist.phpcomposer.com"}
}


以 laravel 项目的 composer.json 配置文件为例&＃xff0c;执行上述命令后如下所示&＃xff08;注意最后几行&＃xff09;&＃xff1a;

{"name": "laravel/laravel","description": "The Laravel Framework.","keywords": ["framework", "laravel"],"license": "MIT","type": "project","require": {"php": ">&＃61;5.5.9","laravel/framework": "5.2.*"},"require-dev": {"fzaninotto/faker": "~1.4","mockery/mockery": "0.9.*","phpunit/phpunit": "~4.0","symfony/css-selector": "2.8.*|3.0.*","symfony/dom-crawler": "2.8.*|3.0.*"},"autoload": {"classmap": ["database"],"psr-4": {"App\\": "app/"}},"autoload-dev": {"classmap": ["tests/TestCase.php"]},"scripts": {"post-root-package-install": ["php -r \"copy(&＃39;.env.example&＃39;, &＃39;.env&＃39;);\""],"post-create-project-cmd": ["php artisan key:generate"],"post-install-cmd": ["php artisan clear-compiled","php artisan optimize"],"pre-update-cmd": ["php artisan clear-compiled"],"post-update-cmd": ["php artisan optimize"]},"config": {"preferred-install": "dist"},"repositories": {"packagist": {"type": "composer","url": "https://packagist.phpcomposer.com"}}
}


OK&＃xff0c;一切搞定&＃xff01;试一下 composer install 来体验飞一般的速度吧&＃xff01;

镜像说明&＃xff1a;

一般情况下&＃xff0c;安装包的数据&＃xff08;主要是 zip 文件&＃xff09;一般是从 github.com 上下载的&＃xff0c;安装包的元数据是从 packagist.org 上下载的。

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

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

 

如何安装 Composer

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

打开命令行并执行下列命令安装最新版本的 Composer (以下指令摘自 https://getcomposer.org/download/ &＃xff0c;请前往查看最新的安装指令)&＃xff1a;

php -r "readfile(&＃39;https://getcomposer.org/installer&＃39;);" > composer-setup.phpphp composer-setup.phpphp -r "unlink(&＃39;composer-setup.php&＃39;);"


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

上述 3 条命令的作用依次是&＃xff1a;

1. 下载安装脚本&＃xff08;composer-setup.php&＃xff09;到当前目录。
2. 执行安装过程。
3. 删除安装脚本 -- composer-setup.php 。

局部安装

上述下载 Composer 的过程正确执行完毕后&＃xff0c;可以将 composer.phar 文件复制到任意目录&＃xff08;比如项目根目录下&＃xff09;&＃xff0c;然后通过 php composer.phar 指令即可使用 Composer 了&＃xff01;

全局安装

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

Mac 或 Linux 系统&＃xff1a;打开命令行窗口并执行如下命令将前面下载的 composer.phar 文件移动到 /usr/local/bin/ 目录下面&＃xff1a;

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


Windows 系统&＃xff1a;

1. 找到并进入 PHP 的安装目录&＃xff08;和你在命令行中执行的 php 指令应该是同一套 PHP&＃xff09;。
2. 将 composer.phar 复制到 PHP 的安装目录下面&＃xff0c;也就是和 php.exe 在同一级目录。
3. 在 PHP 安装目录下新建一个 composer.bat 文件&＃xff0c;并将下列代码保存到此文件中。

&＃64;php "%~dp0composer.phar" %*


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

最后

提示&＃xff1a;不要忘了经常执行 composer selfupdate 以保持 Composer 一直是最新版本哦&＃xff01;