Composer

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Composer and the translation is 50% complete.

Outdated translations are marked like this.
Other languages:
English • ‎español • ‎français • ‎magyar • ‎português • ‎русский • ‎中文 • ‎日本語

Composer (コンポーザー) は、PHP のライブラリの依存関係マネージャーです。 さらに、MediaWiki 拡張機能のインストールの管理にも使用できます (MediaWiki 1.22 以降で利用できます)。 MediaWiki 1.25 以降、MediaWiki コアの外部ライブラリの依存関係は Composer で管理されています。

Composer のインストール

On Unix/Linux and macOS

install Composerには複数の方法があります:

最新のスナップショットを取得するには以下を実行します:

wget https://getcomposer.org/composer.phar

これは現行の master のスナップショットをダウンロードします。このスナップショットは30日間で有効期限が切れます。 1.0.0-alpha のようにアルファ版「リリース」の phar もあります。

OS X を使用している場合は、composer のインストールに Homebrew を使用できます:

brew install composer

動作しない場合、または Homebrew がインストールされていない場合は、以下をお試しください:

php -r "readfile('https://getcomposer.org/installer');" | php

Jenkins and the extension distributor use the copy of composer contained in the "integration/composer" git repo.

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

php composer.phar someCommand

phar をパスが通っている場所に移動すると、通常の実行可能ファイルと同様に使用できます:

mv composer.phar /usr/local/bin/composer
composer someCommand

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

On Windows

Just download and run the installer from the download page. If you prefer manual installation, you can follow the above steps except that Windows doesn’t have wget (or APT or Homebrew) by default, and there is no /usr/local/bin directory.

MediaWiki コアでの使用法

MediaWiki 1.25 以降は、Composer で管理されているいくつかの外部ライブラリに依存しています。 Composer は、WebStart.php によってインクルードされる自動ローダーを vendor/autoload.php に作成します。

Composer managed dependencies are bundled into tarball distributions of MediaWiki and extensions so system administrators do not need to use composer directly. When installing MediaWiki using Git, dependencies declared in $IP/composer.json can either be installed locally by running composer update --no-dev or the mediawiki/vendor.git repository can be cloned to provide the same libraries used on the Wikimedia production cluster.[1]


composer-merge-plugin の使用

MediaWiki core "owns" $IP/composer.json 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.[2] This plugin and the MediaWiki core composer.json configuration allow a local deployment to add required extensions and libraries to a file composer.local.json inside the root MediaWiki directory.

composer.local.json can also be used to install Composer managed libraries that are needed by extensions that are not installed using Composer themselves. This is only needed when the extensions are not installed from tarballs generated by Extension Distributor.

To enable Composer to discover and process the composer.json files that may be included in any and all of your locally installed extensions, add something like this to $IP/composer.local.json:

{
    "extra": {
        "merge-plugin": {
            "include": [
                "extensions/*/composer.json",
                "skins/*/composer.json"
            ]
        }
    }
}

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

リソース

Wikipedia-logo.png Wikipedia: Composer (software)

脚注