このチュートリアルの以前のバージョンは、Brennen Bearnesによって作成されました。
前書き
Composerは、PHPで人気のあるdependency managementツールであり、主にプロジェクトの依存関係のインストールと更新を容易にするために作成されています。 特定のプロジェクトが依存する他のパッケージをチェックし、プロジェクトの要件に応じて適切なバージョンを使用してそれらをインストールします。
このチュートリアルでは、Ubuntu 18.04システムにComposerをインストールして開始します。
前提条件
このチュートリアルを完了するには、次のものが必要です。
-
sudo非rootユーザーとファイアウォールを含むthe Ubuntu 18.04 initial server setup guideをフォローしてセットアップされた1つのUbuntu18.04サーバー。
[[step-1 -—- installing-the-dependencies]] ==ステップ1—依存関係のインストール
Composerをダウンロードしてインストールする前に、サーバーにすべての依存関係がインストールされていることを確認してください。
まず、次を実行してパッケージマネージャーキャッシュを更新します。
sudo apt update
それでは、依存関係をインストールしましょう。 Composerをダウンロードするにはcurl
が必要であり、インストールして実行するにはphp-cli
が必要です。 php-mbstring
パッケージは、使用するライブラリに関数を提供するために必要です。 git
は、Composerがプロジェクトの依存関係をダウンロードするために使用し、unzip
はzip形式のパッケージを抽出するために使用します。 すべては、次のコマンドでインストールできます。
sudo apt install curl php-cli php-mbstring git unzip
前提条件をインストールしたら、Composer自体をインストールできます。
[[step-2 -—- downloading-and-installing-composer]] ==ステップ2—Composerのダウンロードとインストール
Composerは、PHPで記述されたinstallerを提供します。 ダウンロードし、破損していないことを確認してから、Composerのインストールに使用します。
ホームディレクトリにいることを確認してから、curl
を使用してインストーラーを取得します。
cd ~
curl -sS https://getcomposer.org/installer -o composer-setup.php
次に、インストーラーがComposer Public Keys / Signaturesページにある最新のインストーラーのSHA-384ハッシュと一致することを確認します。 そのページからハッシュをコピーして、シェル変数として保存します。
HASH=544e09ee996cdf60ece3804abc52599c22b1f40f4323403c44d44fdfdd586475ca9813a858088ffbc1f233e9b180f061
強調表示された値を最新のハッシュに置き換えてください。
次のPHPスクリプトを実行して、インストールスクリプトが安全に実行できることを確認します。
php -r "if (hash_file('SHA384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
次の出力が表示されます。
出力
Installer verified
Installer corrupt
が表示された場合は、インストールスクリプトを再度ダウンロードして、正しいハッシュを使用していることを再確認する必要があります。 次に、コマンドを実行してインストーラーを再度検証します。 検証済みのインストーラーを入手したら、続行できます。
composer
をグローバルにインストールするには、次のコマンドを使用して、Composerを/usr/local/bin
の下にcomposer
という名前のシステム全体のコマンドとしてダウンロードしてインストールします。
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer
次の出力が表示されます。
OutputAll settings correct for using Composer
Downloading...
Composer (version 1.6.5) successfully installed to: /usr/local/bin/composer
Use it: php /usr/local/bin/composer
インストールをテストするには、次を実行します。
composer
そして、Composerのバージョンと引数を表示するこの出力が表示されます。
Output ______
/ ____/___ ____ ___ ____ ____ ________ _____
/ / / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__ ) __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
/_/
Composer version 1.6.5 2018-05-04 11:44:59
Usage:
command [options] [arguments]
Options:
-h, --help Display this help message
-q, --quiet Do not output any message
-V, --version Display this application version
--ansi Force ANSI output
--no-ansi Disable ANSI output
-n, --no-interaction Do not ask any interactive question
--profile Display timing and memory usage information
--no-plugins Whether to disable plugins.
-d, --working-dir=WORKING-DIR If specified, use the given directory as working directory.
-v|vv|vvv, --verbose Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug
. . .
これにより、Composerがシステムに正常にインストールされ、システム全体で利用できることが確認されます。
[。注意]##
Note:このサーバーでホストするプロジェクトごとに個別のComposer実行可能ファイルを使用する場合は、プロジェクトごとにローカルにインストールできます。 NPMのユーザーはこのアプローチに精通しています。 この方法は、システムユーザーがシステム全体にソフトウェアをインストールする権限を持っていない場合にも役立ちます。
これを行うには、コマンドphp composer-setup.php
を使用します。 これにより、現在のディレクトリにcomposer.phar
ファイルが生成され、./composer.phar command
。
で実行できます。
Composerを使用して依存関係を管理する方法を見てみましょう。
[[step-3 -—- using-composer-in-a-php-project]] ==ステップ3—PHPプロジェクトでのComposerの使用
PHPプロジェクトは外部ライブラリに依存することが多く、これらの依存関係とそのバージョンを管理するのは難しい場合があります。 Composerは、依存関係を追跡し、他の人がそれらを簡単にインストールできるようにすることでそれを解決します。
プロジェクトでComposerを使用するには、composer.json
ファイルが必要です。 composer.json
ファイルは、プロジェクトにダウンロードする必要のある依存関係と、各パッケージのインストールが許可されているバージョンをComposerに通知します。 これは、プロジェクトの一貫性を維持し、下位互換性の問題を引き起こす可能性のある不安定なバージョンのインストールを避けるために非常に重要です。
このファイルを手動で作成する必要はありません。そうすると、構文エラーが発生しやすくなります。 require
コマンドを使用してプロジェクトに依存関係を追加すると、Composerはcomposer.json
ファイルを自動生成します。 このファイルを手動で編集することなく、同じ方法で依存関係を追加できます。
Composerを使用してパッケージをプロジェクトの依存関係としてインストールするプロセスには、次の手順が含まれます。
-
アプリケーションに必要なライブラリの種類を特定します。
-
Composerの公式パッケージリポジトリであるPackagist.orgで適切なオープンソースライブラリを調べてください。
-
依存するパッケージを選択します。
-
composer require
を実行して、依存関係をcomposer.json
ファイルに含め、パッケージをインストールします。
デモアプリケーションでこれを試してみましょう。
このアプリケーションの目的は、特定の文をURLに適した文字列(slug)に変換することです。 これは通常、ページタイトルをURLパスに変換するために使用されます(このチュートリアルのURLの最後の部分など)。
プロジェクトのディレクトリを作成することから始めましょう。 これをslugifyと呼びます。
cd ~
mkdir slugify
cd slugify
次に、slugsの生成に役立つパッケージをPackagist.orgで検索します。 Packagistで「スラッグ」という用語を検索すると、次のような結果が得られます。
リスト内の各パッケージの右側に2つの数字が表示されます。 上の数字はパッケージがインストールされた回数を表し、下の数字はパッケージがGitHubにスター付けされた回数を示します。 これらの番号に基づいて検索結果を並べ替えることができます(検索バーの右側にある2つのアイコンを探します)。 一般的に言って、インストール数とスター数が多いパッケージは、非常に多くの人が使用しているため、より安定する傾向があります。 また、パッケージの説明で関連性を確認し、必要なものであることを確認することも重要です。
単純な文字列からスラグへのコンバータが必要です。 検索結果から、パッケージcocur/slugify
は、適切な数のインストールとスターがあり、適切に一致しているようです。 (パッケージは、スクリーンショットが示すよりもページの少し下にあります。)
Packagistのパッケージには、vendor名とpackage名があります。 各パッケージには、GitHubがリポジトリに使用するのと同じ形式の一意の識別子(名前空間)がvendor/package
の形式であります。 インストールするライブラリは、名前空間cocur/slugif
を使用します。 プロジェクトでパッケージを要求するには、名前空間が必要です。
インストールするパッケージが正確にわかったので、composer require
を実行して依存関係として含め、プロジェクトのcomposer.json
ファイルも生成します。
composer require cocur/slugify
Composerが依存関係をダウンロードすると、次の出力が表示されます。
OutputUsing version ^3.1 for cocur/slugify
./composer.json has been created
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 1 install, 0 updates, 0 removals
- Installing cocur/slugify (v3.1): Downloading (100%)
Writing lock file
Generating autoload files
出力からわかるように、Composerは使用するパッケージのバージョンを自動的に決定しました。 ここでプロジェクトのディレクトリを確認すると、composer.json
とcomposer.lock
の2つの新しいファイルと、vendor
ディレクトリが含まれています。
ls -l
Outputtotal 12
-rw-rw-r-- 1 sammy sammy 59 Jul 11 16:40 composer.json
-rw-rw-r-- 1 sammy sammy 2934 Jul 11 16:40 composer.lock
drwxrwxr-x 4 sammy sammy 4096 Jul 11 16:40 vendor
composer.lock
ファイルは、各パッケージのどのバージョンがインストールされているかに関する情報を格納するために使用され、他の誰かがプロジェクトのクローンを作成してその依存関係をインストールする場合に同じバージョンが使用されるようにします。 vendor
ディレクトリは、プロジェクトの依存関係が配置されている場所です。 vendor
フォルダーをバージョン管理にコミットする必要はありません。composer.jsonファイルとcomposer.lockファイルを含めるだけで済みます。
[.note]#すでにcomposer.json
ファイルが含まれているプロジェクトをインストールする場合は、プロジェクトの依存関係をダウンロードするためにcomposer install
を実行します。
#
バージョンの制約を簡単に見てみましょう。 composer.json
ファイルの内容を確認すると、次のように表示されます。
cat composer.json
Output{
"require": {
"cocur/slugify": "^3.1"
}
}
sam
composer.json
のバージョン番号の前に特殊文字^
があることに気付くかもしれません。 Composerは、プロジェクトの安定性を保ちながら柔軟性を提供するために、必要なパッケージバージョンを定義するためのいくつかの異なる制約と形式をサポートしています。 自動生成されたcomposer.json
ファイルで使用されるキャレット(^
)演算子は、semantic versioningに続く、相互運用性を最大化するための推奨演算子です。 この場合、互換性のある最小バージョンとして3.1を定義し、4.0未満の将来のバージョンへの更新を許可します。
一般的に、composer.json
ファイルのバージョン制約を改ざんする必要はありません。 ただし、場合によっては、必要なライブラリのメジャーな新しいバージョンがリリースされてアップグレードする場合、または使用するライブラリがセマンティックバージョニングに従っていない場合など、制約を手動で編集する必要があります。
Composerバージョンの制約がどのように機能するかをよりよく理解するための例をいくつか示します。
拘束 | 意味 | 許可されるバージョンの例 |
---|---|---|
^1.0 |
> = 1.0 <2.0 |
1.0, 1.2.3, 1.9.9 |
^ 1.1.0 |
> = 1.1.0 <2.0 |
1.1.0, 1.5.6, 1.9.9 |
~1.0 |
> = 1.0 <2.0.0 |
1.0, 1.4.1, 1.9.9 |
〜1.0.0 |
> = 1.0.0 <1.1 |
1.0.0, 1.0.4, 1.0.9 |
1.2.1 |
1.2.1 |
1.2.1 |
1.* |
> = 1.0 <2.0 |
1.0.0, 1.4.5, 1.9.9 |
1.2.* |
> = 1.2 <1.3 |
1.2.0, 1.2.3, 1.2.9 |
Composerのバージョン制約の詳細については、the official documentationを参照してください。
次に、Composerで依存関係を自動的に読み込む方法を見てみましょう。
[[step-4 -—- include-the-autoload-script]] ==ステップ4—Autoloadスクリプトを含める
PHP自体はクラスを自動的にロードしないため、Composerには自動ロードスクリプトが用意されています。これをプロジェクトに含めると、自動ロードを無料で取得できます。 これにより、依存関係を簡単に操作できます。
クラスをインスタンス化する前に、PHPスクリプトにvendor/autoload.php
ファイルを含めるだけです。 このファイルは、最初の依存関係を追加するとComposerによって自動的に生成されます。
アプリケーションで試してみましょう。 ファイルtest.php
を作成し、テキストエディタで開きます。
nano test.php
vendor/autoload.php
ファイルを取り込み、cocur/slugify
依存関係をロードし、それを使用してスラッグを作成する次のコードを追加します。
test.php
slugify('Hello World, this is a long sentence and I need to make a slug from it!');
ファイルを保存して、エディターを終了します。
次に、スクリプトを実行します。
php test.php
これにより、出力hello-world-this-is-a-long-sentence-and-i-need-to-make-a-slug-from-it
が生成されます。
依存関係は、新しいバージョンがリリースされたときに更新が必要なので、それを処理する方法を見てみましょう。
[[step-5 -—- updating-project-dependencies]] ==ステップ5—プロジェクトの依存関係を更新する
プロジェクトの依存関係をより新しいバージョンに更新する場合は常に、update
コマンドを実行します。
composer update
これにより、プロジェクトで必要なライブラリの新しいバージョンがチェックされます。 新しいバージョンが見つかり、composer.json
ファイルで定義されているバージョン制約と互換性がある場合、Composerはインストールされている以前のバージョンを置き換えます。 composer.lock
ファイルは、これらの変更を反映するように更新されます。
次のように指定して、1つ以上の特定のライブラリを更新することもできます。
composer update vendor/package vendor2/package2
依存関係を更新した後は、他のユーザーがこれらの新しいバージョンをインストールできるように、必ずcomposer.json
ファイルとcomposer.lock
ファイルをチェックインしてください。
結論
Composerは、すべてのPHP開発者がユーティリティベルトに持つべき強力なツールです。 このチュートリアルでは、Composerをインストールし、単純なプロジェクトで使用しました。 これで、依存関係をインストールおよび更新する方法がわかりました。
プロジェクトの依存関係を管理する簡単で信頼できる方法を提供するだけでなく、コミュニティによって作成されたPHPパッケージを共有および検出するための新しい事実上の標準も確立します。