以下安装教程有些可能没在维护了,建议都替换成阿里云的composer镜像地址:阿里云composer地址
------------------------------------------------------------------------------------------
原文:learnku站的composer安装教程与使用
使用Composer
使用 Composer 镜像加速有两种选项:
- 选项一:全局配置,这样所有项目都能惠及(推荐);
- 选项二:单独项目配置;
选项一、全局配置(推荐)
composer config -g repo.packagist composer https://packagist.laravel-china.org
选项二、单独使用
如果仅限当前工程使用镜像,去掉 -g 即可,如下:
composer config repo.packagist composer https://packagist.laravel-china.org
取消镜像
composer config -g --unset repos.packagist
--------------------------------------------------------------------------------------------------------------------------------------
遇到问题
composer
命令后面加上 -vvv (是 3 个 v)可以打印出调错信息,命令如下:
composer -vvv create-project laravel/laravel blog
composer -vvv require psr/log
常见问题
1.已存在 composer.lock 文件,先删除,再运行 composer install
重新生成。
原因:composer.lock 缓存了之前的配置信息,从而导致新的镜像配置无效。
2.使用 laravel new
命令创建工程, 这个命令会从 这里 下一个 zip 包,里面自带了 composer.lock,和上面原因一样,也无法使用镜像加速,解决方法:
- 方法一(推荐):
不使用laravel new
,直接用composer create-project laravel/laravel xxx
新建工程。 - 方法二:
运行laravel new xxx
,当看见屏幕出现 - Installing doctrine/inflector 时,Ctrl + C
终止命令,cd xxx 进入,删除 composer.lock,再运行composer install
。
-------------------------------------------------------------------------------------------------------------------------------------
安装 Composer
Linux/Mac:
wget https://dl.laravel-china.org/composer.phar -O /usr/local/bin/composer
chmod a+x /usr/local/bin/composer
如遇权限不足,可添加 sudo
。
Windows:
1.直接下载 composer.phar,地址:https://dl.laravel-china.org/composer.phar
2.把下载的 composer.phar 放到 PHP 安装目录
3.新建 composer.bat, 添加如下内容,并保存:
@php "%~dp0composer.phar" %*
查看当前版本
composer -V
升级版本
composer selfupdate
注意 selfupdate
升级命令会连接官方服务器,速度很慢。建议直接下载阿里云的 composer.phar
镜像,阿里云composer地址。
--------------------------------------------------------------------------------------------------------------------------------------
原文链接:https://pkg.phpcomposer.com
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
解除镜象:
如果需要解除镜像并恢复到 packagist 官方源,请执行以下命令:
composer config -g --unset repos.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 安装到系统环境变量 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
Composer 升级时是无法利用我们的镜像加速下载的,而必须连接到 Composer 国外官网的服务器上下载升级文件,某些时候就会导致升级的速度非常慢甚至失败。
这里提供一个简单的办法:
如果你的系统中已经有可以正常使用的 Composer 了,说明系统环境是符合要求的,那么只需要下载新的 Composer 文件并覆盖原来的文件即可。
首先你要确定现有的 Composer 的安装目录,然后通过下面的链接下载 composer.phar
文件(复制以下地址到浏览器地址栏可直接下载),
https://install.phpcomposer.com/composer.phar
将前面下载的 composer.phar
文件覆盖系统中已经安装的 composer.phar
文件即可。注意,有可能在安装时将 composer.phar
改名为 composer
了,注意用同样的名字覆盖即可。