Composer.json の構成情報の概要

Config

次は、composer コマンドを使用したチュートリアルの列です。 ここでは、composer.json の設定関連の情報を紹介します。

process-timeout リクエスト プロセス タイムアウト設定

デフォルトのリクエスト タイムアウトは 300 秒に設定されています。クローン操作に Git を使用する場合と同様に、Composer はリクエストのタイムアウト時間が経過するまで続行できます。インストールが完了するまで実行します。ネットワーク速度が十分に速くない場合、またはロードするコンテンツが大量にある場合は、タイムアウトを長く設定できます。

use-include-path インクルード パス設定を使用します

デフォルト設定は false です。true に設定すると、Composer オートローダーは PHP パスに含まれるクラスを自動的に検索します。

preferred-install インストール環境設定

#デフォルト設定は自動モードで、source、dist、または auto モードに設定できます。このオプションを使用すると、Composer を好みのモードに設定できます。インストール環境設定をより正確に設定するには、ハッシュ モードを使用できます。

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

注意: オプション モードを設定する順序は重要です。精密設定モードが有効になるように、精密設定モードは大まかな設定モードの前に使用する必要があります。グローバル設定およびパッケージ設定において、文字列とハッシュを混在して設定する場合、文字列設定項目は*モードに変換されます。

store-auths

認証ポップアップ ボックスの後に実行されるアクションには 3 つのオプションがあります。

true は認証情報を永久に保存します。

false は認証情報を保存しません。

「プロンプト」は毎回再認証を必要とし、これがデフォルトのオプションです。

github-protocols

デフォルトは ["https"、"ssh"、"git"] です。 github.com からクローンを作成するときに使用されるプロトコルの優先リスト。git プロトコルは暗号化された送信ではないため、secure-http オプションがオフに設定されている場合にのみ、クローン作成に git プロトコルが最初に使用されます。 SSH (git@github.com:...) プロトコルの代わりに HTTPS プロトコルを使用するようにリモート プッシュ URL を設定する場合は、["https"] を設定するだけで、Composer がプッシュ URL を次のように書き換えることが停止されます。 SSH プロトコル。

github-oauth

ドメイン名と Oauth キーのリスト。たとえば、このオプションの値として {"github.com": "oauthtoken"} を使用すると、oauthtoken を使用して github 上のプライベート リポジトリにアクセスし、IP ベースの API の使用をバイパスします。 GitHub の OAuth トークンを取得する方法については、ここをクリックしてください。

gitlab-oauth

ドメイン名と Oauth キーのリスト。たとえば、このオプションの値として {"gitlab.com": "oauthtoken"} を使用すると、oauthtoken を使用して GitLab 上のプライベート リポジトリにアクセスします。注: コードが gitlab.com でホストされていない場合は、このパラメータ (gitlab-domains) も設定する必要があります。

gitlab-token

ドメイン名とプライベート トークンのリスト。例: このオプションの値として {"gitlab.com": "privatetoken"} を使用すると、privatetoken を使用して GitLab 上のプライベート リポジトリにアクセスします。注: コードが gitlab.com でホストされていない場合は、このパラメータ (gitlab-domains) も指定する必要があります。

disable-tls

デフォルトは false です。 true に設定すると、すべての HTTPS URL が HTTP に置き換えられ、ネットワーク層の暗号化は使用されません。このオプションを有効にすると、セキュリティ上のリスクが生じる可能性があるため、お勧めできません。php.ini で php_openssl 拡張機能を有効にすることをお勧めします。

secure-http

デフォルトは true です。 true に設定すると、Composer では HTTPS URL のみが許可されます。何かにアクセスするために HTTP を使用する必要があると確信している場合は、HTTP をオフにすることができますが、Let's Encrypt のようなプロバイダーを使用して無料の SSL 証明書を取得すると、より良い選択。

bitbucket-oauth

ドメイン名とユーザー名のリスト。たとえば、{"bitbucket.org": {"consumer-key": "myKey", "consumer-secret": "mySecret"}} を使用します。 BitBucket でユーザーを作成する方法の詳細については、「」を参照してください。

cafile

ローカル ファイル システム内の認証証明書の場所。 PHP 5.6 では、これは php.ini の openssl.cafile を介して設定する必要がありますが、PHP 5.6 ではこれは自動的に取得されます。

capath

証明書ファイルが指定されていない場合、または証明書がその場所に見つからない場合、システムは capath で指定されたファイル内で適切な証明書を検索します。 。 capath は、適切にハッシュ化された暗号化された証明書が存在するディレクトリである必要があります。

http-basic

ストレージ認証に必要なドメイン名とユーザー名とパスワードのリスト。たとえば、値として {"example.org": {"username": "alice", "password": "foo"}} を使用すると、Composer は指定されたユーザー名とパスワードを使用して example.org を認証します。

注: http-basic や github-oauth などの認証関連の設定は、composer.json とは別に auth.json ファイルで定義することもできます。こうすることで、Git に無視するように指示でき、各開発者が独自の認証資格情報を保存できるようになります。

プラットフォーム

