ケケンタ

Composerってよく見かけるけど、イマイチ使い方がわからないな……

今回はこうしたお悩みをお持ちの方へ向けて

PHPのWebアプリ開発にComposerを導入して
パッケージライブラリを使用する方法

を解説します。

Composerのインストールがお済みでない場合、まずは以下の記事をご覧ください。

あわせて読みたい

【Windows】Composerのインストール方法｜エラー時の対処も解説 こんにちは！　ケケンタです。 この記事ではPHPでWebアプリ開発を行うなら必須の Composerのインストール方法（Windows版） を解説していきます。 PHPを始めたばかりの…

Composerがインストールされているかの確認

念のため、まずはComposerがインストールされているかどうかを確認してみましょう。

STEP

コマンドプロンプトを起動する

Windowsキーを押してから検索窓にcmdと入力して、Enterキーを押します。

すると、コマンドプロンプトが起動します。

STEP

「composer」コマンドを実行

続いてcomposerと入力して、Enterキーを押します。

数秒ほど待って、以下のような表示が出ればComposerは無事にインストールできています。

もしComposerのインストールができていなければ、まずは以下の記事をご覧ください。

あわせて読みたい

【Windows】Composerのインストール方法｜エラー時の対処も解説 こんにちは！　ケケンタです。 この記事ではPHPでWebアプリ開発を行うなら必須の Composerのインストール方法（Windows版） を解説していきます。 PHPを始めたばかりの…

Composerを開発プロジェクトで使用する

Composerでパッケージを導入する大まかな手順は以下の通りです。

STEP

composer.jsonファイルを新規作成する

Composerを導入したいプロジェクトディレクトリ内にcomposer.jsonファイルを新規作成します。

（例）TODOアプリ開発用に「todo」ディレクトリを用意している場合

STEP

composer.jsonにインストールしたいパッケージ名：バージョンを記載する

以下はログを取得するのに便利な「monolog」というパッケージライブラリをインストールする場合の記述です。

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

バージョンを「*」にすることで、その時点での最新バージョンをインストールしてくれます。

パッケージ名の表記や最新以外のバージョンについては、該当するパッケージ（今回だと「monolog」）のGithubのページでご確認いただけます。
https://github.com/Seldaek/monolog

パッケージ名の表記

パッケージにもよりますが、ページを少し下へスクロールした辺りにある「README」の最初の方に記載されていることが多いです。

バージョン確認（最新以外のバージョンを使用したいとき）

https://github.com/Seldaek/monologの右側メニューにバージョン情報が記述されています。

STEP

ターミナルで「composer install」コマンドを実行する

プロジェクトディレクトリ内でターミナルを起動し、composer installコマンドを実行します。

Windows11をお使いの場合、
プロジェクトディレクトリ内で「右クリック」→「ターミナルで開く」をクリックする
とターミナルを起動することができます。

composer installを実行

「vendor」ディレクトリと「composer.lock」ファイルが
作成されていれば成功

composer.lockファイルについて詳しく知りたい方は以下の記事をご覧ください。

あわせて読みたい

【PHP】composer.lockファイルとは？composer.jsonとの違いを解説 Composerを使うときにcomposer.lockファイルって出てくるけど、これってどんなファイルなの？composer.jsonとどう違うの？ 今回はこのような疑問にお答えするため、 Com…

STEP

パッケージを使用したいファイルで「autoload.php」ファイルを読み込む

ここまでの手順で、Composerが自動的にパッケージをプロジェクトディレクトリ内にインストールしてくれました。

あとはパッケージを使用したいファイル内にautoload.phpファイルを読み込めばOKです。

autoload.php（オートロード）とは？

autoload.phpファイルとは、Composerの機能のひとつ「オートロード」を使用するためのファイルです。

通常、PHPで何らかのパッケージを使用する際には以下のように個別にファイルを読み込むコードを記述する必要があります。

require_once "hogehoge.php";

しかし、Composerの「オートロード」を使用することで、各パッケージの読み込みが自動的に行なわれるため、上記のようなコードを書く手間や書き忘れが防げます。

具体的には、パッケージを使用したいファイルの冒頭で以下のように記述をします。

require_once 'vendor/autoload.php';

autoload.phpファイルまでのパスは、パッケージを使用したいファイルを起点とした相対パスで記述しています。

STEP

使用する「パッケージのクラス」を読み込む

最後に、使用する「パッケージのクラス」をuseを用いて読み込みます。

以下はMonologを使用するときの一例
※実際には、実装したい機能に合わせて必要なクラスを読み込んでください。

require_once 'vendor/autoload.php';

use \Monolog\Logger;
use \Monolog\Handler\StreamHandler;

これでパッケージのクラスを利用して実装を進められるようになりました！

ケケンタ

以上が開発プロジェクトでComposerを利用する流れです！

ここまでの解説についてひとつ注意点をあげると、上記の流れはプロジェクトごとに行う必要があります。

コンピュータやサーバへComposerをインストールするのは一度だけでOKですが、実際にComposerを使用してパッケージ管理を行うときは、上記の手順を踏んでプロジェクトごとにComposerを導入する必要があります。

