5.4.3. composer的使用¶

composer.json 来定义你的项目的依赖

基本属性:

name: 包的名字。由供应方（vendor）名和项目名组成，用 / 分隔
    在发布包的时候需要填。
description: 对包的一个简短描述，通常是一行的长度。
    在发布包的时候需要填
version: 包的版本
    格式必须是 X.Y.Z，选择性后缀：-dev、-alphaN、-betaN、-RCN。
type: 包的类型，默认为 library
    可以定义一个定制的类型。它可以是一个 symfony-bundle 的类型
    或者 wordpress-plugin，或者 typo3-module
    这些类型将被特定的项目所用，它们将提供安装器来安装这些类型的包
    library：默认值。它将复制文件到 vendor 目录
    project：它表示这是个项目，而不是库。比如像 Symfony 标准版这种应用
    metapackage：一个含有依赖的空包，能触发安装，但不包含文件，不会向文件系统写任何东西
    composer-install：为其他的定制类型的包提供安装器的包。

发布相关:

keywords(可选):一个与包相关的关键词数组。用于包的搜索和过滤
homepage(可选): 项目的网站 URL
time(可选):版本发布时间。必须是 YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS 格式
license(可选，但强烈建议加上):包的许可证。可以是字符串或字符串数组
authors: 包的作者。是个对象数组
    name：作者名字
    email：作者邮箱
    homepage：作者网站 URL
    role：作者在项目中的角色（如：developer 或 translator）
support(可选):各种关于该项目如何获取支持的信息。包含这些属性
    email：获取支持的邮箱
    issues：问题跟踪的 URL
    forum：论坛的 URL
    wiki：Wiki 的 URL
    irc：IRC 的频道
    source：查看或下载源码的 URL

Package links: 依赖包的映射表，由包名映射版本约束,如:

{
    "require": {
        "monolog/monolog": "1.0.*"
    }
}
require: 列出包所依赖的包。除非这些依赖已经存在，否则这个包不会被安装
require-dev(root-only):列出开发这个包（或跑测试等等）所依赖的包
    在使用 install 命令时，只有带上 “–dev” 参数才能安装 dev 包
    在使用 update 命令时，带上 “–no-dev” 则不更新
conflict: 列出包会和哪些包发生冲突。它们将不被允许和你的包一起安装。如果约束了版本，则只会针对特定的版本
replace:列出哪些包要被这个包替代
provide:这个包所推荐的包列表

suggest:建议一些能让这个包工作的更好或得到增强的包列表:

{
    "suggest": {
        "monolog/monolog": "Allows more advanced logging of the application flow"
    }
}

autoload:提供给 PHP autoloader 的自动加载映射:

目前支持的有：PSR-0 自动加载规范，classmap 生成器，还有 files
(1).PSR-0在 psr-0 键名下，定义一个命名空间到路径的映射表，相对于包的根目录
vendor/composer/autoload_namespaces.php:
    {
      "autoload": {
        "psr-0": {
           "Monolog\\": "src/",
           "Vendor\\Namespace\\": "src/",
           "Vendor_Namespace_": "src/"
        }
      }
    }
    如果你需要在多个目录里查找同一个前缀的命名空间，你可以用数组，如:
    {
      "autoload": {
        "psr-0": { "Monolog\\": ["src/", "lib/"] }
      }
    }
(2).Classmap的引用可以在安装或更新时生成的文件中查看
vendor/composer/autoload_classmap.php
    {
      "autoload": {
        "classmap": ["src/", "lib/", "Something.php"]
      }
    }
(3).files如果你确定需要在任何请求中都加载某些文件，你可以使用 files 自动加载机制
    {
      "autoload": {
        "files": ["src/MyLibrary/functions.php"]
      }
    }

target-dir:指定安装目标路径:

Symfony\Component\Yaml:
{
  "autoload": {
    "psr-0": { "Symfony\\Component\\Yaml\\": "" }
  },
  "target-dir": "Symfony/Component/Yaml"
}

repositories(root-only):定制包的仓库地址(重要):

默认的，Composer 只使用 Packagist 仓库
仓库不能递归。你只能将它们添加到主的 composer.json 中
支持的仓库的类型有:
(1).composer
(2).vcs:版本控制系统仓库，如：git、svn、hg
(3).pear:通过它，你可以导入任何 pear 仓库到你的项目中
(4).package:一个不支持 composer 的项目，你可以定义一个 package 类型的仓库
{
    "repositories": [
    {
      "type": "composer",
      "url": "http://packages.example.com"
    },
    {
      "type": "composer",
      "url": "https://packages.example.com",
      "options": {
        "ssl": {
          "verify_peer": "true"
        }
      }
    },
    {
      "type": "vcs",
      "url": "https://github.com/Seldaek/monolog"
    },
    {
      "type": "pear",
      "url": "http://pear2.php.net"
    },
    {
      "type": "package",
      "package": {
        "name": "smarty/smarty",
        "version": "3.1.7",
        "dist": {
          "url": "http://www.smarty.net/files/Smarty-3.1.7.zip",
          "type": "zip"
        },
        "source": {
          "url": "http://smarty-php.googlecode.com/svn/",
          "type": "svn",
          "reference": "tags/Smarty_3_1_7/distribution/"
        }
      }
    }
    ]
}

其他:

scripts(root-only):Composer 允许你在安装进程中安装钩子脚本,钩子是基于事件的
bin:指定哪些文件必须被当做二进制文件处理的
archive:设置创建包时的选项，exclude 属性可以设置排除哪些目录,例如:
{
    "archive": {
       "exclude": ["/foo/bar", "baz", "/*.test", "!/foo/bar/baz"]
    }
}

from:http://www.udpwork.com/item/10716.html