Windows 11 に PHP をインストールして VSCode で動作させる手順

概要

最近購入した JavaScript の本「改訂3版 JavaScript 入門」（山田祥寛著/技術評論社）を試そうと読み進めていたところ、Chapter10 に PHP との連携についての章がありました。その内容を実践するため、PHP の環境構築を行いました。

このガイドでは、Windows 11 に PHP をインストールし、Visual Studio Code (VSCode) で PHP スクリプトを実行するための手順をまとめています。環境構築後、JavaScript と PHP を組み合わせた開発も可能になります。

1. PHP をインストール

1-1. PHP のダウンロード

PHP の公式サイトにアクセス。
最新バージョンの「Windows Downloads」セクションで適切なビルドを選択します。
- 通常は「Thread Safe」を推奨。
ZIP ファイルをダウンロードします。

1-2. PHP の展開

ダウンロードした ZIP ファイルを解凍します。
解凍したフォルダ（例: php-8.x.x-Win32-vs16-x64）を C:\php に移動します。

1-3. 環境変数に追加

スタートメニューで「環境変数」を検索し、「環境変数の編集」を開きます。
システム環境変数の「Path」を選択し、「編集」をクリック。
「新規」をクリックして C:\php を追加。
「OK」をクリックして設定を保存。

1-4. 動作確認

コマンドプロンプトまたは PowerShell を開き、以下を実行

php -v

PHP のバージョン情報が表示されればインストール成功。

2. VSCode の設定

2-1. VSCode のインストール

Visual Studio Code の公式サイトから VSCode をダウンロードしてインストールします。

2-2. PHP 拡張機能のインストール

VSCode を起動。
拡張機能（左サイドバーのアイコン）をクリック。
検索バーに「PHP」と入力し、以下の拡張機能をインストール：
- PHP Intelephense
- PHP Server（オプション）

2-3. デフォルトターミナルの設定

Ctrl + Shift + P を押して「ターミナルのデフォルトシェルを選択」を検索。
「PowerShell」または「Command Prompt」を選択。

3. PHP のビルトインサーバーを使用

3-1. プロジェクトの作成

任意の場所にフォルダを作成（例: C:\projects\php_project）。
フォルダ内に index.php を作成し、以下のコードを記述：

<?php
echo "Hello, PHP!";

3-2. PHP サーバーの起動

VSCode のターミナルを開きます（Ctrl + \）。
プロジェクトのディレクトリに移動

cd C:\projects\php_project

以下のコマンドでサーバーを起動

php -S localhost:8000

ブラウザで http://localhost:8000 にアクセスし、「Hello, PHP!」が表示されることを確認。

実行中のターミナル

下記は一例です。faviconのエラーなどが表示され的になる場合は、空ファイルでいいので「favicon.ico」ファイルをプロジェクトルートに保存してください。

> php -S localhost:8000
[Wed Jan 15 20:45:31 2025] PHP 8.4.2 Development Server (http://localhost:8000) started
[Wed Jan 15 20:45:36 2025] [::1]:54177 Accepted
[Wed Jan 15 20:45:36 2025] [::1]:54178 Accepted
[Wed Jan 15 20:45:36 2025] [::1]:54177 [200]: GET /
[Wed Jan 15 20:45:36 2025] [::1]:54177 Closing

4. トラブルシューティング

4-1. PHP コマンドが認識されない場合

環境変数 Path に C:\php が正しく追加されているか確認。
VSCode を再起動して変更を反映。

4-2. ファイルが見つからないエラー

PHP サーバーを起動する際に、正しいプロジェクトディレクトリで実行しているか確認。
index.php が存在しない場合、ドキュメントルートに配置してください。

5. JavaScript と PHP の連携準備

5-1. HTML と PHP を組み合わせる

プロジェクトフォルダに index.php を作成

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>PHP and JavaScript</title>
    <script>
        function showMessage() {
            alert('Hello from JavaScript!');
        }
    </script>
</head>
<body>
    <h1><?php echo "Hello from PHP!"; ?></h1>
    <button onclick="showMessage()">Click Me</button>
</body>
</html>

ブラウザで確認し、PHP と JavaScript が連携して動作することを確認。

6. 参考文献

山田祥寛著『改訂3版 JavaScript入門』（技術評論社）
PHP Official Documentation
Visual Studio Code Documentation

概要