PHP 依存関係管理ツール Composer の入門チュートリアル

Composer は、PHP の依存関係管理ツールです。これにより、プロジェクトが依存するコード ライブラリを宣言でき、それらがプロジェクトにインストールされます。

依存関係管理

Composer はパッケージ マネージャーではありません。はい、これには「パッケージ」と「ライブラリ」が含まれますが、プロジェクトごとに管理され、プロジェクト内の特定のディレクトリ (ベンダーなど) にインストールされます。デフォルトでは、グローバルには何もインストールされません。したがって、これは単なる依存関係の管理です。

このアイデアは新しいものではなく、Composer はノードの npm と Ruby のバンドラーから強く影響を受けています。当時、PHP 用の同様のツールはありませんでした。

Composer は次のように問題を解決します:

複数のライブラリに依存するプロジェクトがあります。

これらのライブラリの一部は他のライブラリに依存しています。

何に依存しているかを宣言します。

Composer は、どのバージョンのパッケージをインストールする必要があるかを判断し、それらをインストールします (プロジェクトにダウンロードします)。

依存関係を宣言する

プロジェクトを作成していて、ログ記録用のライブラリが必要だとします。あなたはmonologを使用することにしました。これをプロジェクトに追加するには、プロジェクトの依存関係を記述したcomposer.jsonファイルを作成するだけです。

{
    "require": {
        "monolog/monolog": "1.2.*"
    }
}

私たちのプロジェクトには、1.2 以降のバージョンのいくつかの monolog/monolog パッケージが必要であることを指摘しておきます。

システム要件

Composer を実行するには、PHP 5.3.2 以降が必要です。いくつかの機密性の高い PHP 設定とコンパイル フラグも必要ですが、インストーラーは非互換性について警告をスローします。

単に zip ファイルをダウンロードするのではなく、パッケージのソースから直接インストールします。ロードしているパッケージで使用されているバージョン管理システムに応じて、 git 、 svn 、または hg が必要になります。

Composer はマルチプラットフォームであり、Windows、Linux、OSX プラットフォームで同等に動作するように努めています。

Linux/Unix でのインストール

部分インストール

Composer を実際に入手するには、2 つのことを行う必要があります。まず Composer をインストールします (これは、Composer がプロジェクトにダウンロードされることを意味します):

curl -sS https://getcomposer.org/installer | php

注: 上記の方法が何らかの理由で失敗した場合は、php > 経由でインストーラーをダウンロードすることもできます:

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

これは、いくつかのチェックを行いますPHP 設定を確認し、composer.phar を作業ディレクトリにダウンロードします。これは Composer バイナリです。これは PHAR パッケージ (PHP アーカイブ) であり、ユーザーがコマンド ラインで一部の操作を実行するのに役立つ PHP アーカイブ形式です。

--install-dir オプションを使用して Composer インストール ディレクトリを指定できます (絶対パスまたは相対パスを指定できます):

curl -sS https://getcomposer.org/installer | php -- --install-dir=bin

グローバル インストール

このファイルはどこにでも配置できます。システムの PATH ディレクトリに置くと、グローバルにアクセスできます。 Unix 系システムでは、php プレフィックスなしで使用することもできます。

これらのコマンドを実行して、システム内でグローバルにコンポーザー呼び出しを行うことができます:

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer

注: 権限が原因でアピールコマンドが失敗した場合は、sudo を使用して mv コマンドを再度実行してください。 これで、php combos.phar と入力しなくても、composer コマンドを実行するだけで Composer を使用できるようになります。

グローバル インストール (homebrew 経由で OSX 上)

Composer は homebrew-php プロジェクトの一部です。

brew update
brew tap josegonzalez/homebrew-php
brew tap homebrew/versions
brew install php55-intl
brew install josegonzalez/php/composer

Windows でのインストール

インストーラーを使用します

これは、Composer をマシンにインストールする最も簡単な方法です。

Composer-Setup.exe をダウンロードして実行すると、最新バージョンの Composer がインストールされ、システム環境変数が設定されるため、任意のディレクトリで直接 Composer コマンドを使用できるようになります。

手動インストール

システム環境変数 PATH を設定し、インストール コマンドを実行して、composer.phar ファイルをダウンロードします:

C:\Users\username>cd C:\bin
C:\bin>php -r "readfile('https://getcomposer.org/installer');" | php

注: readfile エラー メッセージが表示された場合は、http リンクを使用するか、php で php_openssl.dll を有効にしてください。 .ini。 新しいファイルcomposer.pharと同じディレクトリにcomposer.batを作成します:

C:\bin>echo @php "%~dp0composer.phar" %*>composer.bat

現在のコマンドラインウィンドウを閉じて、テスト用に新しいコマンドラインウィンドウを開きます:

C:\Users\username>composer -V
Composer version 27d8904

Composerを使用します

次に、Composerを使用してプロジェクトの依存関係。

依存関係を解決してダウンロードするには、インストール コマンドを実行してください:

php composer.phar install

グローバルにインストールし、現在のディレクトリに phar ファイルがない場合は、代わりに次のコマンドを使用してください:

composer install

上記の例を続けると、monolog はここからダウンロードできます。vendor/monolog/monolog ディレクトリに移動します。

自動ロード

ライブラリのダウンロードに加えて、Composer は、Composer によってダウンロードされたライブラリ内のすべてのクラス ファイルをロードできる自動ロード ファイルも用意しています。これを使用するには、次のコード行をプロジェクトのブートストラップ ファイルに追加するだけです:

require 'vendor/autoload.php';

これで、monolog を使用できるようになりました。