VSCodeで『PHP Server』を起動したら『PHP not found』エラーが出た for macOS

Visual Studio Codeの拡張機能『PHP Server』を利用したいけど、「PHP not found」というエラーが表示されて起動できませんでした。

これは、MacにPHPがインストールされていないことが原因です。
そこで、Homebrewというツールを使って、PHPをインストールします。

Homebrewとは?

Macにソフトウェアを簡単にインストールできる「パッケージ管理ツール」です。PHP以外にも、さまざまなソフトを管理できます。

STEP1: Homebrewのインストール手順

まず、ターミナルを開き、以下のコマンドをHomebrew公式サイトコピーして貼り付け、実行します。

% /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

インストールが完了すると、最後に「Next steps(次の手順)」という案内が表示されます。その中に、PATHを通すためのコマンドが書かれています。以下の3行を順番にコピーして実行しましょう。

==> Next steps:
- Run these commands in your terminal to add Homebrew to your PATH:
    echo >> /Users/あなたのユーザー名/.zprofile
    echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/あなたのユーザー名/.zprofile
    eval "$(/opt/homebrew/bin/brew shellenv)"

※「あなたのユーザー名」はMacのユーザーに合わせて書き換えてください。

Homebrewが正しく入ったか確認する

次のコマンドを実行して、バージョンが表示されればOKです。

% brew -v
Homebrew 4.5.7

STEP2: PHPのインストール

Homebrewを使ってPHPをインストールします。以下のコマンドをターミナルで実行します。

% brew install php

PHPが使えるか確認する

次のコマンドで、インストールされたPHPのバージョンを確認しましょう。

% php -v
PHP 8.3.7 (cli) (built: ...)

これで準備完了です!

もう一度、Visual Studio Codeを開いて『PHP Server』を右クリックメニューから実行してみましょう。
エラーが出ずに動作すれば、PHPのインストールは成功です!おめでとう!

石井秀幸@WEBデザイナー
WordPress公式『横浜 WordPress Meetup』主宰/株式会社ノクチ基地 取締役/モンゼンクリエイティブ合同会社 代表。WEB制作に関する技術や役立つ情報を発信していきます。10年にわたるWordPress歴を背景に、幅広いアイデアを形にするお手伝いをしています。