這篇文章將為大家詳細(xì)講解有關(guān)composer.json中所有屬性字段的示例分析，小編覺得挺實(shí)用的，因此分享給大家做個(gè)參考，希望大家閱讀完這篇文章后可以有所收獲。

為鎮(zhèn)寧等地區(qū)用戶提供了全套網(wǎng)頁設(shè)計(jì)制作服務(wù)，及鎮(zhèn)寧網(wǎng)站建設(shè)行業(yè)解決方案。主營業(yè)務(wù)為成都網(wǎng)站設(shè)計(jì)、成都網(wǎng)站制作、鎮(zhèn)寧網(wǎng)站設(shè)計(jì)，以傳統(tǒng)方式定制建設(shè)網(wǎng)站，并提供域名空間備案等一條龍服務(wù)，秉承以專業(yè)、用心的態(tài)度為用戶提供真誠的服務(wù)。我們深信只要達(dá)到每一位用戶的要求，就會(huì)得到認(rèn)可，從而選擇與我們長期合作。這樣，我們也可以走得更遠(yuǎn)！

1、name

包的名字。由供應(yīng)方（vendor）名和項(xiàng)目名組成，用 / 分隔。

在發(fā)布包的時(shí)候需要填。

2、description

對包的一個(gè)簡短描述，通常是一行的長度。

在發(fā)布包的時(shí)候需要填。

3、version

包的版本。

格式必須是 X.Y.Z，選擇性后綴：-dev、-alphaN、-betaN、-RCN。

4、type

包的類型，默認(rèn)為 library。

包類型用于定制安裝邏輯。如果你的包的安裝需要一些特殊的邏輯，你可以定義一個(gè)定制的類型。它可以是一個(gè) symfony-bundle 的類型，或者 wordpress-plugin，或者 typo3-module。這些類型將被特定的項(xiàng)目所用，它們將提供安裝器來安裝這些類型的包。

Composer 支持 3 種類型：

library：默認(rèn)值。它將復(fù)制文件到 vendor 目錄。

project：它表示這是個(gè)項(xiàng)目，而不是庫。比如像 Symfony 標(biāo)準(zhǔn)版這種應(yīng)用。

metapackage：一個(gè)含有依賴的空包，能觸發(fā)安裝，但不包含文件，不會(huì)向文件系統(tǒng)寫任何東西。

composer-install：為其他的定制類型的包提供安裝器的包。

5、keywords

一個(gè)與包相關(guān)的關(guān)鍵詞數(shù)組。用于包的搜索和過濾。

可選。

6、homepage

項(xiàng)目的網(wǎng)站 URL。

可選。

7、time

版本發(fā)布時(shí)間。必須是 YYYY-MM-DD 或 YYYY-MM-DD HH:MM:SS 格式。

可選。

8、license

包的許可證?？梢允亲址蜃址?dāng)?shù)組。

可選，但強(qiáng)烈建議加上。

9、authors

包的作者。是個(gè)對象數(shù)組。

每個(gè) author 對象有這些屬性：

name：作者名字

email：作者郵箱

homepage：作者網(wǎng)站 URL

role：作者在項(xiàng)目中的角色（如：developer 或 translator）

10、support

各種關(guān)于該項(xiàng)目如何獲取支持的信息。包含這些屬性：

email：獲取支持的郵箱

issues：問題跟蹤的 URL

forum：論壇的 URL

wiki：Wiki 的 URL

irc：IRC 的頻道

source：查看或下載源碼的 URL

可選。

11、Package links

依賴包的映射表，由包名映射版本約束。如：

{
    "require": {
        "monolog/monolog": "1.0.*"
    }
}

（1）require

列出包所依賴的包。除非這些依賴已經(jīng)存在，否則這個(gè)包不會(huì)被安裝。

（2）require-dev（root-only）

列出開發(fā)這個(gè)包（或跑測試等等）所依賴的包。在使用 install 命令時(shí)，只有帶上 “–dev” 參數(shù)才能安裝 dev 包。在使用 update 命令時(shí)，帶上 “–no-dev” 則不更新。

（3）conflict