プラットフォーム拡張機能 (PHP とその拡張機能) を偽装して実稼働環境をシミュレートし、設定でターゲット プラットフォームを定義できます。例: {"php": "7.0.3", "ext-something": "4.0.3"}。

vendor-dir

デフォルトは、vendor です。必要な依存関係を別のディレクトリにインストールすることもできます。ベンダーの $HOME と ~ 、および以下のすべての *-dir ディレクトリは、HOME ディレクトリに置き換えられます。

bin-dir

デフォルトは、vendor/bin です。プロジェクトに実行可能ファイルが含まれている場合、それらはこのディレクトリ内でシンボリックリンクされます。

data-dir

Windows のデフォルトは、XDG に準拠する UNIX システムでは C:\Users\\AppData\Roaming\Composer です。ディレクトリ定義は $XDG_DATA_HOME/composer にありますが、他の UNIX システムでは $home になります。現在は、ロールバックの場合に古いバージョンのcomposer.pharファイルを保存するためにのみ使用されます。詳細については、「COMPOSER_HOME」を参照してください。

cache-dir

Windows のデフォルトは、XDG に準拠する UNIX システムでは C:\Users\\AppData\Local\Composer です。ディレクトリ定義は $XDG_CACHE_HOME/composer にありますが、他の UNIX システムでは $home/cache になります。 Composer によって使用されるすべてのキャッシュ ファイルを保存します。詳細については、「COMPOSER_HOME」を参照してください。

cache-files-dir

デフォルトは $cache-dir/files です。すべての拡張パックを保存する ZIP アーカイブ。

cache-repo-dir

デフォルトは $cache-dir/repo です。 Composer タイプのリポジトリと、svn、fossil、github、および bitbucket タイプのリポジトリのメタデータを保存する VCS リポジトリ。

cache-vcs-dir

デフォルトは $cache-dir/vcs です。インストールを高速化するために、すべての git/hg タイプのリポジトリからクローンされたファイルを保存します。

cache-files-ttl

デフォルトは 15552000 (6 か月) です。 Composer は、ダウンロードした拡張パックによって構築されたすべてのファイル (zip、tar、..) をキャッシュします。デフォルトでは、6 か月間使用されないとクリアされます。この設定により、この有効期限を秒単位で変更したり、0 に設定して完全に無効にしたりできます。

cache-files-maxsize

デフォルトは 300MiB です。 Composer は、ダウンロードした拡張パックによって構築されたすべてのファイル (zip、tar、..) をキャッシュします。これは、定期的なガベージ コレクションの実行中にキャッシュされたファイルが占有できる最大容量です。古いキャッシュや使用頻度が低いキャッシュはクリアされます。

bin-compat

デフォルトは自動です。実行可能ファイルのインストールに必要な互換性を決定します。 auto に設定すると、.bat ファイルのみが Windows にインストールされます。 full に設定すると、.bat に加えて、UNIX システムに必要なスクリプト ファイルもインストールされます。これは主に、Composer が実行され、プロジェクトが実行されているシステムが不整合である状況に対処するためのものです。

prepend-autoloader

デフォルトは true です。 false に設定すると、Composer のオートローダーは既存のオートローダーにプリロードされません。これは、他のローダーとの共有によって引き起こされる問題を修正するために使用できる場合があります。

autoloader-suffix

デフォルトは null です。 Composer オートローダーのサフィックスとして使用される文字列。空の場合、文字列のランダムなセットが生成されます。

optimize-autoloader

デフォルトは false です。 true に設定すると、オートローダーの生成時に最適化が常に実行されます。

sort-packages

デフォルトは false です。 true に設定すると、require コマンドの実行時に、composer.json ファイル内の拡張パッケージ名が常にアルファベット順に並べられます。

classmap-authoritative

デフォルトは false です。 true に設定すると、Composer オートローダーはクラスマップ内のクラスのみをロードします。このオプションにより、optimize-autoloader が有効になります。

apcu-autoloader

デフォルトは false です。 true に設定すると、Composer オートローダーは APCu をチェックし、拡張機能が有効になっているときにそれを使用して、見つかったクラスと見つからなかったクラスをキャッシュします。

github-domains

デフォルトは ["github.com"] です。 gitHub モードで使用するドメイン名のリスト。これは GitHub Enterprise によって使用される可能性があります。

github-expose-hostname

デフォルトは true です。 false に設定すると、Github API にアクセスするために作成された OAuth トークンには、ホスト名の代わりに日付が含まれます。

gitlab-domains

デフォルトは ["gitlab.com"] です。 GitLab サーバーのドメイン名のリスト。これは、gitlab リポジトリ タイプを使用する場合に使用できます。

notify-on-install

デフォルトは true です。 Composer を使用すると、リポジトリに基づいた拡張機能パッケージがインストールされたときに通知を受信するための通知 URL をリポジトリで定義できます。このエントリにより、この動作を無効にすることができます。 ＃＃＃＃＃＃＃＃＃変更を破棄＃＃＃＃＃＃

默认是 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 文件。

以上がComposer.json の構成情報の概要の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。