diff --git a/cn-introduction/00-intro.md b/cn-introduction/00-intro.md index 556ecd4..ede543e 100644 --- a/cn-introduction/00-intro.md +++ b/cn-introduction/00-intro.md @@ -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 会找出哪个版本的包需要安装，并安装它们（将它们下载到你的项目中）。 - + ## 声明依赖关系 比方说，你正在创建一个项目，你需要一个库来做日志记录。你决定使用 [monolog](https://github.com/Seldaek/monolog)。为了将它添加到你的项目中，你所需要做的就是创建一个 `composer.json` 文件，其中描述了项目的依赖关系。 @@ -53,7 +53,7 @@ d) Composer 会找出哪个版本的包需要安装，并安装它们（将它 我们只要指出我们的项目需要一些 `monolog/monolog` 的包，从 `1.2` 开始的任何版本。 - + ## 系统要求 运行 Composer 需要 PHP 5.3.2+ 以上版本。一些敏感的 PHP 设置和编译标志也是必须的，但对于任何不兼容项安装程序都会抛出警告。 @@ -62,10 +62,10 @@ d) Composer 会找出哪个版本的包需要安装，并安装它们（将它 Composer 是多平台的，我们努力使它在 Windows 、 Linux 以及 OSX 平台上运行的同样出色。 - + ## 安装 - *nix - + ### 下载 Composer 的可执行文件 @@ -96,7 +96,7 @@ Composer 是多平台的，我们努力使它在 Windows 、 Linux 以及 OSX 现在只需要运行 `composer` 命令就可以使用 Composer 而不需要输入 `php composer.phar`。 - + #### 全局安装 (on OSX via homebrew) Composer 是 homebrew-php 项目的一部分。 @@ -108,17 +108,17 @@ Composer 是 homebrew-php 项目的一部分。 > **注意：** 如果你收到一个错误 PHP53 or higher is missing 请执行下面的命令来安装 php > `brew install php53-intl` - + ## 安装 - Windows - + ### 使用安装程序 这是将 Composer 安装在你机器上的最简单的方法。 下载并且运行 [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe)，它将安装最新版本的 Composer ，并设置好系统的环境变量，因此你可以在任何目录下直接使用 `composer` 命令。 - + ### 手动安装 设置系统的环境变量 `PATH` 并运行安装命令下载 composer.phar 文件： @@ -139,7 +139,7 @@ Composer 是 homebrew-php 项目的一部分。 C:\Users\username> - + ## 使用 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` 目录。 ## 自动加载 diff --git a/cn-introduction/01-basic-usage.md b/cn-introduction/01-basic-usage.md index 65f0f8a..69db52f 100644 --- a/cn-introduction/01-basic-usage.md +++ b/cn-introduction/01-basic-usage.md @@ -1,18 +1,18 @@ - + # 基本用法 --- -- [基本用法](#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 - + ## `composer.json`：项目安装 要开始在你的项目中使用 Composer，你只需要一个 `composer.json` 文件。该文件包含了项目的依赖和其它的一些元数据。 这个 [JSON format](http://json.org/) 是很容易编写的。它允许你定义嵌套结构。 - + ### 关于 `require` Key 第一件事情（并且往往只需要做这一件事），你需要在 `composer.json` 文件中指定 `require` key 的值。你只需要简单的告诉 Composer 你的项目需要依赖哪些包。 @@ -59,14 +59,14 @@ 你可以看到， `require` 需要一个 **包名称** （例如 `monolog/monolog`） 映射到 **包版本** （例如 `1.0.*`） 的对象。 - + ### 包名称 包名称由供应商名称和其项目名称构成。通常容易产生相同的项目名称，而供应商名称的存在则很好的解决了命名冲突的问题。它允许两个不同的人创建同样名为 `json` 的库，而之后它们将被命名为 `igorw/json` 和 `seldaek/json`。 这里我们需要引入 `monolog/monolog`，供应商名称与项目的名称相同，对于一个具有唯一名称的项目，我们推荐这么做。它还允许以后在同一个命名空间添加更多的相关项目。如果你维护着一个库，这将使你可以很容易的把它分离成更小的部分。 - + ### 包版本 在前面的例子中，我们引入的 monolog 版本指定为 `1.0.*`。这表示任何从 `1.0` 开始的开发分支，它将会匹配 `1.0.0`、`1.0.2` 或者 `1.0.20`。 @@ -110,7 +110,7 @@ - + ### 下一个重要版本（波浪号运算符） `~` 最好用例子来解释： `~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) 设置，而不是每个依赖逐一设置。 - + ## 安装依赖关系 获取定义的依赖到你的本地项目，只需要调用 `composer.phar` 运行 `install` 命令。 @@ -136,7 +136,7 @@ 另一件事是 `install` 命令将创建一个 `composer.lock` 文件到你项目的根目录中。 - + ## `composer.lock` - 锁文件 在安装依赖后，Composer 将把安装时确切的版本号列表写入 `composer.lock` 文件。这将锁定改项目的特定版本。