update
This commit is contained in:
成武
parent
8c49b942fe
commit
f76612ea1b
|
|
@ -7,17 +7,17 @@ Composer 是 PHP 的一个依赖管理工具。它允许你申明项目所依赖
|
|||
|
||||
- [简介](#Introduction)
|
||||
- [依赖管理](#Dependency-management)
|
||||
- [声明依赖关系](#Declaring dependencies)
|
||||
- [系统要求](#System Requirements)
|
||||
- [安装 - *nix](#Installation - *nix)
|
||||
- [下载 Composer 的可执行文件](#Downloading the Composer Executable)
|
||||
- [声明依赖关系](#Declaring-dependencies)
|
||||
- [系统要求](#System-Requirements)
|
||||
- [安装 - *nix](#Installation-*nix)
|
||||
- [下载 Composer 的可执行文件](#Downloading-the-Composer-Executable)
|
||||
- [局部安装](#Locally)
|
||||
- [全局安装](#Globally)
|
||||
- [全局安装 (on OSX via homebrew)](#Globally on OSX via homebrew)
|
||||
- [安装 - Windows](#Installation - Windows)
|
||||
- [使用安装程序](#Using the Installer)
|
||||
- [手动安装](#Manual Installation)
|
||||
- [使用 Composer](#Using Composer)
|
||||
- [全局安装 (on OSX via homebrew)](#Globally-on-OSX-via-homebrew)
|
||||
- [安装 - Windows](#Installation-Windows)
|
||||
- [使用安装程序](#Using-the-Installer)
|
||||
- [手动安装](#Manual-Installation)
|
||||
- [使用 Composer](#Using-Composer)
|
||||
- [自动加载](#Autoloading)
|
||||
|
||||
---
|
||||
|
|
@ -40,7 +40,7 @@ c) 你声明你所依赖的东西。
|
|||
|
||||
d) Composer 会找出哪个版本的包需要安装，并安装它们（将它们下载到你的项目中）。
|
||||
|
||||
<a name="Declaring dependencies"></a>
|
||||
<a name="Declaring-dependencies"></a>
|
||||
## 声明依赖关系
|
||||
|
||||
比方说，你正在创建一个项目，你需要一个库来做日志记录。你决定使用 [monolog](https://github.com/Seldaek/monolog)。为了将它添加到你的项目中，你所需要做的就是创建一个 `composer.json` 文件，其中描述了项目的依赖关系。
|
||||
|
|
@ -53,7 +53,7 @@ d) Composer 会找出哪个版本的包需要安装，并安装它们（将它
|
|||
|
||||
我们只要指出我们的项目需要一些 `monolog/monolog` 的包，从 `1.2` 开始的任何版本。
|
||||
|
||||
<a name="System Requirements"></a>
|
||||
<a name="System-Requirements"></a>
|
||||
## 系统要求
|
||||
|
||||
运行 Composer 需要 PHP 5.3.2+ 以上版本。一些敏感的 PHP 设置和编译标志也是必须的，但对于任何不兼容项安装程序都会抛出警告。
|
||||
|
|
@ -62,10 +62,10 @@ d) Composer 会找出哪个版本的包需要安装，并安装它们（将它
|
|||
|
||||
Composer 是多平台的，我们努力使它在 Windows 、 Linux 以及 OSX 平台上运行的同样出色。
|
||||
|
||||
<a name="Installation - *nix"></a>
|
||||
<a name="Installation-*nix"></a>
|
||||
## 安装 - *nix
|
||||
|
||||
<a name="Downloading the Composer Executable"></a>
|
||||
<a name="Downloading-the-Composer-Executable"></a>
|
||||
### 下载 Composer 的可执行文件
|
||||
|
||||
<a name="Locally"></a>
|
||||
|
|
@ -96,7 +96,7 @@ Composer 是多平台的，我们努力使它在 Windows 、 Linux 以及 OSX
|
|||
|
||||
现在只需要运行 `composer` 命令就可以使用 Composer 而不需要输入 `php composer.phar`。
|
||||
|
||||
<a name="Globally on OSX via homebrew"></a>
|
||||
<a name="Globally-on-OSX-via-homebrew"></a>
|
||||
#### 全局安装 (on OSX via homebrew)
|
||||
|
||||
Composer 是 homebrew-php 项目的一部分。
|
||||
|
|
@ -108,17 +108,17 @@ Composer 是 homebrew-php 项目的一部分。
|
|||
> **注意：** 如果你收到一个错误 PHP53 or higher is missing 请执行下面的命令来安装 php
|
||||
> `brew install php53-intl`
|
||||
|
||||
<a name="Installation - Windows"></a>
|
||||
<a name="Installation-Windows"></a>
|
||||
## 安装 - Windows
|
||||
|
||||
<a name="Using the Installer"></a>
|
||||
<a name="Using-the-Installer"></a>
|
||||
### 使用安装程序
|
||||
|
||||
这是将 Composer 安装在你机器上的最简单的方法。
|
||||
|
||||
下载并且运行 [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe)，它将安装最新版本的 Composer ，并设置好系统的环境变量，因此你可以在任何目录下直接使用 `composer` 命令。
|
||||
|
||||
<a name="Manual Installation"></a>
|
||||
<a name="Manual-Installation"></a>
|
||||
### 手动安装
|
||||
|
||||
设置系统的环境变量 `PATH` 并运行安装命令下载 composer.phar 文件：
|
||||
|
|
@ -139,7 +139,7 @@ Composer 是 homebrew-php 项目的一部分。
|
|||
|
||||
C:\Users\username>
|
||||
|
||||
<a name="Using Composer"></a>
|
||||
<a name="Using-Composer"></a>
|
||||
## 使用 Composer
|
||||
|
||||
现在我们将使用 Composer 来安装项目的依赖。如果在当前目录下没有一个 `composer.json` 文件，请查看[基本用法](01-basic-usage.md)章节。
|
||||
|
|
@ -152,7 +152,7 @@ Composer 是 homebrew-php 项目的一部分。
|
|||
|
||||
$ composer install
|
||||
|
||||
继续 [上面的例子](#声明依赖关系)，这里将下载 monolog 到 `vendor/monolog/monolog` 目录。
|
||||
继续 [上面的例子](#Declaring-dependencies)，这里将下载 monolog 到 `vendor/monolog/monolog` 目录。
|
||||
|
||||
<a name="Autoloading"></a>
|
||||
## 自动加载
|
||||
|
|
|
|||
|
|
@ -1,18 +1,18 @@
|
|||
<a name="Basic usage"></a>
|
||||
<a name="Basic-usage"></a>
|
||||
# 基本用法
|
||||
|
||||
---
|
||||
|
||||
- [基本用法](#Basic usage)
|
||||
- [基本用法](#Basic-usage)
|
||||
- [安装](#Installation)
|
||||
- [`composer.json`：项目安装](#composer.json Project Setup)
|
||||
- [关于 `require` Key](#The require Key)
|
||||
- [包名称](#Package Names)
|
||||
- [包版本](#Package Versions)
|
||||
- [下一个重要版本（波浪号运算符）](#Next Significant Release)
|
||||
- [`composer.json`：项目安装](#composer.json-Project-Setup)
|
||||
- [关于 `require` Key](#The-require-Key)
|
||||
- [包名称](#Package-Names)
|
||||
- [包版本](#Package-Versions)
|
||||
- [下一个重要版本（波浪号运算符）](#Next-Significant-Release)
|
||||
- [稳定性](#Stability)
|
||||
- [安装依赖关系](#Installing Dependencies)
|
||||
- [`composer.lock` - 锁文件](#composer.lock - The Lock File)
|
||||
- [安装依赖关系](#Installing-Dependencies)
|
||||
- [`composer.lock` - 锁文件](#composer.lock-The-Lock-File)
|
||||
- [Packagist](#Packagist)
|
||||
- [自动加载](#Autoloading)
|
||||
|
||||
|
|
@ -39,14 +39,14 @@
|
|||
> $ curl -sS https://getcomposer.org/installer | php -- --check
|
||||
> $ curl -sS https://getcomposer.org/installer | php -- --help
|
||||
|
||||
<a name="composer.json Project Setup"></a>
|
||||
<a name="composer.json-Project-Setup"></a>
|
||||
## `composer.json`：项目安装
|
||||
|
||||
要开始在你的项目中使用 Composer，你只需要一个 `composer.json` 文件。该文件包含了项目的依赖和其它的一些元数据。
|
||||
|
||||
这个 [JSON format](http://json.org/) 是很容易编写的。它允许你定义嵌套结构。
|
||||
|
||||
<a name="The require Key"></a>
|
||||
<a name="The-require-Key"></a>
|
||||
### 关于 `require` Key
|
||||
|
||||
第一件事情（并且往往只需要做这一件事），你需要在 `composer.json` 文件中指定 `require` key 的值。你只需要简单的告诉 Composer 你的项目需要依赖哪些包。
|
||||
|
|
@ -59,14 +59,14 @@
|
|||
|
||||
你可以看到， `require` 需要一个 **包名称** （例如 `monolog/monolog`） 映射到 **包版本** （例如 `1.0.*`） 的对象。
|
||||
|
||||
<a name="Package Names"></a>
|
||||
<a name="Package-Names"></a>
|
||||
### 包名称
|
||||
|
||||
包名称由供应商名称和其项目名称构成。通常容易产生相同的项目名称，而供应商名称的存在则很好的解决了命名冲突的问题。它允许两个不同的人创建同样名为 `json` 的库，而之后它们将被命名为 `igorw/json` 和 `seldaek/json`。
|
||||
|
||||
这里我们需要引入 `monolog/monolog`，供应商名称与项目的名称相同，对于一个具有唯一名称的项目，我们推荐这么做。它还允许以后在同一个命名空间添加更多的相关项目。如果你维护着一个库，这将使你可以很容易的把它分离成更小的部分。
|
||||
|
||||
<a name="Package Versions"></a>
|
||||
<a name="Package-Versions"></a>
|
||||
### 包版本
|
||||
|
||||
在前面的例子中，我们引入的 monolog 版本指定为 `1.0.*`。这表示任何从 `1.0` 开始的开发分支，它将会匹配 `1.0.0`、`1.0.2` 或者 `1.0.20`。
|
||||
|
|
@ -110,7 +110,7 @@
|
|||
</tbody>
|
||||
</table>
|
||||
|
||||
<a name="Next Significant Release"></a>
|
||||
<a name="Next-Significant-Release"></a>
|
||||
### 下一个重要版本（波浪号运算符）
|
||||
|
||||
`~` 最好用例子来解释： `~1.2` 相当于 `>=1.2,<2.0`，而 `~1.2.3` 相当于 `>=1.2.3,<1.3`。正如你所看到的这对于遵循 [语义化版本号](http://semver.org/) 的项目最有用。一个常见的用法是标记你所依赖的最低版本，像 `~1.2` （允许1.2以上的任何版本，但不包括2.0）。由于理论上直到2.0应该都没有向后兼容性问题，所以效果很好。你还会看到它的另一种用法，使用 `~` 指定最低版本，但允许版本号的最后一位数字上升。
|
||||
|
|
@ -120,7 +120,7 @@
|
|||
|
||||
默认情况下只有稳定的发行版才会被考虑在内。如果你也想获得 RC、beta、alpha 或 dev 版本，你可以使用 [稳定标志](04-schema.md#package-links)。你可以对所有的包做 [最小稳定性](04-schema.md#minimum-stability) 设置，而不是每个依赖逐一设置。
|
||||
|
||||
<a name="Installing Dependencies"></a>
|
||||
<a name="Installing-Dependencies"></a>
|
||||
## 安装依赖关系
|
||||
|
||||
获取定义的依赖到你的本地项目，只需要调用 `composer.phar` 运行 `install` 命令。
|
||||
|
|
@ -136,7 +136,7 @@
|
|||
|
||||
另一件事是 `install` 命令将创建一个 `composer.lock` 文件到你项目的根目录中。
|
||||
|
||||
<a name="composer.lock - The Lock File"></a>
|
||||
<a name="composer.lock-The-Lock-File"></a>
|
||||
## `composer.lock` - 锁文件
|
||||
|
||||
在安装依赖后，Composer 将把安装时确切的版本号列表写入 `composer.lock` 文件。这将锁定改项目的特定版本。
|
||||
|
|
|
|||
Loading…
Reference in New Issue