列出包會(huì)和哪些包發(fā)生沖突。它們將不被允許和你的包一起安裝。如果約束了版本，則只會(huì)針對特定的版本。

（4）replace

列出哪些包要被這個(gè)包替代。

（5）provide

這個(gè)包所推薦的包列表。這個(gè)對公共接口最有用，一個(gè)包可以依賴一個(gè)虛擬的 logger 包，而實(shí)現(xiàn) logger 接口的庫可以放到 provide 字段中。

12、suggest

建議一些能讓這個(gè)包工作的更好或得到增強(qiáng)的包列表。這些信息只在包安裝完成時(shí)給出，暗示用戶可以添加更多包，雖然不是必須要安裝的。

格式是，包名映射文字說明，如：

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

13、autoload

提供給 PHP autoloader 的自動(dòng)加載映射。

目前支持的有：PSR-0 自動(dòng)加載規(guī)范，classmap 生成器，還有 files。

PSR-0 是比較推薦的，因?yàn)樗膬?yōu)秀的擴(kuò)展性（在添加新的類的適合，不需要重新生成自動(dòng)加載器）。

（1）PSR-0

在 psr-0 鍵名下，定義一個(gè)命名空間到路徑的映射表，相對于包的根目錄。注意，這也同樣支持 PEAR-style 的沒有命名空間的風(fēng)格。

請注意命名空間的聲明得以 \\ 結(jié)尾，確保自動(dòng)加載器正確響應(yīng)。

PSR-0 的引用可以在安裝或更新時(shí)生成的文件中查看：

vendor/composer/autoload_namespaces.php

例子：

{
    "autoload": {
        "psr-0": {
            "Monolog\\": "src/",
            "Vendor\\Namespace\\": "src/",
            "Vendor_Namespace_": "src/"
        }
    }
}

如果你需要在多個(gè)目錄里查找同一個(gè)前綴的命名空間，你可以用數(shù)組，如：

{
    "autoload": {
        "psr-0": { "Monolog\\": ["src/", "lib/"] }
    }
}

PSR-0 風(fēng)格并不局限于加載命名空間的聲明的東西，也可以用于類這個(gè)層級(jí)。當(dāng)庫中只有一個(gè)在全局命名空間中的類時(shí)，這種方式就能用上。比如你有個(gè) PHP 源文件放在項(xiàng)目的根目錄，你可以這樣聲明：

{
    "autoload": {
        "psr-0": { "UniqueGlobalClass": "" }
    }
}

如果你有個(gè)目錄下全是用命名空間組織的，你可以用空前綴：

{
    "autoload": {
        "psr-0": { "": "src/" }
    }
}

（2）Classmap

classmap 的引用可以在安裝或更新時(shí)生成的文件中查看：

vendor/composer/autoload_classmap.php

類映射表是通過掃描指定的目錄或文件下的所有的 .php 和 .inc 文件生成的。

你可以給任何不支持 PSR-0 的庫用 classmap 生成器實(shí)現(xiàn)自動(dòng)加載。配置上只要指定類所在的目錄或文件即可：

{
    "autoload": {
        "classmap": ["src/", "lib/", "Something.php"]
    }
}

（3）files

如果你確定需要在任何請求中都加載某些文件，你可以使用 files 自動(dòng)加載機(jī)制。對于那些包中有些 PHP 函數(shù)但不能自動(dòng)加載時(shí)特別有用。例如：

{
    "autoload": {
        "files": ["src/MyLibrary/functions.php"]
    }
}

14、include-path

（將被棄用，它的功能由 autoload 代替。其實(shí)就是設(shè)置 include_path，可選）

15、target-dir

指定安裝目標(biāo)路徑。

如果包的根目錄是在命名空間下，自動(dòng)加載就不正確了，所以才有 target-dir 來解決這個(gè)問題。

Symfony 就是個(gè)例子。它由很多組件包組成。Yaml 組件是在

Symfony\Component\Yaml

命名空間下的，它的根目錄是 Yaml 目錄。要讓自動(dòng)加載正常工作，我們要確保它不是安裝在

