2011-08-20 12:55:01 +00:00
{
2020-04-12 22:54:46 +00:00
"$schema" : "https://json-schema.org/draft-04/schema#" ,
2021-05-20 09:04:19 +00:00
"title" : "Package" ,
2011-08-20 12:55:01 +00:00
"type" : "object" ,
"properties" : {
"name" : {
"type" : "string" ,
2020-04-15 11:29:03 +00:00
"description" : "Package name, including 'vendor-name/' prefix." ,
2022-06-01 19:23:07 +00:00
"pattern" : "^[a-z0-9]([_.-]?[a-z0-9]+)*\/[a-z0-9](([_.]|-{1,2})?[a-z0-9]+)*$"
2011-08-20 12:55:01 +00:00
} ,
2021-11-25 14:43:37 +00:00
"description" : {
"type" : "string" ,
"description" : "Short package description."
} ,
"license" : {
"type" : [ "string" , "array" ] ,
"description" : "License name. Or an array of license names."
} ,
2011-08-20 12:55:01 +00:00
"type" : {
2013-08-13 11:25:21 +00:00
"description" : "Package type, either 'library' for common packages, 'composer-plugin' for plugins, 'metapackage' for empty packages, or a custom type ([a-z0-9-]+) defined by whatever project this package applies to." ,
2019-08-05 09:13:48 +00:00
"type" : "string" ,
"pattern" : "^[a-z0-9-]+$"
2011-08-20 12:55:01 +00:00
} ,
2021-11-25 14:43:37 +00:00
"abandoned" : {
"type" : [ "boolean" , "string" ] ,
"description" : "Indicates whether this package has been abandoned, it can be boolean or a package name/URL pointing to a recommended alternative. Defaults to false."
2011-10-09 14:43:16 +00:00
} ,
2021-11-25 14:43:37 +00:00
"version" : {
2011-08-20 12:55:01 +00:00
"type" : "string" ,
2021-11-25 14:43:37 +00:00
"description" : "Package version, see https://getcomposer.org/doc/04-schema.md#version for more info on valid schemes." ,
"pattern" : "^v?\\d+(\\.\\d+){0,3}|^dev-"
} ,
"default-branch" : {
"type" : [ "boolean" ] ,
"description" : "Internal use only, do not specify this in composer.json. Indicates whether this version is the default branch of the linked VCS repository. Defaults to false."
} ,
"non-feature-branches" : {
"type" : [ "array" ] ,
"description" : "A set of string or regex patterns for non-numeric branch names that will not be handled as feature branches." ,
"items" : {
"type" : "string"
}
2011-08-20 12:55:01 +00:00
} ,
"keywords" : {
"type" : "array" ,
"items" : {
2011-11-20 15:23:22 +00:00
"type" : "string" ,
"description" : "A tag/keyword that this package relates to."
}
2011-08-20 12:55:01 +00:00
} ,
2018-04-13 07:09:58 +00:00
"readme" : {
"type" : "string" ,
"description" : "Relative path to the readme document."
} ,
2011-11-20 15:23:22 +00:00
"time" : {
"type" : "string" ,
2014-06-07 15:04:06 +00:00
"description" : "Package release date, in 'YYYY-MM-DD', 'YYYY-MM-DD HH:MM:SS' or 'YYYY-MM-DDTHH:MM:SSZ' format."
2011-11-20 15:23:22 +00:00
} ,
2011-08-20 12:55:01 +00:00
"authors" : {
2017-01-03 10:09:49 +00:00
"$ref" : "#/definitions/authors"
2011-08-20 12:55:01 +00:00
} ,
2021-11-25 14:43:37 +00:00
"homepage" : {
"type" : "string" ,
"description" : "Homepage URL for the project." ,
"format" : "uri"
} ,
"support" : {
"type" : "object" ,
"properties" : {
"email" : {
"type" : "string" ,
"description" : "Email address for support." ,
"format" : "email"
} ,
"issues" : {
"type" : "string" ,
"description" : "URL to the issue tracker." ,
"format" : "uri"
} ,
"forum" : {
"type" : "string" ,
"description" : "URL to the forum." ,
"format" : "uri"
} ,
"wiki" : {
"type" : "string" ,
"description" : "URL to the wiki." ,
"format" : "uri"
} ,
"irc" : {
"type" : "string" ,
"description" : "IRC channel for support, as irc://server/channel." ,
"format" : "uri"
} ,
"chat" : {
"type" : "string" ,
"description" : "URL to the support chat." ,
"format" : "uri"
} ,
"source" : {
"type" : "string" ,
"description" : "URL to browse or download the sources." ,
"format" : "uri"
} ,
"docs" : {
"type" : "string" ,
"description" : "URL to the documentation." ,
"format" : "uri"
} ,
"rss" : {
"type" : "string" ,
"description" : "URL to the RSS feed." ,
"format" : "uri"
2023-03-10 21:28:10 +00:00
} ,
"security" : {
"type" : "string" ,
"description" : "URL to the vulnerability disclosure policy (VDP)." ,
"format" : "uri"
2021-11-25 14:43:37 +00:00
}
}
} ,
"funding" : {
"type" : "array" ,
"description" : "A list of options to fund the development and maintenance of the package." ,
"items" : {
"type" : "object" ,
"properties" : {
"type" : {
"type" : "string" ,
"description" : "Type of funding or platform through which funding is possible."
} ,
"url" : {
"type" : "string" ,
"description" : "URL to a website with details on funding and a way to fund the package." ,
"format" : "uri"
}
}
}
} ,
2022-03-29 13:57:04 +00:00
"source" : {
"$ref" : "#/definitions/source"
} ,
"dist" : {
"$ref" : "#/definitions/dist"
} ,
2021-11-25 14:43:37 +00:00
"_comment" : {
"type" : [ "array" , "string" ] ,
"description" : "A key to store comments in"
} ,
2011-08-20 12:55:01 +00:00
"require" : {
"type" : "object" ,
2021-12-07 22:00:48 +00:00
"description" : "This is an object of package name (keys) and version constraints (values) that are required to run this package." ,
2016-11-03 12:19:20 +00:00
"additionalProperties" : {
"type" : "string"
}
2011-08-20 12:55:01 +00:00
} ,
2021-11-25 14:43:37 +00:00
"require-dev" : {
"type" : "object" ,
2021-12-07 22:00:48 +00:00
"description" : "This is an object of package name (keys) and version constraints (values) that this package requires for developing it (testing tools and such)." ,
2021-11-25 14:43:37 +00:00
"additionalProperties" : {
"type" : "string"
}
} ,
2011-09-26 23:09:48 +00:00
"replace" : {
"type" : "object" ,
2021-12-07 22:00:48 +00:00
"description" : "This is an object of package name (keys) and version constraints (values) that can be replaced by this package." ,
2016-11-03 12:19:20 +00:00
"additionalProperties" : {
"type" : "string"
}
2011-09-26 23:09:48 +00:00
} ,
"conflict" : {
"type" : "object" ,
2021-12-07 22:00:48 +00:00
"description" : "This is an object of package name (keys) and version constraints (values) that conflict with this package." ,
2016-11-03 12:19:20 +00:00
"additionalProperties" : {
"type" : "string"
}
2011-09-26 23:09:48 +00:00
} ,
"provide" : {
"type" : "object" ,
2021-12-07 22:00:48 +00:00
"description" : "This is an object of package name (keys) and version constraints (values) that this package provides in addition to this package's name." ,
2016-11-03 12:19:20 +00:00
"additionalProperties" : {
"type" : "string"
}
2011-09-26 23:09:48 +00:00
} ,
2021-11-25 14:43:37 +00:00
"suggest" : {
2011-09-26 23:09:48 +00:00
"type" : "object" ,
2021-12-07 22:00:48 +00:00
"description" : "This is an object of package name (keys) and descriptions (values) that this package suggests work well with it (this will be suggested to the user during installation)." ,
2016-11-03 12:19:20 +00:00
"additionalProperties" : {
"type" : "string"
}
2011-09-26 23:09:48 +00:00
} ,
2021-11-25 14:43:37 +00:00
"repositories" : {
"type" : [ "object" , "array" ] ,
"description" : "A set of additional repositories where packages can be found." ,
2016-11-03 12:19:20 +00:00
"additionalProperties" : {
2021-11-25 14:43:37 +00:00
"anyOf" : [
{ "$ref" : "#/definitions/repository" } ,
{ "type" : "boolean" , "enum" : [ false ] }
]
} ,
"items" : {
"anyOf" : [
{ "$ref" : "#/definitions/repository" } ,
{
"type" : "object" ,
"additionalProperties" : { "type" : "boolean" , "enum" : [ false ] } ,
"minProperties" : 1 ,
"maxProperties" : 1
}
]
}
} ,
"minimum-stability" : {
"type" : [ "string" ] ,
"description" : "The minimum stability the packages must have to be install-able. Possible values are: dev, alpha, beta, RC, stable." ,
"enum" : [ "dev" , "alpha" , "beta" , "rc" , "RC" , "stable" ]
} ,
"prefer-stable" : {
"type" : [ "boolean" ] ,
"description" : "If set to true, stable packages will be preferred to dev packages when possible, even if the minimum-stability allows unstable packages."
} ,
"autoload" : {
"$ref" : "#/definitions/autoload"
} ,
"autoload-dev" : {
"type" : "object" ,
"description" : "Description of additional autoload rules for development purpose (eg. a test suite)." ,
"properties" : {
"psr-0" : {
"type" : "object" ,
2021-12-07 22:00:48 +00:00
"description" : "This is an object of namespaces (keys) and the directories they can be found into (values, can be arrays of paths) by the autoloader." ,
2021-11-25 14:43:37 +00:00
"additionalProperties" : {
"type" : [ "string" , "array" ] ,
"items" : {
"type" : "string"
}
}
} ,
"psr-4" : {
"type" : "object" ,
2021-12-07 22:00:48 +00:00
"description" : "This is an object of namespaces (keys) and the PSR-4 directories they can map to (values, can be arrays of paths) by the autoloader." ,
2021-11-25 14:43:37 +00:00
"additionalProperties" : {
"type" : [ "string" , "array" ] ,
"items" : {
"type" : "string"
}
}
} ,
"classmap" : {
"type" : "array" ,
"description" : "This is an array of paths that contain classes to be included in the class-map generation process."
} ,
"files" : {
"type" : "array" ,
"description" : "This is an array of files that are always required on every request."
}
}
} ,
"target-dir" : {
"description" : "DEPRECATED: Forces the package to be installed into the given subdirectory path. This is used for autoloading PSR-0 packages that do not contain their full path. Use forward slashes for cross-platform compatibility." ,
"type" : "string"
} ,
"include-path" : {
"type" : [ "array" ] ,
"description" : "DEPRECATED: A list of directories which should get added to PHP's include path. This is only present to support legacy projects, and all new code should preferably use autoloading." ,
"items" : {
2016-11-03 12:19:20 +00:00
"type" : "string"
}
2011-09-26 23:09:48 +00:00
} ,
2021-11-25 14:43:37 +00:00
"bin" : {
"type" : [ "string" , "array" ] ,
"description" : "A set of files, or a single file, that should be treated as binaries and symlinked into bin-dir (from config)." ,
"items" : {
"type" : "string"
}
} ,
"archive" : {
"type" : [ "object" ] ,
"description" : "Options for creating package archives for distribution." ,
"properties" : {
"name" : {
"type" : "string" ,
"description" : "A base name for archive."
} ,
"exclude" : {
"type" : "array" ,
"description" : "A list of patterns for paths to exclude or include if prefixed with an exclamation mark."
}
}
} ,
2024-03-20 21:04:58 +00:00
"php-ext" : {
"type" : "object" ,
"description" : "Settings for PHP extension packages." ,
"properties" : {
2024-04-28 15:28:11 +00:00
"extension-name" : {
"type" : "string" ,
"description" : "If specified, this will be used as the name of the extension, where needed by tooling. If this is not specified, the extension name will be derived from the Composer package name (e.g. `vendor/name` would become `ext-name`). The extension name may be specified with or without the `ext-` prefix, and tools that use this must normalise this appropriately." ,
"example" : "ext-xdebug"
} ,
2024-03-20 21:04:58 +00:00
"priority" : {
"type" : "integer" ,
"description" : "This is used to add a prefix to the INI file, e.g. `90-xdebug.ini` which affects the loading order. The priority is a number in the range 10-99 inclusive, with 10 being the highest priority (i.e. will be processed first), and 99 being the lowest priority (i.e. will be processed last). There are two digits so that the files sort correctly on any platform, whether the sorting is natural or not." ,
"minimum" : 10 ,
"maximum" : 99 ,
"example" : 80 ,
"default" : 80
} ,
2024-04-28 15:28:11 +00:00
"support-zts" : {
"type" : "boolean" ,
"description" : "Does this package support Zend Thread Safety" ,
"example" : false ,
"default" : true
} ,
2024-03-20 21:04:58 +00:00
"configure-options" : {
"type" : "array" ,
"description" : "These configure options make up the flags that can be passed to ./configure when installing the extension." ,
"items" : {
"type" : "object" ,
"required" : [ "name" ] ,
"properties" : {
"name" : {
"type" : "string" ,
"description" : "The name of the flag, this would typically be prefixed with `--`, for example, the value 'the-flag' would be passed as `./configure --the-flag`." ,
"example" : "without-xdebug-compression" ,
"pattern" : "^[a-zA-Z0-9][a-zA-Z0-9-_]*$"
} ,
2024-07-19 19:41:33 +00:00
"needs-value" : {
"type" : "boolean" ,
"description" : "If this is set to true, the flag needs a value (e.g. --with-somelib=<path>), otherwise it is a flag without a value (e.g. --enable-some-feature)." ,
"example" : false ,
"default" : false
} ,
2024-03-20 21:04:58 +00:00
"description" : {
"type" : "string" ,
"description" : "The description of what the flag does or means." ,
"example" : "Disable compression through zlib"
}
}
}
}
}
} ,
2012-02-19 17:24:27 +00:00
"config" : {
2013-02-12 10:16:52 +00:00
"type" : "object" ,
2012-02-19 17:24:27 +00:00
"description" : "Composer options." ,
"properties" : {
2021-11-25 14:55:36 +00:00
"platform" : {
"type" : "object" ,
2022-04-28 19:20:40 +00:00
"description" : "This is an object of package name (keys) and version (values) that will be used to mock the platform packages on this machine, the version can be set to false to make it appear like the package is not present." ,
2021-11-25 14:55:36 +00:00
"additionalProperties" : {
"type" : [ "string" , "boolean" ]
}
} ,
2021-12-07 22:00:48 +00:00
"allow-plugins" : {
"type" : [ "object" , "boolean" ] ,
"description" : "This is an object of {\"pattern\": true|false} with packages which are allowed to be loaded as plugins, or true to allow all, false to allow none. Defaults to {} which prompts when an unknown plugin is added." ,
"additionalProperties" : {
"type" : [ "boolean" ]
}
} ,
2012-09-07 22:44:19 +00:00
"process-timeout" : {
"type" : "integer" ,
"description" : "The timeout in seconds for process executions, defaults to 300 (5mins)."
} ,
2013-02-12 10:16:52 +00:00
"use-include-path" : {
"type" : "boolean" ,
"description" : "If true, the Composer autoloader will also look for classes in the PHP include path."
} ,
2021-12-04 14:00:28 +00:00
"use-parent-dir" : {
"type" : [ "string" , "boolean" ] ,
"description" : "When running Composer in a directory where there is no composer.json, if there is one present in a directory above Composer will by default ask you whether you want to use that directory's composer.json instead. One of: true (always use parent if needed), false (never ask or use it) or \"prompt\" (ask every time), defaults to prompt."
} ,
2013-03-05 11:56:09 +00:00
"preferred-install" : {
2015-02-26 16:20:59 +00:00
"type" : [ "string" , "object" ] ,
2021-12-07 22:00:48 +00:00
"description" : "The install method Composer will prefer to use, defaults to auto and can be any of source, dist, auto, or an object of {\"pattern\": \"preference\"}." ,
"additionalProperties" : {
"type" : [ "string" ]
}
2013-03-04 19:23:55 +00:00
} ,
2023-07-21 12:36:38 +00:00
"audit" : {
"type" : "object" ,
"description" : "Security audit configuration options" ,
"properties" : {
2023-09-01 08:04:31 +00:00
"ignore" : {
"anyOf" : [
{
"type" : "object" ,
"description" : "A list of advisory ids, remote ids or CVE ids (keys) and the explanations (values) for why they're being ignored. The listed items are reported but let the audit command pass." ,
"additionalProperties" : {
"type" : [ "string" , "string" ]
}
} ,
{
"type" : "array" ,
"description" : "A set of advisory ids, remote ids or CVE ids that are reported but let the audit command pass." ,
"items" : {
"type" : "string"
}
}
]
2023-09-14 09:30:09 +00:00
} ,
"abandoned" : {
"enum" : [ "ignore" , "report" , "fail" ] ,
"description" : "Whether abandoned packages should be ignored, reported as problems or cause an audit failure."
2023-07-21 12:36:38 +00:00
}
}
} ,
2012-09-07 22:44:19 +00:00
"notify-on-install" : {
"type" : "boolean" ,
"description" : "Composer allows repositories to define a notification URL, so that they get notified whenever a package from that repository is installed. This option allows you to disable that behaviour, defaults to true."
} ,
"github-protocols" : {
"type" : "array" ,
2022-04-28 13:13:08 +00:00
"description" : "A list of protocols to use for github.com clones, in priority order, defaults to [\"https\", \"ssh\", \"git\"]." ,
2012-09-07 22:44:19 +00:00
"items" : {
"type" : "string"
}
2013-02-12 10:16:52 +00:00
} ,
"github-oauth" : {
"type" : "object" ,
2021-12-07 22:00:48 +00:00
"description" : "An object of domain name => github API oauth tokens, typically {\"github.com\":\"<token>\"}." ,
2016-11-03 12:19:20 +00:00
"additionalProperties" : {
"type" : "string"
}
2013-02-12 10:16:52 +00:00
} ,
2015-12-03 13:30:07 +00:00
"gitlab-oauth" : {
"type" : "object" ,
2022-08-16 11:34:18 +00:00
"description" : "An object of domain name => gitlab API oauth tokens, typically {\"gitlab.com\":{\"expires-at\":\"<expiration date>\", \"refresh-token\":\"<refresh token>\", \"token\":\"<token>\"}}." ,
2016-11-03 12:19:20 +00:00
"additionalProperties" : {
2022-08-16 11:34:18 +00:00
"type" : [ "string" , "object" ] ,
"required" : [ "token" ] ,
"properties" : {
"expires-at" : {
"type" : "integer" ,
"description" : "The expiration date for this GitLab token"
} ,
"refresh-token" : {
"type" : "string" ,
"description" : "The refresh token used for GitLab authentication"
} ,
"token" : {
"type" : "string" ,
"description" : "The token used for GitLab authentication"
}
}
2016-11-03 12:19:20 +00:00
}
2015-12-03 13:30:07 +00:00
} ,
2016-07-06 08:25:18 +00:00
"gitlab-token" : {
"type" : "object" ,
2022-04-28 19:20:40 +00:00
"description" : "An object of domain name => gitlab private tokens, typically {\"gitlab.com\":\"<token>\"}, or an object with username and token keys." ,
2020-03-10 12:56:22 +00:00
"additionalProperties" : {
2022-04-28 19:20:40 +00:00
"type" : [ "string" , "object" ] ,
"required" : [ "username" , "token" ] ,
"properties" : {
"username" : {
"type" : "string" ,
"description" : "The username used for GitLab authentication"
} ,
"token" : {
"type" : "string" ,
"description" : "The token used for GitLab authentication"
}
}
2020-03-10 12:56:22 +00:00
}
2016-07-06 08:25:18 +00:00
} ,
2021-06-01 14:05:53 +00:00
"gitlab-protocol" : {
"enum" : [ "git" , "http" , "https" ] ,
"description" : "A protocol to force use of when creating a repository URL for the `source` value of the package metadata. One of `git` or `http`. By default, Composer will generate a git URL for private repositories and http one for public repos."
} ,
2020-03-10 12:39:22 +00:00
"bearer" : {
"type" : "object" ,
2021-12-07 22:00:48 +00:00
"description" : "An object of domain name => bearer authentication token, for example {\"example.com\":\"<token>\"}." ,
2020-03-10 12:56:22 +00:00
"additionalProperties" : {
"type" : "string"
}
2020-03-10 12:39:22 +00:00
} ,
2016-01-10 16:35:29 +00:00
"disable-tls" : {
"type" : "boolean" ,
"description" : "Defaults to `false`. If set to true all HTTPS URLs will be tried with HTTP instead and no network level encryption is performed. Enabling this is a security risk and is NOT recommended. The better way is to enable the php_openssl extension in php.ini."
} ,
2016-03-11 06:04:12 +00:00
"secure-http" : {
"type" : "boolean" ,
"description" : "Defaults to `true`. If set to true only HTTPS URLs are allowed to be downloaded via Composer. If you really absolutely need HTTP access to something then you can disable it, but using \"Let's Encrypt\" to get a free SSL certificate is generally a better alternative."
} ,
2021-05-20 14:27:54 +00:00
"secure-svn-domains" : {
"type" : "array" ,
"description" : "A list of domains which should be trusted/marked as using a secure Subversion/SVN transport. By default svn:// protocol is seen as insecure and will throw. This is a better/safer alternative to disabling `secure-http` altogether." ,
"items" : {
"type" : "string"
}
} ,
2016-01-10 16:35:29 +00:00
"cafile" : {
"type" : "string" ,
"description" : "A way to set the path to the openssl CA file. In PHP 5.6+ you should rather set this via openssl.cafile in php.ini, although PHP 5.6+ should be able to detect your system CA file automatically."
} ,
2016-01-22 08:14:37 +00:00
"capath" : {
"type" : "string" ,
"description" : "If cafile is not specified or if the certificate is not found there, the directory pointed to by capath is searched for a suitable certificate. capath must be a correctly hashed certificate directory."
} ,
2014-05-27 11:50:47 +00:00
"http-basic" : {
"type" : "object" ,
2021-12-07 22:00:48 +00:00
"description" : "An object of domain name => {\"username\": \"...\", \"password\": \"...\"}." ,
2016-11-03 12:19:20 +00:00
"additionalProperties" : {
"type" : "object" ,
"required" : [ "username" , "password" ] ,
"properties" : {
"username" : {
"type" : "string" ,
"description" : "The username used for HTTP Basic authentication"
} ,
"password" : {
"type" : "string" ,
"description" : "The password used for HTTP Basic authentication"
}
}
}
2014-05-27 11:50:47 +00:00
} ,
"store-auths" : {
"type" : [ "string" , "boolean" ] ,
"description" : "What to do after prompting for authentication, one of: true (store), false (do not store) or \"prompt\" (ask every time), defaults to prompt."
} ,
2013-02-12 10:16:52 +00:00
"vendor-dir" : {
"type" : "string" ,
"description" : "The location where all packages are installed, defaults to \"vendor\"."
} ,
"bin-dir" : {
"type" : "string" ,
"description" : "The location where all binaries are linked, defaults to \"vendor/bin\"."
} ,
2016-01-18 18:26:05 +00:00
"data-dir" : {
"type" : "string" ,
"description" : "The location where old phar files are stored, defaults to \"$home\" except on XDG Base Directory compliant unixes."
} ,
2013-02-12 10:16:52 +00:00
"cache-dir" : {
"type" : "string" ,
"description" : "The location where all caches are located, defaults to \"~/.composer/cache\" on *nix and \"%LOCALAPPDATA%\\Composer\" on windows."
} ,
"cache-files-dir" : {
"type" : "string" ,
"description" : "The location where files (zip downloads) are cached, defaults to \"{$cache-dir}/files\"."
} ,
"cache-repo-dir" : {
"type" : "string" ,
"description" : "The location where repo (git/hg repo clones) are cached, defaults to \"{$cache-dir}/repo\"."
} ,
"cache-vcs-dir" : {
"type" : "string" ,
"description" : "The location where vcs infos (git clones, github api calls, etc. when reading vcs repos) are cached, defaults to \"{$cache-dir}/vcs\"."
} ,
"cache-ttl" : {
"type" : "integer" ,
"description" : "The default cache time-to-live, defaults to 15552000 (6 months)."
} ,
"cache-files-ttl" : {
"type" : "integer" ,
"description" : "The cache time-to-live for files, defaults to the value of cache-ttl."
} ,
"cache-files-maxsize" : {
"type" : [ "string" , "integer" ] ,
"description" : "The cache max size for the files cache, defaults to \"300MiB\"."
2013-02-28 16:10:04 +00:00
} ,
2020-08-25 11:55:32 +00:00
"cache-read-only" : {
"type" : [ "boolean" ] ,
"description" : "Whether to use the Composer cache in read-only mode."
} ,
2015-02-03 20:06:53 +00:00
"bin-compat" : {
2021-11-25 08:53:03 +00:00
"enum" : [ "auto" , "full" , "proxy" , "symlink" ] ,
"description" : "The compatibility of the binaries, defaults to \"auto\" (automatically guessed), can be \"full\" (compatible with both Windows and Unix-based systems) and \"proxy\" (only bash-style proxy)."
2015-02-03 20:06:53 +00:00
} ,
2013-02-28 16:10:04 +00:00
"discard-changes" : {
2013-03-01 22:47:24 +00:00
"type" : [ "string" , "boolean" ] ,
"description" : "The default style of handling dirty updates, defaults to false and can be any of true, false or \"stash\"."
2013-10-16 16:35:44 +00:00
} ,
2013-12-23 03:01:42 +00:00
"autoloader-suffix" : {
2013-12-23 16:27:33 +00:00
"type" : "string" ,
2013-12-26 16:40:52 +00:00
"description" : "Optional string to be used as a suffix for the generated Composer autoloader. When null a random one will be generated."
2013-12-23 03:01:42 +00:00
} ,
2014-01-17 13:43:54 +00:00
"optimize-autoloader" : {
2014-01-16 19:44:16 +00:00
"type" : "boolean" ,
2014-05-27 11:50:47 +00:00
"description" : "Always optimize when dumping the autoloader."
2014-01-16 19:44:16 +00:00
} ,
2013-10-16 16:35:44 +00:00
"prepend-autoloader" : {
"type" : "boolean" ,
"description" : "If false, the composer autoloader will not be prepended to existing autoloaders, defaults to true."
2012-09-07 23:51:33 +00:00
} ,
2015-01-04 00:35:25 +00:00
"classmap-authoritative" : {
"type" : "boolean" ,
"description" : "If true, the composer autoloader will not scan the filesystem for classes that are not found in the class map, defaults to false."
} ,
2016-07-28 08:23:39 +00:00
"apcu-autoloader" : {
"type" : "boolean" ,
"description" : "If true, the Composer autoloader will check for APCu and use it to cache found/not-found classes when the extension is enabled, defaults to false."
} ,
2012-09-07 23:51:33 +00:00
"github-domains" : {
"type" : "array" ,
"description" : "A list of domains to use in github mode. This is used for GitHub Enterprise setups, defaults to [\"github.com\"]." ,
"items" : {
"type" : "string"
}
2014-10-17 16:21:48 +00:00
} ,
"github-expose-hostname" : {
"type" : "boolean" ,
"description" : "Defaults to true. If set to false, the OAuth tokens created to access the github API will have a date instead of the machine hostname."
2015-05-27 07:20:07 +00:00
} ,
2015-12-03 13:30:07 +00:00
"gitlab-domains" : {
"type" : "array" ,
"description" : "A list of domains to use in gitlab mode. This is used for custom GitLab setups, defaults to [\"gitlab.com\"]." ,
"items" : {
"type" : "string"
}
} ,
2022-04-01 09:15:57 +00:00
"bitbucket-oauth" : {
"type" : "object" ,
"description" : "An object of domain name => {\"consumer-key\": \"...\", \"consumer-secret\": \"...\"}." ,
"additionalProperties" : {
"type" : "object" ,
"required" : [ "consumer-key" , "consumer-secret" ] ,
"properties" : {
"consumer-key" : {
"type" : "string" ,
"description" : "The consumer-key used for OAuth authentication"
} ,
"consumer-secret" : {
"type" : "string" ,
"description" : "The consumer-secret used for OAuth authentication"
2022-04-28 19:20:40 +00:00
} ,
"access-token" : {
"type" : "string" ,
"description" : "The OAuth token retrieved from Bitbucket's API, this is written by Composer and you should not set it nor modify it."
} ,
"access-token-expiration" : {
"type" : "integer" ,
"description" : "The generated token's expiration timestamp, this is written by Composer and you should not set it nor modify it."
2022-04-01 09:15:57 +00:00
}
}
}
} ,
2019-01-28 20:53:24 +00:00
"use-github-api" : {
"type" : "boolean" ,
"description" : "Defaults to true. If set to false, globally disables the use of the GitHub API for all GitHub repositories and clones the repository as it would for any other repository."
} ,
2015-05-27 07:20:07 +00:00
"archive-format" : {
"type" : "string" ,
"description" : "The default archiving format when not provided on cli, defaults to \"tar\"."
} ,
"archive-dir" : {
"type" : "string" ,
"description" : "The default archive path when not provided on cli, defaults to \".\"."
2017-06-15 15:06:13 +00:00
} ,
"htaccess-protect" : {
"type" : "boolean" ,
"description" : "Defaults to true. If set to false, Composer will not create .htaccess files in the composer home, cache, and data directories."
2017-12-28 20:05:21 +00:00
} ,
"sort-packages" : {
"type" : "boolean" ,
"description" : "Defaults to false. If set to true, Composer will sort packages when adding/updating a new dependency."
2019-10-19 19:46:29 +00:00
} ,
"lock" : {
"type" : "boolean" ,
"description" : "Defaults to true. If set to false, Composer will not create a composer.lock file."
2020-04-21 13:25:35 +00:00
} ,
"platform-check" : {
2020-11-04 20:50:06 +00:00
"type" : [ "boolean" , "string" ] ,
"description" : "Defaults to \"php-only\" which checks only the PHP version. Setting to true will also check the presence of required PHP extensions. If set to false, Composer will not create and require a platform_check.php file as part of the autoloader bootstrap."
2024-09-18 09:00:09 +00:00
} ,
2024-09-18 13:34:25 +00:00
"bump-after-update" : {
"type" : [ "string" , "boolean" ] ,
"description" : "Defaults to false and can be any of true, false, \"dev\"` or \"no-dev\"`. If set to true, Composer will run the bump command after running the update command. If set to \"dev\" or \"no-dev\" then only the corresponding dependencies will be bumped."
} ,
2024-09-18 09:00:09 +00:00
"allow-missing-requirements" : {
"type" : [ "boolean" ] ,
"description" : "Defaults to false. If set to true, Composer will allow install when lock file is not up to date with the latest changes in composer.json."
2012-02-19 17:24:27 +00:00
}
}
} ,
2011-08-20 12:55:01 +00:00
"extra" : {
"type" : [ "object" , "array" ] ,
2013-08-13 11:25:21 +00:00
"description" : "Arbitrary extra data that can be used by plugins, for example, package of type composer-plugin may have a 'class' key defining an installer class name." ,
2011-11-20 15:23:22 +00:00
"additionalProperties" : true
2011-10-09 14:43:16 +00:00
} ,
2012-02-19 17:11:21 +00:00
"scripts" : {
"type" : [ "object" ] ,
2017-12-18 10:39:40 +00:00
"description" : "Script listeners that will be executed before/after some events." ,
2012-02-19 17:11:21 +00:00
"properties" : {
"pre-install-cmd" : {
"type" : [ "array" , "string" ] ,
2013-02-22 17:44:50 +00:00
"description" : "Occurs before the install command is executed, contains one or more Class::method callables or shell commands."
2012-02-19 17:11:21 +00:00
} ,
"post-install-cmd" : {
"type" : [ "array" , "string" ] ,
2013-02-22 17:44:50 +00:00
"description" : "Occurs after the install command is executed, contains one or more Class::method callables or shell commands."
2012-02-19 17:11:21 +00:00
} ,
"pre-update-cmd" : {
"type" : [ "array" , "string" ] ,
2013-02-22 17:44:50 +00:00
"description" : "Occurs before the update command is executed, contains one or more Class::method callables or shell commands."
2012-02-19 17:11:21 +00:00
} ,
"post-update-cmd" : {
"type" : [ "array" , "string" ] ,
2013-02-22 17:44:50 +00:00
"description" : "Occurs after the update command is executed, contains one or more Class::method callables or shell commands."
2012-02-19 17:11:21 +00:00
} ,
2013-08-01 06:44:07 +00:00
"pre-status-cmd" : {
"type" : [ "array" , "string" ] ,
"description" : "Occurs before the status command is executed, contains one or more Class::method callables or shell commands."
} ,
"post-status-cmd" : {
"type" : [ "array" , "string" ] ,
"description" : "Occurs after the status command is executed, contains one or more Class::method callables or shell commands."
} ,
2012-02-19 17:11:21 +00:00
"pre-package-install" : {
"type" : [ "array" , "string" ] ,
2013-02-22 17:44:50 +00:00
"description" : "Occurs before a package is installed, contains one or more Class::method callables or shell commands."
2012-02-19 17:11:21 +00:00
} ,
"post-package-install" : {
"type" : [ "array" , "string" ] ,
2013-02-22 17:44:50 +00:00
"description" : "Occurs after a package is installed, contains one or more Class::method callables or shell commands."
2012-02-19 17:11:21 +00:00
} ,
"pre-package-update" : {
"type" : [ "array" , "string" ] ,
2013-02-22 17:44:50 +00:00
"description" : "Occurs before a package is updated, contains one or more Class::method callables or shell commands."
2012-02-19 17:11:21 +00:00
} ,
"post-package-update" : {
"type" : [ "array" , "string" ] ,
2013-02-22 17:44:50 +00:00
"description" : "Occurs after a package is updated, contains one or more Class::method callables or shell commands."
2012-02-19 17:11:21 +00:00
} ,
"pre-package-uninstall" : {
"type" : [ "array" , "string" ] ,
2013-02-22 17:44:50 +00:00
"description" : "Occurs before a package has been uninstalled, contains one or more Class::method callables or shell commands."
2012-02-19 17:11:21 +00:00
} ,
"post-package-uninstall" : {
"type" : [ "array" , "string" ] ,
2013-02-22 17:44:50 +00:00
"description" : "Occurs after a package has been uninstalled, contains one or more Class::method callables or shell commands."
} ,
2013-05-06 14:37:21 +00:00
"pre-autoload-dump" : {
"type" : [ "array" , "string" ] ,
"description" : "Occurs before the autoloader is dumped, contains one or more Class::method callables or shell commands."
} ,
2013-02-22 17:44:50 +00:00
"post-autoload-dump" : {
"type" : [ "array" , "string" ] ,
2013-05-06 14:37:21 +00:00
"description" : "Occurs after the autoloader is dumped, contains one or more Class::method callables or shell commands."
2013-05-31 09:47:31 +00:00
} ,
"post-root-package-install" : {
"type" : [ "array" , "string" ] ,
"description" : "Occurs after the root-package is installed, contains one or more Class::method callables or shell commands."
} ,
"post-create-project-cmd" : {
"type" : [ "array" , "string" ] ,
"description" : "Occurs after the create-project command is executed, contains one or more Class::method callables or shell commands."
2012-02-19 17:11:21 +00:00
}
}
2012-03-10 09:24:14 +00:00
} ,
2017-12-18 09:46:07 +00:00
"scripts-descriptions" : {
2017-12-18 09:14:24 +00:00
"type" : [ "object" ] ,
2017-12-18 10:39:40 +00:00
"description" : "Descriptions for custom commands, shown in console help." ,
2017-12-18 09:43:30 +00:00
"additionalProperties" : {
"type" : "string"
}
2023-10-27 09:36:59 +00:00
} ,
"scripts-aliases" : {
"type" : [ "object" ] ,
"description" : "Aliases for custom commands." ,
"additionalProperties" : {
"type" : "array"
}
2011-08-20 12:55:01 +00:00
}
2016-12-29 14:39:39 +00:00
} ,
"definitions" : {
2017-01-03 10:09:49 +00:00
"authors" : {
"type" : "array" ,
"description" : "List of authors that contributed to the package. This is typically the main maintainers, not the full list." ,
"items" : {
"type" : "object" ,
"additionalProperties" : false ,
"required" : [ "name" ] ,
"properties" : {
"name" : {
"type" : "string" ,
"description" : "Full name of the author."
} ,
"email" : {
"type" : "string" ,
"description" : "Email address of the author." ,
"format" : "email"
} ,
"homepage" : {
"type" : "string" ,
"description" : "Homepage URL for the author." ,
"format" : "uri"
} ,
"role" : {
"type" : "string" ,
"description" : "Author's role in the project."
}
}
}
} ,
"autoload" : {
"type" : "object" ,
"description" : "Description of how the package can be autoloaded." ,
"properties" : {
"psr-0" : {
"type" : "object" ,
2021-12-07 22:00:48 +00:00
"description" : "This is an object of namespaces (keys) and the directories they can be found in (values, can be arrays of paths) by the autoloader." ,
2017-01-03 10:09:49 +00:00
"additionalProperties" : {
"type" : [ "string" , "array" ] ,
"items" : {
"type" : "string"
}
}
} ,
"psr-4" : {
"type" : "object" ,
2021-12-07 22:00:48 +00:00
"description" : "This is an object of namespaces (keys) and the PSR-4 directories they can map to (values, can be arrays of paths) by the autoloader." ,
2017-01-03 10:09:49 +00:00
"additionalProperties" : {
"type" : [ "string" , "array" ] ,
"items" : {
"type" : "string"
}
}
} ,
"classmap" : {
"type" : "array" ,
2020-09-21 11:19:30 +00:00
"description" : "This is an array of paths that contain classes to be included in the class-map generation process."
2017-01-03 10:09:49 +00:00
} ,
"files" : {
"type" : "array" ,
"description" : "This is an array of files that are always required on every request."
} ,
"exclude-from-classmap" : {
"type" : "array" ,
"description" : "This is an array of patterns to exclude from autoload classmap generation. (e.g. \"exclude-from-classmap\": [\"/test/\", \"/tests/\", \"/Tests/\"]"
}
}
} ,
2016-12-29 14:39:39 +00:00
"repository" : {
"type" : "object" ,
2020-10-16 09:27:50 +00:00
"anyOf" : [
2016-12-29 14:39:39 +00:00
{ "$ref" : "#/definitions/composer-repository" } ,
{ "$ref" : "#/definitions/vcs-repository" } ,
{ "$ref" : "#/definitions/path-repository" } ,
{ "$ref" : "#/definitions/artifact-repository" } ,
2020-04-15 12:09:30 +00:00
{ "$ref" : "#/definitions/pear-repository" } ,
2016-12-29 14:39:39 +00:00
{ "$ref" : "#/definitions/package-repository" }
]
} ,
"composer-repository" : {
"type" : "object" ,
"required" : [ "type" , "url" ] ,
"properties" : {
"type" : { "type" : "string" , "enum" : [ "composer" ] } ,
2017-03-10 08:27:24 +00:00
"url" : { "type" : "string" } ,
2020-04-10 11:40:02 +00:00
"canonical" : { "type" : "boolean" } ,
"only" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"exclude" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
2016-12-29 14:39:39 +00:00
"options" : {
"type" : "object" ,
"additionalProperties" : true
} ,
"allow_ssl_downgrade" : { "type" : "boolean" } ,
"force-lazy-providers" : { "type" : "boolean" }
}
} ,
"vcs-repository" : {
"type" : "object" ,
"required" : [ "type" , "url" ] ,
"properties" : {
2021-11-10 20:58:03 +00:00
"type" : { "type" : "string" , "enum" : [ "vcs" , "github" , "git" , "gitlab" , "bitbucket" , "git-bitbucket" , "hg" , "fossil" , "perforce" , "svn" ] } ,
2017-01-02 15:23:29 +00:00
"url" : { "type" : "string" } ,
2020-04-10 11:40:02 +00:00
"canonical" : { "type" : "boolean" } ,
"only" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"exclude" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
2016-12-29 14:39:39 +00:00
"no-api" : { "type" : "boolean" } ,
"secure-http" : { "type" : "boolean" } ,
"svn-cache-credentials" : { "type" : "boolean" } ,
2017-03-09 08:55:41 +00:00
"trunk-path" : { "type" : [ "string" , "boolean" ] } ,
"branches-path" : { "type" : [ "string" , "boolean" ] } ,
"tags-path" : { "type" : [ "string" , "boolean" ] } ,
2016-12-29 14:39:39 +00:00
"package-path" : { "type" : "string" } ,
"depot" : { "type" : "string" } ,
"branch" : { "type" : "string" } ,
"unique_perforce_client_name" : { "type" : "string" } ,
"p4user" : { "type" : "string" } ,
"p4password" : { "type" : "string" }
}
} ,
"path-repository" : {
"type" : "object" ,
"required" : [ "type" , "url" ] ,
"properties" : {
"type" : { "type" : "string" , "enum" : [ "path" ] } ,
"url" : { "type" : "string" } ,
2020-04-10 11:40:02 +00:00
"canonical" : { "type" : "boolean" } ,
"only" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"exclude" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
2016-12-29 14:39:39 +00:00
"options" : {
"type" : "object" ,
"properties" : {
"symlink" : { "type" : [ "boolean" , "null" ] }
} ,
"additionalProperties" : true
}
}
} ,
"artifact-repository" : {
"type" : "object" ,
"required" : [ "type" , "url" ] ,
"properties" : {
"type" : { "type" : "string" , "enum" : [ "artifact" ] } ,
2020-04-10 11:40:02 +00:00
"url" : { "type" : "string" } ,
"canonical" : { "type" : "boolean" } ,
"only" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"exclude" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
}
2016-12-29 14:39:39 +00:00
}
} ,
2020-04-15 12:09:30 +00:00
"pear-repository" : {
"type" : "object" ,
"required" : [ "type" , "url" ] ,
"properties" : {
"type" : { "type" : "string" , "enum" : [ "pear" ] } ,
"url" : { "type" : "string" } ,
"canonical" : { "type" : "boolean" } ,
"only" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"exclude" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"vendor-alias" : { "type" : "string" }
}
} ,
2016-12-29 14:39:39 +00:00
"package-repository" : {
"type" : "object" ,
"required" : [ "type" , "package" ] ,
"properties" : {
"type" : { "type" : "string" , "enum" : [ "package" ] } ,
2020-04-10 11:40:02 +00:00
"canonical" : { "type" : "boolean" } ,
"only" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"exclude" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
2016-12-29 14:39:39 +00:00
"package" : {
"oneOf" : [
{ "$ref" : "#/definitions/inline-package" } ,
{
"type" : "array" ,
2018-04-25 18:36:43 +00:00
"items" : { "$ref" : "#/definitions/inline-package" }
2016-12-29 14:39:39 +00:00
}
]
}
}
} ,
"inline-package" : {
2018-03-07 22:05:37 +00:00
"type" : "object" ,
2017-01-03 10:09:49 +00:00
"required" : [ "name" , "version" ] ,
"properties" : {
"name" : {
"type" : "string" ,
"description" : "Package name, including 'vendor-name/' prefix."
} ,
"type" : {
"type" : "string"
} ,
"target-dir" : {
"description" : "DEPRECATED: Forces the package to be installed into the given subdirectory path. This is used for autoloading PSR-0 packages that do not contain their full path. Use forward slashes for cross-platform compatibility." ,
"type" : "string"
} ,
"description" : {
"type" : "string"
} ,
"keywords" : {
"type" : "array" ,
"items" : {
"type" : "string"
}
} ,
"homepage" : {
"type" : "string" ,
"format" : "uri"
} ,
"version" : {
"type" : "string"
} ,
"time" : {
"type" : "string"
} ,
"license" : {
"type" : [
"string" ,
"array"
]
} ,
"authors" : {
"$ref" : "#/definitions/authors"
} ,
"require" : {
"type" : "object" ,
"additionalProperties" : {
"type" : "string"
}
} ,
"replace" : {
"type" : "object" ,
"additionalProperties" : {
"type" : "string"
}
} ,
"conflict" : {
"type" : "object" ,
"additionalProperties" : {
"type" : "string"
}
} ,
"provide" : {
"type" : "object" ,
"additionalProperties" : {
"type" : "string"
}
} ,
"require-dev" : {
"type" : "object" ,
"additionalProperties" : {
"type" : "string"
}
} ,
"suggest" : {
"type" : "object" ,
"additionalProperties" : {
"type" : "string"
}
} ,
"extra" : {
"type" : [ "object" , "array" ] ,
"additionalProperties" : true
} ,
"autoload" : {
"$ref" : "#/definitions/autoload"
} ,
"archive" : {
"type" : [ "object" ] ,
"properties" : {
"exclude" : {
2017-01-03 10:34:29 +00:00
"type" : "array"
2017-01-03 10:09:49 +00:00
}
}
} ,
"bin" : {
2018-01-02 08:55:41 +00:00
"type" : [ "string" , "array" ] ,
"description" : "A set of files, or a single file, that should be treated as binaries and symlinked into bin-dir (from config)." ,
2017-01-03 10:09:49 +00:00
"items" : {
"type" : "string"
}
} ,
"include-path" : {
"type" : [ "array" ] ,
"description" : "DEPRECATED: A list of directories which should get added to PHP's include path. This is only present to support legacy projects, and all new code should preferably use autoloading." ,
"items" : {
"type" : "string"
}
} ,
"source" : {
2022-03-29 13:57:04 +00:00
"$ref" : "#/definitions/source"
2017-01-03 10:09:49 +00:00
} ,
"dist" : {
2022-03-29 13:57:04 +00:00
"$ref" : "#/definitions/dist"
2017-01-03 10:09:49 +00:00
}
} ,
"additionalProperties" : true
2022-03-29 13:57:04 +00:00
} ,
"source" : {
"type" : "object" ,
"required" : [ "type" , "url" , "reference" ] ,
"properties" : {
"type" : {
"type" : "string"
} ,
"url" : {
"type" : "string"
} ,
"reference" : {
"type" : "string"
} ,
"mirrors" : {
"type" : "array"
}
}
} ,
"dist" : {
"type" : "object" ,
"required" : [ "type" , "url" ] ,
"properties" : {
"type" : {
"type" : "string"
} ,
"url" : {
"type" : "string"
} ,
"reference" : {
"type" : "string"
} ,
"shasum" : {
"type" : "string"
} ,
"mirrors" : {
"type" : "array"
}
}
2016-12-29 14:39:39 +00:00
}
2011-08-20 12:55:01 +00:00
}
}