（すでに分かっている方にとっては「何を言っているんだ……？」と、逆に混乱を招きかねないことは重々承知しているのですが、僕が初めてComposerを使用したときに戸惑った部分だったため、初心者の方向けに念のため補足させていただきました）

Composerを利用してパッケージを追加・更新・削除する方法

Composerでは、composer installコマンドを実行するとcomposer.lockファイルが作成されます。

そのプロジェクト内で初めてcomposer installコマンドを実行すると、composer.jsonファイルが参照され、composer.lockファイルとvendorディレクトリが自動作成されます。

しかし、composer.lockファイルがある状態でcomposer installコマンドを実行すると

Composerはcomposer.jsonファイルは参照せず、composer.lockファイルを利用してパッケージのインストールを行います。

これはつまり、composer.jsonファイルを修正してcomposer installコマンドを実行しても、その修正内容がプロジェクトに反映されないことを意味します。

ケケンタ

それなら、どうすればパッケージの追加・更新・削除ができるの……？

という点を、本章でご紹介します。

あわせて読みたい

【PHP】composer.lockファイルとは？composer.jsonとの違いを解説 Composerを使うときにcomposer.lockファイルって出てくるけど、これってどんなファイルなの？composer.jsonとどう違うの？ 今回はこのような疑問にお答えするため、 Com…

Composerでパッケージの「追加・更新・削除」をするときはコマンドを使う

一度composer installコマンドを実行してcomposer.lockファイルが作成されたあとは

コマンドを使用してパッケージの追加・更新・削除を行います。

パッケージを「追加」する

パッケージを追加するときはrequireコマンドを使用します。

コマンドの形式

composer require パッケージ名

（例）intervention/imageを追加する

composer require intervention/image

（例）intervention/imageを追加する（バージョンを指定）

composer require intervention/image:3.1.2

上記によってパッケージ「intervention/image」が追加され、composer.jsonファイルも自動的に修正されます。

パッケージを「削除」する

パッケージを削除するときはremoveコマンドを使用します。

ただし、削除対象のパッケージに依存するパッケージは削除されずに残ってしまう点に注意してください。
例えば、パッケージAを削除しても、Aに依存してインストールされたパッケージBは削除されません。

参考：Composer でパッケージの削除は composer remove が良いと思ったらそうでも無かった[Qiita]

コマンドの形式

composer remove パッケージ名

（例）intervention/imageを削除する

composer remove intervention/image

パッケージを「更新」する

パッケージを削除するときはupdateコマンドを使用します。

コマンドの形式

composer update パッケージ名

（例）intervention/imageを更新する

composer update intervention/image

composer update --dry-run パッケージ名

Composerを活用してPHP開発を効率化しよう！

以上がComposerの基本的な使用方法です。

ComposerはPHPのパッケージライブラリを自動で管理してくれる便利なツールです。

Composerを利用することで、PHP開発にパッケージを導入するのが簡単になり、結果的に開発効率が向上します。

初心者の方にとってはハードルが高い側面もあるかとは思いますが、まずはローカル環境で試すなどして、少しずつ慣れていくことをおすすめします。

ケケンタ

脱初心者を目指すならComposerの利用は欠かせません。
この記事をご参考に、ぜひ挑戦してみてください！

当ブログではPHPやWordPress、Web制作に関する情報を発信しています。

ご興味のある方は、ぜひほかの記事もご覧いただけるとうれしいです！

あわせて読みたい

【Windows】Composerのインストール方法｜エラー時の対処も解説 こんにちは！　ケケンタです。 この記事ではPHPでWebアプリ開発を行うなら必須の Composerのインストール方法（Windows版） を解説していきます。 PHPを始めたばかりの…

あわせて読みたい

【PHP】composer.lockファイルとは？composer.jsonとの違いを解説 Composerを使うときにcomposer.lockファイルって出てくるけど、これってどんなファイルなの？composer.jsonとどう違うの？ 今回はこのような疑問にお答えするため、 Com…

ケケンタ

こんにちは！　ケケンタです。

この記事ではPHPでWebアプリ開発を行うなら必須の

Composerのインストール方法（Windows版）

を解説していきます。

PHPを始めたばかりの方にとっては難しく感じる内容もあるかとは思いますが、ComposerはPHPでWebアプリを開発していくならいずれ必ず使うことになるため、この記事を参考にぜひインストールから挑戦してみてください！

Composerインストール後、実際にパッケージ管理を行うための基本的な使用方法は以下の記事をご覧ください。

あわせて読みたい

【初心者向け】Composerの使い方を丁寧に解説！【PHP】 Composerってよく見かけるけど、イマイチ使い方がわからないな…… 今回はこうしたお悩みをお持ちの方へ向けて PHPのWebアプリ開発にComposerを導入してパッケージライブ…

Composerとは？

Composerとは、PHPのパッケージライブラリを管理するためのツールです。

パッケージライブラリは、簡単に言うと便利な機能（関数やクラスなど）がすでに実装されている機能のまとまりのことです。

