サーバーやローカル環境でPHPを使っているとき、現在のPHPのバージョンを正確に把握しておくことはとても重要です。特に環境構築やアップデートを行う際、バージョンの違いによる不具合やセキュリティリスクを未然に防ぎたいものです。この記事では、「PHP バージョン 確認 コマンド」というキーワードで検索する方のために、CLI版やブラウザ版など複数の方法を、具体的なコマンドと解説付きでわかりやすく整理しています。
PHP バージョン 確認 コマンドを使う基本的な方法
PHPのバージョンを確認するもっとも基本的な方法は、コマンドラインで確認することです。環境構築直後やサーバーのSSH接続が可能な場合、CLI（コマンドラインインターフェース）で以下のコマンドを実行することで現在のPHPバージョンを確認できます。主に「php -v」および「php –version」が使われます。出力にはバージョン番号、ビルド日時、CLIかFPMかなどの情報が含まれており、どのPHPが動作しているかを判断するための重要な手がかりになります。さらに、構成ファイルの読み込みパス（php.ini）や拡張モジュール状況なども併せて確認する方法を後述します。
php -v コマンドの実行
最も簡単な方法として、ターミナルやSSHで「php -v」を実行します。これにより「PHP 8.x.x (cli) (built: …)」などの形式で情報が表示され、PHPのバージョン、動作モード（CLI）、ビルド日などが一目で確認できます。複数バージョンがインストールされている環境では、デフォルトで使われるPHPのバイナリがどれかを把握するのに役立ちます。
php –version の使用
「php –version」は「php -v」とほぼ同じ出力をします。バージョン番号やビルド情報などが表示され、マイナーな差としてオプション形式の違いのみです。互換性やスクリプト内での検査、自動化ツールでの使用時にはこちらの表記が好まれることもあります。
複数PHPバージョンがあるときの区別
サーバーに複数のPHPバージョンがインストールされている場合、CLIで表示されるバージョンとWebサーバーで使われているバージョンが異なることがあります。例えば、Apacheやnginxで動くPHP-FPMやモジュール版PHPがCLIと別バージョンの場合、それぞれでPHPの動作や対応状況が異なり得ます。そのためCLIとWebで両方確認することが望ましいです。
Webサーバー側でPHPバージョンを確認する方法
Webサイトで使われているPHPのバージョンを直接確認したい場合、コマンドラインしかアクセスできない方法に加えて、ブラウザ経由で情報を取得する方法があります。サーバーの設定やホスティング環境によっては、CLIの情報だけでは足りないことがあるため、Webサーバー側の状況もしっかり把握しておくことが必要です。
phpinfo() 関数を使う
最も代表的な方法が、Webサイト内にスクリプトを置いて phpinfo() を実行する方法です。この関数を呼び出すと、PHPのバージョンだけでなく、ロードされている拡張モジュール、設定ファイルの場所、環境変数など非常に詳しい情報が表示されます。ただし公開しているサイトでこの情報を表示するとセキュリティ上のリスクがあるため、表示後はファイルを削除またはアクセス制限をかけることが重要です。
phpversion() 関数でバージョンのみ取得
バージョンだけを簡単に知りたいなら phpversion() 関数が便利です。Webビューにこの関数を含む小さなスクリプトを置くことで、純粋なバージョン番号のみを取得できます。phpinfo() より情報量は少ないため公開しても比較的安全ですが、それでも外部に知られて良い情報だけ表示するよう注意が必要です。
CMS（WordPress等）での確認方法
WordPressなどを使っている環境では、管理画面にPHPバージョンが表示されることがあります。たとえばサイトのヘルスチェック機能やサーバー情報タブで確認可能です。また、ホスティング提供側が管理パネルでPHPバージョンを切り替えられる場合、その設定画面で現在のバージョンを確認できます。CLIや直接のファイル操作が難しいケースではこの方法が有効です。
OS別・環境別で使う確認コマンド集
Linux／macOS／Windows／ホスティング環境など、PHPを動かしている環境によってコマンドが少し異なることがあります。ここではOS別およびホスティング環境別に使われる代表的コマンドを整理し、自分の環境に合った確認方法を把握できるようにしています。
Linuxでの確認方法
Linuxサーバーではターミナルを開いて CLI を使う方法が標準です。「php -v」「php –version」でまずバージョンを確認します。さらに詳細フォーマットでの情報として「php -i」を使い、「grep」コマンドで出力を絞るとモジュールや構成ファイルの読み込み先なども分かります。PHP-FPMを使っている場合は「php-fpm8.x -v」などで FPM 側のバージョンを確認することができます。
Windowsでの確認方法
Windows環境ではコマンドプロンプトまたは PowerShell を使い、「php -v」あるいは「php –version」を実行します。ただし php.exe が PATH に含まれていないと「php は内部コマンドまたは外部コマンドとして認識されません」と表示されることがあります。その場合は php.exe の絶対パスを指定するか、環境変数 PATH に PHP の bin フォルダを追加する必要があります。
Dockerや仮想環境での確認
Docker コンテナや仮想マシンを使っている場合、コンテナ内または仮想環境内で「php -v」「php –version」を実行します。Dockerfile を使って PHP イメージを構築しているなら、Dockerfile 内で指定されたバージョンを確認することも重要です。また、ホスティングサービスや PaaS、サーバーレス環境を使っている場合、それらのパネル設定やダッシュボードで PHP バージョン情報を確認できることがあります。
詳細情報の確認コマンドと応用例
バージョン番号だけでなく、「スレッドセーフか non-thread-safe か」「ビルドアーキテクチャ (32bit/64bit)」「php.ini のロード先」「拡張モジュールの有無」なども確認しておいたほうが良いです。これらの情報は環境構築やプラグイン動作などに影響することがあります。以下に応用例をいくつか紹介します。
php -i を使って設定全体を表示
「php -i」と入力すると phpinfo 関数と似た内容が CLI によって表示されます。設定ファイルの場所、読み込まれている拡張モジュール、ビルドオプションなどが含まれ、詳細な診断に役立ちます。出力が長くなるため scrolling が必要ですが、「grep」などと組み合わせて必要な部分のみ抽出するのが一般的です。
php –ini で php.ini の読み込みパスを確認
「php –ini」と実行すると、PHP がどの php.ini ファイルを読み込んでいるかが表示されます。CLI 用の ini と Web 用の ini が異なることが多いため、どちらがどの設定を使っているかを把握するために頻繁に使われます。設定変更が反映されない場合、このコマンドの出力をチェックすれば原因の手がかりになります。
拡張モジュールの有無を確認する（php -m）
特定の拡張モジュールが使えるかどうかを確かめたい場合、「php -m」でロードされているモジュール一覧を表示できます。Webアプリケーションやフレームワークによっては特定モジュールが必須となることがあるため、コマンド出力でモジュール名がないときはインストールや有効化を検討します。
バージョン比較や自動スクリプトでのチェック
バージョンごとの比較をスクリプトで自動化したいときは、PHP の定数を使う方法があります。例えば PHP_VERSION、PHP_VERSION_ID、PHP_SAPI を使えばバージョン情報や実行サーバーの種類を判別できます。またシェルスクリプトで 「version_compare」関数を使うことで、必要バージョンと現在のバージョンを比較し、条件によって処理を分岐することも可能です。
よくあるトラブルとその対処
PHP バージョンの確認時に遭遇しやすいトラブルと、その原因、対策も押さえておくと作業がスムーズになります。バージョンミスマッチ、PATH設定、権限の問題など、初心者にもわかりやすく整理しています。
CLI 表示と Web 表示のバージョンが異なる
CLI で確認したバージョンと phpinfo() や Webサイト上で表示されるバージョンが異なることがあります。これは Web サーバーが PHP-FPM やモジュール版 PHP を使っており、CLI とは別のバイナリを参照しているためです。どちらがサイトに影響するかを理解し、必要なら Web サーバーの設定を確認することが重要です。
php コマンドが「見つからない」と表示される
Windows や Linux で「php が内部コマンドとして認識されない」「command not found」などのエラーが出ることがあります。これは PHP がインストールされていなかったり、PATH 環境変数に PHP の bin ディレクトリが含まれていないためです。その場合は PHP をインストールするか、環境変数にパスを設定することで解決できます。
セキュリティや互換性への影響
古い PHP バージョンではサポートが終了している機能があり、既知の脆弱性が修正されていないものもあります。使用中のテーマやプラグインが動作対象の最低 PHP バージョンを決めている場合、それより下のバージョンだと不具合が出たり更新ができないことがあります。仕様に合ったバージョンを使うことは安全かつ安定運用の鍵です。
PHP バージョン 確認 コマンドを使ってアップデートや環境構築をスムーズにする準備
PHP のバージョンを確認したら、その情報をもとに環境構築やアップデートを行うステップが続きます。ここでは確認後に取るべき対応策や次のアクションを整理します。互換性チェック、テスト環境の整備、アップデートの進め方など、失敗しない準備について解説します。
最低動作バージョンの要件チェック
使っている CMS（WordPress 等）やフレームワークが要求する最低 PHP バージョンを確認します。古いコードやライブラリが非推奨になっている機能を使っている可能性もあるため、現在のバージョンと比較して要件を満たしているかどうか、互換性に関するドキュメントを確認しておきます。
テスト環境での検証
アップデートを本番に適用する前に、ローカルまたはステaging環境で動作確認をします。バージョンが変わると動かなくなるコードやエラーが出る拡張モジュール、設定の違いなどを事前に洗い出しておくことがリスク軽減になります。
バージョンアップの手順とロールバックの準備
PHP のアップデートは通常、複数バージョンが利用可能なパッケージ管理ツールやホスティングパネルを使って行います。更新前にはバックアップを確実に取得し、万一問題が発生した場合に元のバージョンに戻せる環境を整備しておくと安心です。また稼働中サイトの負荷や互換性を考慮し、一度に大きく上げるのではなく段階的に移行する方法も有効です。
まとめ
PHP のバージョン確認は環境構築やアップデートを行う上で不可欠な作業です。CLI で「php -v」や「php –version」などを使って現在のバージョンを把握し、Web サーバー側では phpinfo() や phpversion() 関数、CMS の管理画面などで確認することで、CLI と Webでのバージョンの差異にも気づけます。
さらに、「php -i」や「php –ini」、「php -m」などを使って構成ファイル・拡張モジュール・ビルド設定をチェックすることで、本番環境での問題を未然に防げます。古いバージョンではセキュリティリスクがあるため、要件を満たしていない場合はテスト環境で検証しながら段階的にアップデートすることが安心です。バージョン確認後の準備をしっかり行い、安全で安定した環境を維持してください。
コメント