Composer/ja

Composer (コンポーザー) は、PHPのライブラリの依存性管理ツールです. 以降、MediaWikiコアの外部ライブラリの依存関係はComposerで管理されるようになりました. さらに、MediaWiki拡張機能のインストールの管理にも使用できます(以降で利用できます). しかし、現状ではあまりサポートされていません. 今後、変更される可能性があります.

Unix/Linux、macOSの場合
install Composerには、最もわかりやすい方法である の他に、複数の方法があります.

MediaWiki 1.31、1.35.0、1.35.1では、Composer 1.xのみサポートされています. 最新のComposer 1.x安定版リリースを入手するには以下を実行します:

Composer 2.xとComposer 1.xはMediaWiki >= 1.35.2(REL1_36 ブランチとmasterとともに)でサポートされています. 最新のComposer 2.x安定版リリースを入手するには以下を実行します:

macOSをお使いの方は、Homebrewを使ってComposerをインストールすることができます. この場合、Composer 2.xがインストールされますので、使用しているMediaWikiのバージョンによっては、上記の の指示に従ってComposer 1.xをダウンロードする必要があります.

うまくいかない場合、あるいはHomebrewがインストールされていない場合は、以下をお試しください:

Toolforgeと拡張機能ディストリビューターは、"integration/composer" gitリポジトリに含まれるComposerのコピーを使用します.

Composerがインストールされると、ダウンロードしたphar経由で以下のようにコマンドを実行できるようになります.

通常の実行ファイルとして使用できるように、pharをパスに移動しておくとよいでしょう.

mv コマンドが権限が関係で失敗した場合は、sudo を付けてもう一度お試しください.

Windowsの場合
ダウンロードページからインストーラーをダウンロードし、実行するだけです. 手動インストールを好む場合は、Windowsにはデフォルトでwget(またはAPTやHomebrew)がないことと、/usr/local/binディレクトリがないことを除いて、上記の手順を踏むことができます. このような場合は、ウェブブラウザでcomposer-1.pharをダウンロードし、それをcomposer.pharにリネームすればよいのです.

Composer 1.x
Composerを最新の1.x安定版にアップグレードしたい場合(または2.x安定版からダウングレードしたい場合)には、以下を使用することができます.

権限の関係で更新コマンドに失敗した場合は、sudoを付けてもう一度お試しください.

もし、あなたが本当に古いバージョンのcomposerを使用している場合は、 パラメータがない可能性があります. この場合、 を2回実行することをお勧めします. 1つ目は2.xにアップデートする可能性があるため、2つ目は最新版の1.xにダウングレードします.

Composer 2.x
If you are using Composer 1.x, and want to upgrade to Composer 2.x (and are using an appropriate version of MediaWiki, such as >= 1.35.2), you can use:

権限の関係で更新コマンドに失敗した場合は、sudoを付けてもう一度お試しください.

MediaWikiコアでの使用法
MediaWiki 1.25以降は、Composerで管理されているいくつかの外部ライブラリに依存しています. Composerは でオートローダーを作成し、それを でインクルードします.

Composerで管理される依存関係は、MediaWikiと拡張機能のtarball配布物にバンドルされているため、システム管理者はComposerを直接使用する必要はありません. When installing MediaWiki using Git, dependencies declared in  can either be installed locally by running   or the   repository can be cloned to provide the same libraries used on the Wikimedia production cluster.

composer-merge-pluginの使用
MediaWiki core "owns"  and will change the contents of that file in both tarball and Git managed updates. In order to allow local installs to use Composer to load optional libraries and/or manage extensions with Composer, a special plugin for Composer named composer-merge-plugin was developed. このプラグインとMediaWikiコアの 構成はローカルデプロイメントが必要な拡張機能とライブラリをMediaWikiのルートディレクトリの中の ファイルに追加することを可能にします.

は、Composer自体を使用してインストールされていない拡張機能が必要とするComposerマネージド・ライブラリーをインストールするために使用することもできます. This is only needed when the extensions are not installed from tarballs generated by Extension Distributor.

To enable Composer to discover and process the  files that may be included in any and all of your locally installed extensions, add something like this to  :

After any changes to, you need to remove   before running   again so that Composer will recalculate the dependencies and the changes will take effect.

リソース

 * List of extensions that can or must be installed with Composer
 * Composer (software)
 * Composer (software)
 * Composer (software)
 * Composer (software)
 * Composer (software)
 * Composer (software)