閉じる

PHPのパスを通す方法：OS別の設定手順と反映されない時の対処法

広告

PHPをインストールした直後、コマンドプロンプトやターミナルでphp -vと入力しても「コマンドが見つかりません」といったエラーが表示されることがあります。

これは、コンピュータが「PHPというプログラムがどこにあるのか」を把握できていないために起こる現象です。

本記事では、プログラミングを始める上での最初の壁とも言えるPHPのパスを通す設定手順について、Windows、macOS、Linuxの各OS別に詳しく解説します。

目次 [ close ]
  1. PHPの「パスを通す」とはどのような作業か？
  2. WindowsでPHPのパスを通す手順 (Windows 11/10対応)
    1. PHPのインストール場所を特定する
    2. システムの環境変数を編集する
  3. macOSでPHPのパスを通す手順 (zsh環境)
    1. PHPのインストールパスを確認する
    2. .zshrcファイルを編集する
  4. Linux (Ubuntu/Debian) でのパス設定方法
  5. パスが正しく通ったか確認する方法
  6. パスが反映されない時のチェックリストと対処法
    1. 1. ターミナル・コマンドプロンプトの再起動
    2. 2. スペルミスとディレクトリの階層
    3. 3. 設定ファイルの記述順序と優先順位
    4. 4. Windowsの「システム環境変数」と「ユーザー環境変数」
    5. 5. シンボリックリンクの確認 (macOS/Linux)
  7. 開発効率を高めるための補足知識
    1. Composerのパスを通す
    2. VS Codeなどのエディタ連携
  8. まとめ

PHPの「パスを通す」とはどのような作業か？

コンピュータのOS (オペレーティングシステム) は、コマンドが入力された際に、あらかじめ指定された特定のフォルダ群の中から実行ファイルを探し出そうとします。

この「探しに行く場所のリスト」が環境変数PATH (パス)と呼ばれるものです。

通常、PHPをダウンロードしてフォルダを配置しただけでは、OSはその場所を知りません。

そのため、フルパス (例: C:\php\php.exe) を指定せずに「php」という短い名前だけで実行できるようにするためには、リストの中にPHPの実行ファイルが存在するディレクトリを追加する必要があります。

この作業を一般的に「パスを通す」と呼びます。

パスを通すことで、どのディレクトリにいる状態からでもPHPを実行できるようになり、Laravelなどのフレームワークを利用した開発や、Composerによるパッケージ管理がスムーズに行えるようになります。

WindowsでPHPのパスを通す手順 (Windows 11/10対応)

Windows環境では、コントロールパネルや設定アプリからシステムのプロパティを開き、環境変数を編集する必要があります。

PHPのインストール場所を特定する

まず、PHPの実行ファイル (php.exe) がどこに保存されているかを確認します。

一般的には以下のようなパスに配置されていることが多いです。

インストール方法一般的なパス
直接ダウンロードC:\php
XAMPPを利用C:\xampp\php
Scoopを利用C:\Users\ユーザー名\scoop\apps\php\current

このパスをエクスプローラーのアドレスバーからコピーしておいてください。

システムの環境変数を編集する

  1. スタートメニューを開き、「環境変数」と入力します。
  2. 「システム環境変数の編集」を選択して「システムのプロパティ」ウィンドウを開きます。
  3. 下部にある「環境変数」ボタンをクリックします。
  4. 「システム環境変数」のリストの中から「Path」を選択し、「編集」をクリックします。
  5. 「新規」ボタンを押し、先ほどコピーしたPHPのパス (例: C:\php) を貼り付けます。
  6. すべてのウィンドウで「OK」をクリックして閉じます。

注意点として、すでに開いているコマンドプロンプトやPowerShellにはこの設定が即座には反映されません。 設定を有効にするには、一度ウィンドウをすべて閉じて、新しく立ち上げ直す必要があります。

macOSでPHPのパスを通す手順 (zsh環境)

現在のmacOS (Catalina以降) では、標準のシェルとして zsh が採用されています。

そのため、設定はホームディレクトリにある .zshrc というファイルに記述します。

PHPのインストールパスを確認する

macOSでPHPをインストールする場合、Homebrewを使用するのが一般的です。

Homebrewでインストールした場合のパスを確認するには、以下のコマンドを使用します。

Shell
# HomebrewでインストールされたPHPの場所を確認
brew --prefix php

出力結果として /opt/homebrew/opt/php/bin (Apple Siliconの場合) や /usr/local/opt/php/bin (Intel Macの場合) が表示されます。

.zshrcファイルを編集する

次に、設定ファイルにパスを追記します。

Shell
# zshの設定ファイルをエディタで開く (例としてnanoを使用)
nano ~/.zshrc

ファイルの末尾に以下の内容を追加してください。

Shell
# PHPのパスを通す
export PATH="/opt/homebrew/opt/php/bin:$PATH"

保存してエディタを終了 (nanoの場合は Ctrl+O, Enter, Ctrl+X) した後、設定を現在のターミナルに反映させます。

Shell
# 設定を即時反映
source ~/.zshrc

これでパスの設定は完了です。

Linux (Ubuntu/Debian) でのパス設定方法

Linux環境では、パッケージマネージャー (aptなど) を使用してPHPをインストールすると、自動的に /usr/bin/php などにシンボリックリンクが作成されるため、手動でパスを通す必要がないケースが大半です。

