Introduction aux informations de configuration dans composer.json

Config

La colonne tutoriel est utilisée ci-dessous par la commande composer Laissez-moi vous présenter les informations relatives à la configuration dans composer.json.

paramètre de délai d'expiration du processus de demande de délai d'attente de processus

Le délai d'expiration de la demande par défaut est défini sur 300 secondes. Comme lors de l'utilisation de Git pour les opérations de clonage, Composer peut continuer jusqu'à l'heure de la demande. out. Exécutez jusqu’à ce que l’installation soit terminée. Si la vitesse de votre réseau n'est pas assez rapide ou si de nombreux contenus doivent être chargés, vous pouvez définir un délai d'expiration plus élevé.

use-include-path Utilisez le paramètre de chemin d'inclusion

Le paramètre par défaut est false S'il est défini sur true, le chargeur automatique Composer trouvera automatiquement les classes incluses dans PHP. chemin.

Paramètres des préférences d'installation d'installation préférée

Le paramètre par défaut est le mode automatique, qui peut être défini sur le mode source, dist ou automatique. Cette option vous permet de définir Composer sur votre mode préféré. Pour des paramètres plus précis des préférences d'installation, le mode hachage peut être utilisé.

{
    "config": {
        "preferred-install": {
            "my-organization/stable-package": "dist",
            "my-organization/*": "source",
            "partner-organization/*": "auto",
            "*": "dist"
        }
    }
}

Veuillez noter : l'ordre dans lequel vous définissez les modes d'options est important. Le mode de réglage précis doit être utilisé avant le mode de réglage large, afin que le mode de réglage précis prenne effet. Dans les paramètres globaux et de package, les éléments de configuration de chaîne sont convertis en mode * lors de la configuration utilisant un mélange de chaînes et de hachages.

store-auths

L'action entreprise après la boîte de dialogue d'authentification. Il existe trois options :

true pour stocker les informations d'authentification pour toujours ;

false ne stocke pas les informations d'authentification ;

"invite" nécessitera une ré-authentification à chaque fois, c'est l'option par défaut.

github-protocols

La valeur par défaut est ["https", "ssh", "git"]. Liste prioritaire des protocoles utilisés lors du clonage depuis github.com Le protocole git n'est pas une transmission cryptée, donc ce n'est que lorsque l'option secure-http est désactivée que le protocole git sera utilisé en premier pour le clonage. Si vous souhaitez configurer l'URL Push distante pour qu'elle utilise le protocole HTTPS au lieu du protocole SSH (git@github.com:...), vous pouvez simplement définir ["https"] pour que Composer arrête de réécrire l'URL Push vers le protocole SSH.

github-oauth

Une liste de noms de domaine et de clés Oauth. Par exemple : utiliser {"github.com": "oauthtoken"} comme valeur de cette option utilisera oauthtoken pour accéder aux référentiels privés sur github et contourner l'utilisation de l'API basée sur IP. Cliquez ici pour savoir comment obtenir un jeton OAuth pour GitHub.

gitlab-oauth

Une liste de noms de domaine et de clés Oauth. Par exemple : utiliser {"gitlab.com": "oauthtoken"} comme valeur de cette option utilisera oauthtoken pour accéder aux référentiels privés sur GitLab. Attention : si votre code n'est pas hébergé sur gitlab.com, vous devez également configurer ce paramètre - gitlab-domains.

gitlab-token

Une liste de noms de domaine et de jetons privés. Par exemple : utiliser {"gitlab.com": "privatetoken"} comme valeur de cette option utilisera privatetoken pour accéder aux référentiels privés sur GitLab. Attention : si votre code n'est pas hébergé sur gitlab.com, vous devez également spécifier ce paramètre - gitlab-domains.

disable-tls

La valeur par défaut est false. Si la valeur est true, toutes les URL HTTPS seront remplacées par HTTP et le cryptage de la couche réseau ne sera pas utilisé. L'activation de cette option peut entraîner des risques de sécurité, elle n'est donc pas recommandée. Une meilleure façon consiste à activer l'extension php_openssl dans le php.ini.

