Composer/ja

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



Composerのインストール


Unix/Linux、macOSの場合
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のアップグレード


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

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

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



Composer 2.x
Composer 1.xを使用していて、Composer 2.xにアップグレードしたい場合(及び >= 1.35.2のような適切なバージョンのMediaWikiを使用している場合)、以下を使用できます.

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



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

Composerで管理される依存関係は、MediaWikiと拡張機能のtarball配布物にバンドルされているため、システム管理者はComposerを直接使用する必要はありません. Gitを使用してMediaWikiをインストールするとき、 で宣言された依存関係は を実行することでローカルにインストールするか、 リポジトリをクローンしてWikimedia運用クラスタで使用される同じライブラリを提供することができます.



composer-merge-pluginの使用
MediaWikiコアは を"所有"(owns)し、tarballとGitで管理された更新の両方でそのファイルの内容を変更します. ローカルインストールで、オプションライブラリのロードや拡張機能の管理をComposerで行うために、composer-merge-pluginというComposer用の特別なプラグインが開発されました. このプラグインとMediaWikiコアの 構成はローカルデプロイメントが必要な拡張機能とライブラリをMediaWikiのルートディレクトリの中の ファイルに追加することを可能にします.

は、Composer自体を使用してインストールされていない拡張機能が必要とするComposerマネージド・ライブラリーをインストールするために使用することもできます. これは、Extension Distributorによって生成されたtarballから拡張機能をインストールしない場合にのみ必要です.

ローカルにインストールされた拡張機能に含まれる ファイルをComposerが検出して処理できるようにするには、 に次のような内容を追加します.

を変更した後、 を再度実行する前に を削除して、Composerが依存関係を再計算し、変更が有効になるようにする必要があります.

リソース

 * Composerと一緒にインストールできる、またはインストールが必要な拡張機能の一覧です.
 * Composer (software)
 * Composer (software)
 * Composer (software)
 * Composer (software)
 * Composer (software)
 * Composer (software)