From dbc5d3a83faeac1035ddacf3a0dcc798828915b4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Tom=C3=A1=C5=A1=20Fejfar?= Date: Sun, 9 Oct 2016 22:21:57 +0200 Subject: [PATCH] Clarify allowed format for repositories key Using JSON object should be discouraged as there is no explicit order of keys in JSON object. Even though it's deterministic in current PHP version, it may change any time. As stated on http://json.org/: "An object is an unordered set of name/value pairs. An object begins with { (left brace) and ends with } (right brace). Each name is followed by : (colon) and the name/value pairs are separated by , (comma)." Fixes #2802. --- doc/04-schema.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/04-schema.md b/doc/04-schema.md index ce031493b..d1419431d 100644 --- a/doc/04-schema.md +++ b/doc/04-schema.md @@ -775,6 +775,19 @@ will look from the first to the last repository, and pick the first match. By default Packagist is added last which means that custom repositories can override packages from it. +Using JSON object is also allowed. However, it is discouraged because there is no explicit order of keys in JSON object. + + ```json +{ + "repositories": { + "composer": { + "type": "composer", + "url": "http://packages.example.com" + } + } +} + ``` + ### config ([root-only](04-schema.md#root-package)) A set of configuration options. It is only used for projects. See