例えば、Goutteというパッケージライブラリを使用すると、スクレイピング（Web上から情報を自動収集する技術）を比較的簡単に実装することが可能です。

Composerを使用するメリット

前述のように、ComposerはPHPのパッケージライブラリを管理するためのツールです。

Composerを用いることで得られるメリットはいくつかありますが、その中の３つをご紹介します。

①パッケージ管理が楽になる

PHPのパッケージを利用することで、Webアプリ開発が効率化できます。

ですがその一方、パッケージを利用するためには

「Aというパッケージを使用するにはBというパッケージもインストールしなくてはいけない」

といった、いわゆる「依存関係」を正確に把握する必要があります。

これを人の手だけで管理しようとすると非常に大変です。

Composerはこの依存関係の管理を行ってくれるツールのため、依存関係を意識しなくてもコマンドひとつで簡単にパッケージをインストールすることができます。

ケケンタ

これがComposerを使用する最たるメリットです！

②composer.lockファイルをメンバー間で共有することで簡単に同じパッケージ管理ができる

composer.lockファイルはどのバージョンのライブラリをインストールしたかといった情報が記録されたファイルです。

このファイルを開発メンバー間で共有することにより、全員が同じパッケージを簡単に利用することが可能です。

あわせて読みたい

【PHP】composer.lockファイルとは？composer.jsonとの違いを解説 Composerを使うときにcomposer.lockファイルって出てくるけど、これってどんなファイルなの？composer.jsonとどう違うの？ 今回はこのような疑問にお答えするため、 Com…

③開発環境ごとにパッケージライブラリをインストールできる

Webアプリの開発を進めていると、開発環境では必要なパッケージが、本番環境では不要という場面に遭遇することがあります。

Composerでは、「開発環境でしか使用しないパッケージを指定する」ということが可能なため、開発環境と本番環境のすみわけが簡単になります。

Composerのインストール方法

前提として、Composerを利用するためにはあらかじめお使いのパソコンやサーバーにPHPをインストールしておく必要があります。

Composer自体のインストールは決して難しくなく、基本的にはインストーラの画面にそって操作していくことですぐに完了できます。

STEP

公式サイトでインストーラをダウンロードする

まずは公式サイトからComposerのインストーラをダウンロードします。

以下のリンク先へアクセスし、「Composer-Setup.exe」をクリックします。

Composer公式サイト（Windows用インストーラページ）

STEP

インストーラを起動する

インストーラをダウンロードしたら、インストーラ（Composer-Setup.exe）をダブルクリックして起動します。

STEP

インストーラの画面にしたがって操作を進める

以下より掲載する画像を参考に、インストール操作をお進めください。

Composerとひもづけるphp.exeファイルを指定します。
※以下はXAMPP環境のphp.exeを使用する場合の表示です。

「Next」を押したときに「Composer Security Warning」という画面が表示された場合、php.iniを修正する必要があります。
詳しい修正手順はこちらの章をご覧ください。

公式ドキュメントを見たい場合は
「View online documentation」にチェックを入れます。

ケケンタ

以上でインストーラによるインストール作業は完了です！

STEP

インストールが成功しているか確認する

Windowsキーを押してから検索窓に「cmd」と入力して、Enterキーを押します。

すると、コマンドプロンプトが起動します。

続いてcomposerと入力して、Enterキーを押します。

数秒ほど待って、以下のような表示が出ればComposerは無事にインストールできています。

【補足】「Composer Security Warning」という画面が表示されてインストールできない場合

PHPでopenssl (SSLライブラリ)を利用する拡張が有効になっていないと、「Composer Security Warning」という画面が表示されてインストールを進めることができません。

そのようなときは、以下の手順にしたがってphp.iniを修正し、改めてインストーラを起動しましょう。

[変更前]
;extension=php_openssl.dll

[変更後]
extension=ext/php_openssl.dll

ケケンタ

上記の修正が完了したら、再度インストーラを起動してインストール操作を進めてみましょう！

Composerを導入してパッケージを活用しよう！

以上がComposerをお使いのパソコンやサーバへインストールする方法です。

実際にComposerを使用する場合は、compose.jsonファイルを用意したり、コマンドプロンプトでコマンドを実行したりといくつか行うべきことがあります。

しかし、最初はハードルを感じても、実際にやってみると意外と簡単に導入できることがお分かりいただけるかと思います。

ケケンタ

この記事がComposerを使い始める第一歩の助けとなったなら幸いです！

当ブログではPHPやWordPress、Web制作について情報を発信しています。

ご興味のある方はぜひほかの記事もご覧いただけるとうれしいです。

あわせて読みたい

【初心者向け】Composerの使い方を丁寧に解説！【PHP】 Composerってよく見かけるけど、イマイチ使い方がわからないな…… 今回はこうしたお悩みをお持ちの方へ向けて PHPのWebアプリ開発にComposerを導入してパッケージライブ…

あわせて読みたい

【PHP】composer.lockファイルとは？composer.jsonとの違いを解説 Composerを使うときにcomposer.lockファイルって出てくるけど、これってどんなファイルなの？composer.jsonとどう違うの？ 今回はこのような疑問にお答えするため、 Com…