vendor/symfony/yaml

，而是在

vendor/symfony/yaml/Symfony/Component/Yaml

，這樣自動(dòng)加載器才能從 vendor/symfony/yaml 加載它。

所以要定義 target-dir 如下：

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

16、minimum-stability（root-only）

定義根據(jù)穩(wěn)定性如何過濾包。默認(rèn)是 stable，如果你信賴一個(gè) dev 包，你需要指明。

17、prefer-stable（root-only）

如果開啟，Composer 會(huì)在穩(wěn)定包和不穩(wěn)定包中選擇前者。

18、repositories（root-only）

定制包的倉庫地址。

默認(rèn)的，Composer 只使用 Packagist 倉庫。通過指定倉庫地址，你可以從任何地方獲取包。

倉庫不能遞歸。你只能將它們添加到主的 composer.json 中。所依賴包中 composer.json 文件中的倉庫定義是被忽略的。

支持的倉庫的類型有：

（1）composer

composer 倉庫通過網(wǎng)絡(luò)提供 packages.json 文件，它包含一個(gè) composer.json 對象的列表，還有額外的 dist 或 source 信息。packages.json 文件通過 PHP 流加載。

（2）vcs

版本控制系統(tǒng)倉庫，如：git、svn、hg。

（3）pear

通過它，你可以導(dǎo)入任何 pear 倉庫到你的項(xiàng)目中。

（4）package

如果你依賴一個(gè)不支持 composer 的項(xiàng)目，你可以定義一個(gè) package 類型的倉庫，然后將 composer.json 對象直接寫入。

完整的例子：

{
    "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/"
                }
            }
        }
    ]
}

19、config（root-only）

針對項(xiàng)目的一些配置。

process-timeout：默認(rèn) 300 秒，Composer 進(jìn)程執(zhí)行超時(shí)時(shí)間；
use-include-path：默認(rèn) false，如果是 true，Composer 自動(dòng)加載器也會(huì)到 PHP 的 include_path 中查找；
preferred-install：默認(rèn) auto，設(shè)置 Composer 安裝方式；
github-protocols：默認(rèn) [“git”, “https”]，設(shè)置與 github 通信協(xié)議；
github-oauth：設(shè)置 oauth；
vendor-dir：默認(rèn) vendor，你可以換成別的；
bin-dir：默認(rèn) vendor/bin，如果項(xiàng)目有二進(jìn)制文件，會(huì)鏈接到這；
cache-dir：默認(rèn) $home/cache，存放 Composer 運(yùn)行時(shí)產(chǎn)生的緩存；
cache-files-dir：默認(rèn) $cache-dir/files，存放包的 zip 文件；
cache-repo-dir：默認(rèn) $cache-dir/repo，存放倉庫元數(shù)據(jù)；
cache-vcs-dir：默認(rèn) $cache-dir/vcs，存放 vcs 克??；
cache-files-ttl：默認(rèn)六個(gè)月，緩存的過期時(shí)間；
cache-files-maxsize：默認(rèn) 300M；
notify-no-install：默認(rèn) true，從倉庫安裝包會(huì)有個(gè)通知，可以關(guān)掉；
discard-changes：默認(rèn)false，如何處理臟的更新；

20、scripts（root-only）

Composer 允許你在安裝進(jìn)程中安裝鉤子腳本，鉤子是基于事件的；

21、extra

供 scripts 消費(fèi)的額外數(shù)據(jù)；

22、bin

指定哪些文件必須被當(dāng)做二進(jìn)制文件處理的；

23、archive

設(shè)置創(chuàng)建包時(shí)的選項(xiàng)，exclude 屬性可以設(shè)置排除哪些目錄，例如：

{
    "archive": {
        "exclude": ["/foo/bar", "baz", "/*.test", "!/foo/bar/baz"]
    }
}

關(guān)于“composer.json中所有屬性字段的示例分析”這篇文章就分享到這里了，希望以上內(nèi)容可以對大家有一定的幫助，使各位可以學(xué)到更多知識(shí)，如果覺得文章不錯(cuò)，請把它分享出去讓更多的人看到。