レンタルサーバでPHPライブラリを導入したいときに便利なのが、PHPのパッケージ管理ツールComposerです。
ただし、ローカル開発環境とは違って、レンタルサーバでは root 権限が使えなかったり、グローバル領域へインストールできなかったりすることがあります。そのため、自分のホームディレクトリ配下に Composer を設置して使う形が基本になります。
この記事では、レンタルサーバで Composer を使う方法を、初心者向けにわかりやすく解説します。ホームディレクトリへのインストール手順、確認方法、よくある注意点まで順番に整理しています。
Composerとは？
Composerは、PHPで使うライブラリやパッケージを管理するためのツールです。
たとえば、外部ライブラリを使いたいときに、必要なパッケージを自動で取得し、依存関係も含めてまとめて管理できます。PHP開発では広く使われている基本ツールの1つです。
レンタルサーバでComposerを使うときの考え方
ローカルPCやVPSでは、Composerをシステム全体にインストールすることもありますが、レンタルサーバでは権限の都合でそれが難しい場合があります。
そのため、レンタルサーバでは自分のホームディレクトリ配下に Composer を置き、必要に応じて PATH の通ったディレクトリから呼び出す方法が扱いやすくなります。
Composer公式でも、ユーザー権限で使う場合は、実行ファイルを任意のディレクトリに配置し、PATH が通っている場所に置けばグローバル風に使えると案内しています。
レンタルサーバでComposerをインストールする手順
ここでは、ホームディレクトリ配下に Composer を設置する一般的な流れで説明します。
1. ホームディレクトリへ移動する
cd ~まずは自分のホームディレクトリに移動します。以後の作業は、この配下で進めると管理しやすくなります。
2. bin ディレクトリを作成する
mkdir -p binbin ディレクトリは、コマンドとして使いたい実行ファイルを置く場所としてよく使われます。すでに存在する場合は、そのままで問題ありません。
3. Composerのインストーラーを取得する
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"Composer公式では、この方法でインストーラーを取得する手順が案内されています。
4. インストーラーを検証する
php -r "if (hash_file('sha384', 'composer-setup.php') === 'ここに公式サイトの最新SHA-384値を入れる') { echo 'Installer verified'.PHP_EOL; } else { echo 'Installer corrupt'.PHP_EOL; unlink('composer-setup.php'); exit(1); }"安全性を重視するなら、インストーラーのハッシュを検証してから実行するのが安心です。Composer公式でも、ダウンロードページでその時点の SHA-384 値を案内しています。
なお、このハッシュ値は固定ではありません。使うときは、必ず公式ダウンロードページに掲載されている最新値を確認してください。
5. Composerを bin ディレクトリへインストールする
php composer-setup.php --install-dir=bin --filename=composerこの方法なら、composer.phar を後からリネームして移動する必要がありません。Composer公式でも、--install-dir と --filename を使って配置先とファイル名を指定する方法が案内されています。
6. インストーラーを削除する
php -r "unlink('composer-setup.php');"インストールが終わったら、インストーラーは削除しておきます。
7. Composerのバージョンを確認する
~/bin/composer -Vバージョン情報が表示されれば、Composerの設置は完了です。
PATHが通っている場合の使い方
サーバー環境によっては、~/bin に PATH が通っていて、単に composer だけで実行できることがあります。
composer -Vもしこれで動かない場合は、フルパスで実行してください。
~/bin/composer -VPATH が通っていないなら、シェル設定ファイルで追加する方法もありますが、レンタルサーバでは利用中のシェルや設定権限に左右されるため、無理に変更せずフルパスで使う方法でも問題ありません。
実際にComposerを使う方法
Composerを設置したら、ライブラリを使いたいディレクトリへ移動してコマンドを実行します。
composer.json がある場合
既存プロジェクトなら、通常はプロジェクト直下に composer.json があります。そのディレクトリで次のように実行します。
~/bin/composer installこれで、composer.json に書かれた依存パッケージがインストールされます。
新しくパッケージを追加したい場合
~/bin/composer require vendor/package-nameこのコマンドで、指定したパッケージを追加できます。
うまく動かないときの確認ポイント
PHPコマンドが使えるか確認する
ComposerはPHPで動くため、まず php コマンドが使える必要があります。
php -vこれでPHPのバージョン情報が表示されない場合は、サーバーのPHP CLIが使えないか、PATHの問題がある可能性があります。
composer に実行権限があるか確認する
通常は問題になりにくいですが、環境によっては実行権限が必要な場合があります。
chmod +x ~/bin/composerPATHが通っていない場合はフルパスで実行する
composer だけで動かない場合は、まず ~/bin/composer で試してください。
診断コマンドを使う
Composer公式では、問題があるときは composer diagnose を実行することを案内しています。
~/bin/composer diagnoseまた、インストーラーのチェックだけを実行する方法も案内されています。
curl -sS https://getcomposer.org/installer | php -- --checkレンタルサーバでComposerを使うときの注意点
共有サーバーでは制限があることがある
レンタルサーバでは、メモリ制限やプロセス制限、外部通信制限などの影響で、ローカル環境のように自由に動かないことがあります。
本番環境で直接更新する場合は注意する
本番環境でそのまま composer update を実行すると、依存パッケージが一気に変わることがあります。基本的には、必要性を理解したうえで慎重に実行した方が安全です。
まずは install を優先する
既存の composer.lock があるプロジェクトなら、通常は composer update より composer install を使う方が安定します。
まとめ
レンタルサーバで Composer を使う場合は、ホームディレクトリ配下に設置して使う形が基本です。
~/binのような自分用ディレクトリを用意する- Composer公式のインストーラーを取得する
- 可能ならハッシュを検証してから実行する
--install-dirと--filenameで配置先を指定する- 動かないときは
php -v、composer -V、composer diagnoseを確認する
最小手順だけなら短く済みますが、安全性と実用性まで考えると、インストーラー検証と確認手順まで押さえておく方が安心です。レンタルサーバでも、手順を整理して進めれば Composer は十分利用できます。
