XAMPP のインストール後に macOS で「PHP が見つかりません」エラーを修正する方法

macOS 開発者が XAMPP を使用してローカル開発環境をセットアップすると、「PHP が見つかりません」というイライラするエラーが頻繁に発生します。 XAMPP には PHP が付属していますが、ターミナルが php コマンドを認識しない場合があります。

この記事では、この問題を解決し、システムが PHP を確実に見つけられるようにするための手順を段階的に説明します。

エラーの理解

次のコマンドを実行します:

<code class="language-bash">php -v</code>

次のようなエラー メッセージが表示された場合:

<code>php not found</code>

これは、システム シェル (zsh や bash など) が環境内で PHP 実行可能ファイルを見つけることができないことを意味します。 XAMPP に独自の PHP バイナリが含まれている場合でも、PHP を含むディレクトリがシェルの $PATH に含まれていないため、この問題が発生します。

この問題を解決しましょう!

ステップ 1: XAMPP インストールで PHP を見つける

XAMPP には独自の PHP インストールが含まれており、通常は次のディレクトリにあります:

<code class="language-bash">/Applications/XAMPP/xamppfiles/bin/php</code>

PHP 実行可能ファイルがこの場所に存在することを確認するには、次のコマンドを実行します:

<code class="language-bash">ls /Applications/XAMPP/xamppfiles/bin/php</code>

このコマンドで PHP ファイルがリストされる場合は、正しい方向に進んでいます。

ステップ 2: XAMPP の PHP をシェルの PATH に追加します

PHP 実行可能ファイルをグローバルに利用できるようにするには、XAMPP PHP ディレクトリをシェルの $PATH に追加する必要があります。

Zsh ユーザー (macOS のデフォルト シェル)

macOS Catalina 以降、zsh がデフォルトのシェルです。 $PATH を更新するには、次の手順に従ってください:

1. .zshrc ファイルを開きます:

<code class="language-bash">nano ~/.zshrc</code>

2. ファイルの最後に次の行を追加します:

<code class="language-bash">export PATH="/Applications/XAMPP/xamppfiles/bin:$PATH"</code>

3. Ctrl O、Enter、最後に Ctrl X を押してファイルを保存して閉じます。

4. 次のコマンドを実行して、変更をすぐに適用します:

<code class="language-bash">source ~/.zshrc</code>

Bash ユーザー

まだ bash をシェルとして使用している場合は、.bash_profile を編集します:

<code class="language-bash">nano ~/.bash_profile</code>

同じ行を追加します:

<code class="language-bash">export PATH="/Applications/XAMPP/xamppfiles/bin:$PATH"</code>

次の方法で変更を保存して適用します:

<code class="language-bash">source ~/.bash_profile</code>

ステップ 3: PHP のインストールを確認する

$PATH を更新した後、php コマンドが機能するかどうかをテストします。

<code class="language-bash">php -v</code>

XAMPP に付属する PHP のバージョンが表示されます。例:

<code>PHP 8.2.4 (cli) (built: Apr  6 2023 04:12:41) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.4, Copyright (c) Zend Technologies</code>

それがうまくいけば、おめでとうございます!これで、システムは php コマンドを認識します。

ステップ 4: 端末を再起動します (オプション)

上記の手順がすぐに有効にならない場合は、ターミナルを再起動し、php -v を再度実行してみてください。シェル構成ファイルへの変更を有効にするには、端末の再起動が必要になる場合があります。

代替: Homebrew を使用して PHP をインストールします

バンドルされたバージョンの XAMPP に依存するのではなく、システム全体に PHP をインストールしたい場合は、Homebrew を使用して PHP をインストールできます。

1. Homebrew をまだインストールしていない場合は、以下をインストールしてください:

<code class="language-bash">/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"</code>

2. PHP をインストールします:

<code class="language-bash">brew install php</code>

3. インストールの確認:

<code class="language-bash">php -v</code>

これにより、最新バージョンの PHP がインストールされ、$PATH が自動的に設定されます。

結論

「PHP が見つかりません」エラーは、シェルの $PATH がどのように機能するかを理解すれば、すぐに修正できます。 XAMPP の PHP を PATH に追加する場合でも、Homebrew を選択する場合でも、このガイドを読めばすぐに起動して実行できるようになります。これで、最も重要なこと、つまり優れたアプリの開発に集中できるようになりました。

このガイドが役に立ったかどうか、または macOS で PHP を管理するためのヒントを共有してください。コメント欄でお知らせください。

以上がXAMPP のインストール後に macOS で「PHP が見つかりません」エラーを修正する方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。