Rocky Linux 8にPHP Composerをインストールする方法

PHP Composerは、PHPで最も使用されている依存関係マネージャーです。プロジェクトに必要な依存関係を宣言し、それを管理（インストール/更新）してくれます。

依存関係のダウンロード、インストール、更新は面倒で、実際にコードを書くことから気をそらす可能性があります。依存関係マネージャーは、それを処理することで開発者としての生活を楽にしてくれます。

Composerが登場する前は、PEARやPHPパッケージマネージャーなど、プロジェクトの依存関係を管理するためのいくつかの異なるオプションがありました。現在では、ComposerがPHPにおける依存関係管理の事実上の標準となっています。

まだPEARやPHPパッケージマネージャーを使用している場合は、変更の時期かもしれません。Composerを使用する理由はいくつかあります。

• PHPで書かれており、追加のソフトウェアインストール（Pythonなど）が不要です。
• グローバルおよびローカル/プライベートパッケージの両方をサポートしています。
• 数千のライブラリやアプリケーションがすでに依存しているため、Composerを使用することでパッケージや更新を簡単に見つけることができます。

前提条件

Rocky Linux 8.4にPHP Composerをインストールするには、以下が必要です。

• システムにPHPバージョン5.3以降がインストールされていること（Phar拡張機能を実行できる必要があります）。
• インストールにはrootアクセスが必要です。

システムの更新

他のことをする前に、システムのパッケージが最新であることを確認してください。以下のコマンドを実行してシステムパッケージを更新します。

sudo dnf check-update

sudo dnf update -y

Rocky Linux 8.4にPHPをインストールする

Composerをインストールする前に、システムにPHPとPHPインタープリターがインストールされている必要があります。

デフォルトでは、AppStreamリポジトリにはPHP 7.2、7.3、および7.4が含まれています。以下のコマンドを実行して、利用可能なPHPバージョンをすべてリストできます。

sudo dnf module list php

以下のような出力が表示されます。

このガイドでは、PHP 7.4をインストールします。ニーズに合ったPHPバージョンを選択する必要がありますが、このガイドだけでなく、互換性レポートに基づいて決定を行うことを確認してください。

以下のコマンドを実行して、PHP 7.4を有効にしてインストールします。

sudo dnf module enable php:7.4

sudo dnf install php php-cli php-gd php-curl php-zip -y

sudo dnf install php-mbstring php-opcache php-intl php-mysqlnd -y

以下のコマンドを実行して、PHPが正しくインストールされたかどうかを確認できます。

php -v

以下の出力が得られるはずです。

Rocky Linux 8.4にPHP Composerをインストールする

システムにPHPのバージョンがインストールされたので、Composerバイナリをダウンロードしてインストールするために使用できます。

まず、以下のコマンドを実行してComposerの最新バージョンをダウンロードします。

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

次に、ダウンロードしたファイルが破損していないことを確認します。ダウンロードしたファイルが破損していないことを常に確認する必要があります。Composerは非常に敏感で、エラーが発生するとComposerの使用方法に問題が生じる可能性があります。以下のコードを実行して、インストーラーファイルが破損していないことを確認します。

HASH=`curl -sS https://composer.github.io/installer.sig`

echo $HASH

php -r "if (hash_file('SHA384', '/tmp/composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

検証が成功すると、「Installer verified」というテキストが表示されます。期待される出力が得られない場合、ファイルが破損している可能性が高く、再度ダウンロードを試みる必要があります。その後、期待される「Installer verified」出力が得られるまで検証プロセスを繰り返します。

これで、システムにComposerをインストールするための2つのオプションがあります。

オプション1は、Composerをシステム全体にインストールすることです。これにより、システムの任意のディレクトリからアクセスでき、どこでも使用できます。このオプションを選択する場合は、Composerをコマンドラインツールとして使用したい場合に使用します。

このオプションを選択した場合、以下のコマンドを実行します。

sudo php composer-installer.php --filename=composer --install-dir=/usr/local/bin 