secure-http

La valeur par défaut est true . Si la valeur est true, seules les URL HTTPS sont autorisées dans Composer. Si vous êtes vraiment sûr de devoir utiliser HTTP pour accéder à quelque chose, vous pouvez le désactiver, mais utiliser un fournisseur comme Let's Encrypt pour obtenir un certificat SSL gratuit est une solution. meilleur choix.

bitbucket-oauth

Une liste de noms de domaine et de noms d'utilisateur. Par exemple, utilisez {"bitbucket.org": {"consumer-key": "myKey", "consumer-secret": "mySecret"}}. Voir pour plus de détails sur la façon de créer un utilisateur dans BitBucket.

cafile

L'emplacement du certificat d'authentification dans le système de fichiers local. Dans PHP 5.6+, vous devez définir cela via openssl.cafile dans php.ini, bien que dans PHP 5.6+, cela sera obtenu automatiquement.

capath

Si le fichier de certificat n'est pas spécifié ou si le certificat n'est pas trouvé à cet emplacement, le système recherchera un certificat approprié dans le fichier spécifié par capath . capath doit être un répertoire dans lequel existe un certificat chiffré correctement haché.

http-basic

Un nom de domaine et une liste de noms d'utilisateur et de mots de passe requis pour l'authentification du stockage. Par exemple, en utilisant {"example.org": {"username": "alice", "password": "foo"}} comme valeur, Composer utilisera le nom d'utilisateur et le mot de passe spécifiés pour authentifier example.org.

Remarque : les paramètres liés à l'authentification tels que http-basic et github-oauth peuvent également être définis dans le fichier auth.json, distinct de composer.json. De cette façon, vous pouvez dire à Git de l'ignorer et chaque développeur peut stocker ses propres informations d'authentification.

plateforme

vous permet de déguiser les extensions de plateforme (PHP et ses extensions) pour simuler un environnement de production et définir votre plateforme cible dans les paramètres. Par exemple : {"php": "7.0.3", "ext-something": "4.0.3"}.

vendor-dir

La valeur par défaut est le fournisseur. Vous pouvez également installer les dépendances requises dans un autre répertoire. $HOME et ~ in supplier et tous les répertoires *-dir ci-dessous seront remplacés par votre répertoire HOME.

bin-dir

La valeur par défaut est supplier/bin. Si un projet contient des fichiers exécutables, ils seront liés symboliquement dans ce répertoire.

data-dir

La valeur par défaut est C:Usersbe1cdaf6779910b92a0a47fc24e82b4fAppDataRoamingComposer dans WIndows et $XDG_DATA_HOME/composer dans les systèmes Unix conformes à la définition du répertoire XDG. Sur d'autres systèmes Unix, ce sera $home. Désormais, il n'est utilisé que pour stocker les anciennes versions des fichiers composer.phar en cas de restauration. Voir COMPOSER_HOME pour plus de détails.

cache-dir

La valeur par défaut est C:Usersbe1cdaf6779910b92a0a47fc24e82b4fAppDataLocalComposer dans WIndows et $XDG_CACHE_HOME/composer dans les systèmes Unix conformes à la définition du répertoire XDG. Sur d'autres systèmes Unix, ce sera $home/cache. Stocke tous les fichiers de cache utilisés par Composer. Voir COMPOSER_HOME pour plus de détails.

cache-files-dir

La valeur par défaut est $cache-dir/files. Archive ZIP qui stocke tous les packs d'extension.

cache-repo-dir

La valeur par défaut est $cache-dir/repo. Dépôt VCS qui stocke les métadonnées des référentiels de type composer et des référentiels de type svn, fossil, github et bitbucket.

cache-vcs-dir

La valeur par défaut est $cache-dir/vcs. Stocke les fichiers clonés à partir de tous les référentiels de type git/hg pour accélérer l'installation.

cache-files-ttl