しかし、特定のバージョンを個別にインストールした場合や、自分でビルドした場合には手動設定が必要です。

Linuxでは <del>/.bashrc または </del>/.profile に記述します。

Shell
# bashの設定ファイルを編集
vi ~/.bashrc

# 以下の行を追加
export PATH="$HOME/my_php_install/bin:$PATH"

# 設定を反映
source ~/.bashrc

パスが正しく通ったか確認する方法

設定が完了したら、必ず確認作業を行いましょう。

OSを問わず、以下のコマンドを実行します。

Shell
# PHPのバージョン情報を表示
php -v

正常にパスが通っていれば、以下のような出力が表示されます。

text
PHP 8.3.0 (cli) (built: Nov 25 2025 10:00:00) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.3.0, Copyright (c) Zend Technologies

もしここで「command not found」や「’php’ は、内部コマンドまたは外部コマンド…として認識されていません」と表示される場合は、設定のどこかにミスがあります。

また、which コマンド (Windowsの場合は where) を使うことで、どこのPHPが呼び出されているかを確認できます。

Shell
# macOS/Linuxの場合
which php
# 出力例: /opt/homebrew/bin/php

# Windowsの場合
where php
# 出力例: C:\php\php.exe

パスが反映されない時のチェックリストと対処法

手順通りに進めてもパスが通らないことは珍しくありません。

トラブルに直面した際は、以下のポイントを順番に確認してください。

1. ターミナル・コマンドプロンプトの再起動

最も多い原因は、設定変更前に開いていたターミナルをそのまま使い続けていることです。

環境変数は、プロセスの起動時に読み込まれます。

そのため、設定を書き換えた後は、一度すべてのコマンドラインツールを終了させ、新しく起動し直す必要があります。

2. スペルミスとディレクトリの階層

パスの文字列に間違いがないか、もう一度確認してください。

特に以下の点に注意が必要です。

  • Windowsの場合、パスの末尾に を入れるか入れないか (基本は入れなくて良い)。
  • フォルダ名にスペースが含まれている場合、正しくダブルクォーテーションで囲まれているか。
  • php.exe そのものではなく、php.exeが入っているフォルダを指定しているか。

3. 設定ファイルの記述順序と優先順位

コンピュータの中に複数のPHPがインストールされている場合 (例: XAMPPと単体インストールのPHP)、先にリストに登録されている方が優先されます。

例えば、Homebrewで新しいPHPを入れたのに、OS標準の古いPHPが起動してしまう場合は、設定ファイル (.zshrcなど) で新しいパスを $PATH の前に記述しているか確認してください。

Shell
# 良い例: 新しいパスを先頭に追加する
export PATH="/new/php/path:$PATH"

# 悪い例: 既存のパスの後に配置すると、古い方が先に実行される可能性がある
export PATH="$PATH:/new/php/path"

4. Windowsの「システム環境変数」と「ユーザー環境変数」

Windowsには、ログインしているユーザーだけに適用される「ユーザー環境変数」と、PC全体に適用される「システム環境変数」の2種類があります。

通常は「システム環境変数」のPathに追加するのが確実ですが、権限の問題で書き換えられない場合は「ユーザー環境変数」のPathを確認してください。

両方に記載があり、内容が矛盾していると予期せぬ挙動の原因となります。

5. シンボリックリンクの確認 (macOS/Linux)

パスを通したディレクトリの中に、本当に実行ファイルが存在するか確認してください。

Shell
ls -l /opt/homebrew/opt/php/bin/php

もしファイルが存在しない、あるいはリンク切れを起こしている場合は、インストール自体に失敗している可能性があります。

その場合は brew reinstall php などの再インストールを検討してください。

開発効率を高めるための補足知識

パスを通した後は、以下の設定も行っておくと開発がさらにスムーズになります。

Composerのパスを通す

PHPのライブラリ管理ツールである「Composer」も、インストールしただけではパスが通っていないことがあります。

PHPと同様に、Composerの実行ファイルが存在するディレクトリも環境変数PATHに追加しておきましょう。

  • Windows: %USERPROFILE%\AppData\Roaming\Composer\vendor\bin
  • macOS/Linux: ~/.composer/vendor/bin

VS Codeなどのエディタ連携

Visual Studio Code (VS Code) を使用している場合、エディタがPHPのパスを自動で認識できないことがあります。

この場合、VS Codeの設定 (settings.json) で直接パスを指定します。

JSON
{
    "php.validate.executablePath": "C:\\php\\php.exe"
}

このように設定することで、エディタ上での構文チェック機能が正しく動作するようになります。

まとめ

PHPのパスを通す作業は、環境構築の第一歩です。

一度設定してしまえば、その後何度も行う作業ではありませんが、OSのアップデートやPCの新調時に必ず必要となる知識です。

  • Windows：システム環境変数の「Path」に、php.exeがあるフォルダを追加する。
  • macOS：.zshrc に export PATH="..." を追記する。
  • Linux：.bashrc にパスを追記し、シンボリックリンクの状態を確認する。

もし設定が反映されない場合は、「ターミナルの再起動」と「記述の優先順位」をまず疑ってみてください。

正しくパスが通れば、あなたの開発環境はより強力で柔軟なものになります。

エラーメッセージに惑わされず、一つひとつの手順を丁寧に確認していきましょう。

クラウドSSLサイトシールは安心の証です。

URLをコピーしました！