上記のコマンドは、 /usr/local/bin に「composer」という名前のコマンドでComposerをグローバルにインストールします。

以下のコマンドを実行して、Composerが正しくインストールされたかどうかを確認できます。

composer

以下の出力が得られるはずです。

オプション2は、現在のディレクトリにComposerをローカルにインストールすることです。これにより、この特定のプロジェクトでのみ使用されます。

Composerをローカルにインストールするには、以下のコマンドを実行します。

sudo php composer-setup.php

上記のコマンドは、現在のディレクトリにComposerをローカルにインストールし、この特定のプロジェクトでのみ使用されます。Composerは、./composer.phar を実行することで使用できます。

PHP Composerのテスト

Composerをインストールしたので、これを使用してComposerインストールをテストできる新しいプロジェクトを作成できます。

作業するプロジェクトごとに別のディレクトリを作成することは、一般的なルールです。以下のコマンドを実行して、テストプロジェクト用の新しいディレクトリを作成し、新しく作成されたディレクトリに移動します。

cd && mkdir php-composer-test && cd php-composer-test

以下のコマンドを実行して、Composerで新しいプロジェクトを初期化できます。

composer init

上記のコマンドは、選択したすべての詳細で新しいプロジェクトを初期化します。

composer initコマンドは、以下のように現在のディレクトリに新しいcomposer.jsonファイルも作成します。これは、プロジェクトの要件を含むJSON形式のファイルです。Composerは、このファイルを使用してプロジェクトに必要な依存関係をインストールします。

次に、プロジェクトにパッケージをロードする時が来ました。https://packagist.orgにアクセスして、プロジェクトにインストールするパッケージを検索してください。

たとえば、文字列からストップワードを削除するのに役立つRemove Stop Wordsパッケージをインストールしたい場合、Packagistで「Remove Stop Words」という用語を検索すると、以下の結果が表示されるはずです。

新しいパッケージを追加するには、composer requireコマンドを実行し、現在のプロジェクトにロードしたいパッケージ（バージョンなし）を選択します。

composer require rap2hpoutre/remove-stop-words

Composerは、自動的に使用するパッケージのバージョンを決定します。Composerは、Packagistから現在のディレクトリにパッケージをダウンロードし、このパッケージの内容を抽出します。

また、composer.jsonファイルを新しいパッケージの詳細で更新します。新しいファイルcomposer.lockと新しいvendorディレクトリも作成されます。

composer.lockファイルは、Composerが現在のプロジェクトにインストールされているパッケージのバージョンをロックするために使用されます。このファイルは、同じパッケージの他のインストールとの競合を避けるため、またはプロジェクトをクローンする際に使用されます。vendorディレクトリには、プロジェクトに必要なすべての依存関係が含まれています。

プロジェクトの依存関係を更新するには、composer updateコマンドを実行します。Composerは、最初にcomposer.lockファイルを見て、すでにインストールされているパッケージのバージョンを確認し、その後、Packagistで利用可能な最新バージョンでこのパッケージを更新します。

composer update

サンプル出力:

特定のパッケージを更新するには、以下のコマンドを実行します。

composer update vendor/package

特定のパッケージを削除するには、以下のコマンドを実行します。

composer remove vendor/package

たとえば、Remove Stop Wordsパッケージがもう必要ない場合、以下のコマンドを実行してプロジェクトからアンインストールできます。

composer remove rap2hpoutre/remove-stop-words

サンプル出力:

注意: vendorディレクトリやその内容を削除しないことを強くお勧めします。このディレクトリには、アプリケーションを実行するためにComposerでインストールする必要があるすべての依存関係が含まれています。

結論

この記事では、Rocky Linux 8.4にPHP Composer PHP依存関係マネージャーをインストールして、新しいプロジェクトを初期化し、新しいパッケージをロードし、既存のパッケージを更新またはアンインストールする方法を学びました。また、プロジェクトの依存関係を管理するために使用される基本的なComposerコマンドも学びました。

質問やフィードバックがある場合は、下にコメントを残してください。