La valeur par défaut est 15552000 (6 mois). Composer met en cache tous les fichiers (zip, tar, ..) créés par les packs d'extension qu'il télécharge. Par défaut, il sera effacé s'il n'est pas utilisé pendant 6 mois. Ce paramètre vous permet de modifier ce délai d'expiration en secondes ou de le définir sur 0 pour le désactiver complètement.

cache-files-maxsize

La valeur par défaut est 300 Mo. Composer met en cache tous les fichiers (zip, tar, ..) créés par les packs d'extension qu'il télécharge. Il s'agit de la quantité maximale d'espace qu'il permet aux fichiers de cache d'occuper pendant qu'il effectue un garbage collection périodique. Les caches plus anciens ou rarement utilisés seront effacés.

bin-compat

La valeur par défaut est auto. Détermine la compatibilité requise pour l'installation du fichier exécutable. S'il est défini sur auto, seuls les fichiers .bat seront installés sous Windows. S'il est défini sur full, en plus de .bat, les fichiers de script requis par le système Unix seront également installés. Il s'agit principalement de gérer la situation dans laquelle Composer est exécuté et le système sur lequel le projet est exécuté est incohérent.

prepend-autoloader

La valeur par défaut est vraie. S'il est défini sur false, le chargeur automatique de Composer ne sera pas préchargé dans un chargeur automatique existant. Cela peut parfois être utilisé pour résoudre des problèmes causés par le partage avec d'autres chargeurs.

suffixe du chargeur automatique

La valeur par défaut est nulle. Une chaîne qui sera utilisée comme suffixe pour le chargeur automatique Composer. S'il est vide, un ensemble aléatoire de chaînes sera généré.

optimize-autoloader

La valeur par défaut est fausse. S'il est défini sur true, les optimisations seront toujours effectuées lors de la génération de l'autochargeur.

sort-packages

La valeur par défaut est fausse. S'il est défini sur true, les noms des packages d'extension dans le fichier composer.json seront toujours classés par ordre alphabétique lors de l'exécution de la commande require.

classmap-authoritative

La valeur par défaut est fausse. S'il est défini sur true, le chargeur automatique Composer chargera uniquement les classes dans le classmap. Cette option active l'optimisation du chargeur automatique.

apcu-autoloader

La valeur par défaut est fausse. S'il est défini sur true, le chargeur automatique Composer vérifie APCu et l'utilise pour mettre en cache les classes trouvées et non trouvées lorsque l'extension est activée.

github-domains

La valeur par défaut est ["github.com"]. Une liste de noms de domaine à utiliser en mode gitHub. Cela peut être utilisé par GitHub Enterprise.

github-expose-hostname

La valeur par défaut est vraie. S'ils sont définis sur false, les jetons OAuth créés pour accéder à l'API Github auront une date au lieu d'un nom d'hôte.

gitlab-domains

La valeur par défaut est ["gitlab.com"]. Une liste de noms de domaine pour les serveurs GitLab. Cela peut être utilisé si vous utilisez le type de référentiel gitlab.

notifier lors de l'installation

La valeur par défaut est vraie. Composer permet à un référentiel de définir une URL de notification pour recevoir des notifications lorsqu'un package d'extension basé sur ce référentiel est installé. Cette entrée vous permet de désactiver ce comportement.

rejeter les modifications

默认是 false 并且可以被设为 true，false 或 "stash"。此项允许你设置在升级过程中发生冲突时的默认行为。true 会放弃 vendors 中的更改，而 "stash" 尝试着去暂存以便于恢复。如果你的 CI 服务器或部署脚本可能会更改 vendors，那么可以使用该设置。

archive-format

默认是 tar。Composer 允许你设置在工作流需要创建特定格式压缩包时的默认压缩格式。

archive-dir

默认是 .。Composer 允许你设置在工作流需要创建特定格式压缩包时的默认压缩文件存储路径。也为了模块间的开发变得更加容易。

举个例子：

{
    "config": {
        "archive-dir": "/home/user/.composer/repo"
    }
}

htaccess-protect

默认是 true。如果设为 false，Composer 不会在 COMPOSER_HOME、cache、和数据目录创建 .htaccess 文件。

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!