Composer で PHP のバージョンを確認・指定する方法｜composer.json の書き方

Composer のプロジェクトで、必要な PHP のバージョンを確かめる方法と、composer.json での指定のしかた。PHP を上げる前の確認にも使える。

Composer を使っているプロジェクトでは、PHP を上げる前に「依存しているパッケージが新しい PHP に対応しているか」を確かめられる。確認と指定のしかたをまとめた。

この記事の要点

必要な PHP の版を書く場所

composer.json の require に、プロジェクトが動く PHP の版を書く。

コマンド	分かること
`php -v`	コマンドで動く PHP の版
`composer check-platform-reqs`	必要な PHP の版と拡張が、今の環境にそろっているか
`composer why-not php 8.4`	PHP 8.4 にすると困るパッケージ
`composer outdated`	新しい版が出ているパッケージ

コマンドの PHP と Web の PHP は違うことがある

php -v はコマンドで動く PHP の版。Web で動く PHP（PHP-FPM など）とは別の版のことがある。サイトに関係するのは Web の側。

そのプロジェクトが動く PHP の版を示すためです。
Composer は、この指定に合わない環境ではインストールを止めます。

PHP 8.4 にしたときに、困るパッケージとその理由が一覧で出ます。
PHP を上げる前の洗い出しに使えます。

この記事の情報

2026年10月22日時点の公開情報にもとづく。最新は各公式のページを確認すること。

URL を入れるだけで、PHP2Shell の危険度と今やることが分かる。移行の相談もできる。

編集部