章: 第6章: トラブルシューティング

対象OS: Windows / Mac 共通（OS別の違いは各項目に記載）

「動かない理由がわからない」—— エラーを読む技術を身につける

環境構築でつまずく理由のほとんどは「エラーメッセージを読んでいない」か「読んでも意味がわからない」かのどちらかです。PHPの環境エラーはパターンが決まっていて、原因さえわかれば解決策はシンプルです。

この記事では、Windows・Macの両方でよく発生するエラーをパターン別にまとめます。

—

パターン1: php: command not found / 'php' は内部コマンドとして認識されません

### 意味

PHPはインストールされているが、ターミナルのPATHに登録されていない。

### 原因と解決策

確認コマンド（どこのPHPが使われているかを調べる）:

# Mac / WSL2
which php

# Windows
where php

—

パターン2: Apacheが起動しない（XAMPPでポートエラー）

### 意味

ポート80がすでに別のプロセスに使われている。

### エラーメッセージ例

Apache shutdown unexpectedly.

### 解決策

原因の特定（Windows）:

netstat -ano | findstr :80

表示されたPIDを確認して、タスクマネージャーで該当プロセスを終了します。

よくある競合プロセス:

別のポートに変更する方法（XAMPP）:

C:\xampp\apache\conf\httpd.conf を開き、Listen 80 を Listen 8080 に変更してApacheを再起動します。その場合のアクセスURLは https://phpl4b.com/ になります。

—

パターン3: PHPファイルがダウンロードされる（中身が実行されない）

### 意味

ApacheがPHPファイルをPHPとして処理せず、テキストとして送信している。

### 解決策

• XAMPPを使用している場合: PHPモジュールが有効になっているか確認する。C:\xampp\apache\conf\httpd.conf で LoadModule php_module の行がコメントアウトされていないか確認する。
• ビルトインサーバーを使っている場合: .php 拡張子のファイルを php -S で起動したディレクトリ以下に置いているか確認する。

—

パターン4: Fatal error: Uncaught Error: Class not found

### 意味

指定したクラスが読み込まれていない。

### よくある原因

—

パターン5: MySQLに接続できない

### エラーメッセージ例

SQLSTATE[HY000] [2002] Connection refused

### 確認手順

1. MySQLサービスが起動しているか確認

– XAMPP: Control Panelでグリーン表示か確認

– MAMP: GUIでMySQLランプが点灯しているか確認

– Docker: docker compose ps でStatusがRunningか確認

2. 接続情報が正しいか確認

MAMPの注意: MAMPのMySQLはデフォルトでポート8889を使います。3306に変更する場合はMAMPのPreferencesから設定します。

—

パターン6: Dockerコンテナが起動しない

### 確認コマンド

# コンテナの状態を確認
docker compose ps

# エラーログを表示
docker compose logs

# 特定サービスのログ
docker compose logs web

### よくある原因

—

パターン7: 改行コードの問題（Windows固有）

### 症状

シェルスクリプト（.sh）をLinux環境（WSL2・Docker）で実行すると「コマンドが見つからない」エラーが出る。

### 原因

Windowsのエディタで保存すると改行コードが CRLF（\r\n）になることがあります。Linux/Macは LF（\n）のみを期待するため、余分な \r がコマンド名の末尾に含まれてしまいます。

### 解決策

VS Codeで変換:

• 右下のステータスバーに表示されている CRLF をクリック → LF を選択して保存する

VS Codeのデフォルト設定:

"files.eol": "\n"

settings.json に追記すると新規ファイルが自動的に LF になります。

—

まとめ

環境系のトラブルは「エラーメッセージを正確に読む」「ログを確認する」「一つ変えては試す」の繰り返しで解決できます。焦らず順番に確認していきましょう。

The post 第10回: よくあるエラーとトラブルシューティング — 詰まったときに読む一覧 first appeared on 未経験から実務レベルへ｜PHP初心者向け実践学習ブログ.

章: 第5章: より本格的な環境

対象OS: Windows / Mac 共通（差異は各セクションに記載）

「私の環境では動くのに」—— この問題をなくすのがDocker

チーム開発で一番困るのが「自分のPCでは動くのに、他の人の環境では動かない」という状況です。PHPのバージョン違い、php.ini の設定差異、OSの違いなど、原因は多岐にわたります。

DockerはPHPのバージョン・設定・依存ツールをすべてコードで定義します。 docker compose up 1コマンドで、誰の環境でも同じ構成が立ち上がります。

Dockerのインストール

### Windowsの場合

1. [https://www.docker.com/products/docker-desktop/](https://www.docker.com/products/docker-desktop/) から「Docker Desktop for Windows」をダウンロード

2. インストーラーを実行（WSL2バックエンドを使用するオプションを選択）

3. インストール後、PCを再起動

4. Docker Desktopを起動して確認:

docker --version
docker compose version

注意: Windows版DockerはWSL2を必要とします。WSL2が未インストールの場合は先に第08回の手順で導入してください。

### Macの場合

1. [https://www.docker.com/products/docker-desktop/](https://www.docker.com/products/docker-desktop/) から「Docker Desktop for Mac」をダウンロード

– Apple Silicon（M1/M2/M3）の場合は「Mac with Apple chip」を選択

– Intel Macの場合は「Mac with Intel chip」を選択

2. .dmg ファイルを開き、Docker.appをApplicationsにドラッグ

3. Docker Desktopを起動して確認:

docker --version
docker compose version

PHP + Apacheのシンプルな構成

まずプロジェクトフォルダを作成します:

myproject/
├── docker-compose.yml
├── php.ini
└── public/
    └── index.php

### docker-compose.yml

services:
  web:
    image: php:8.2-apache
    ports:
      - "8080:80"
    volumes:
      - ./public:/var/www/html
      - ./php.ini:/usr/local/etc/php/conf.d/custom.ini

### php.ini

display_errors = On
error_reporting = E_ALL

### public/index.php

<?php
echo '<h1>Hello from Docker!</h1>';
phpinfo();

起動と確認

# プロジェクトフォルダに移動
cd myproject

# コンテナを起動
docker compose up -d

# ブラウザで確認
# https://phpl4b.com/

-d オプションをつけるとバックグラウンドで起動します。停止するときは:

docker compose down

MySQLを追加する構成

データベースが必要な場合は docker-compose.yml にMySQLサービスを追加します:

services:
  web:
    image: php:8.2-apache
    ports:
      - "8080:80"
    volumes:
      - ./public:/var/www/html
    depends_on:
      - db
    environment:
      DB_HOST: db
      DB_NAME: mydb
      DB_USER: user
      DB_PASSWORD: password

  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: mydb
      MYSQL_USER: user
      MYSQL_PASSWORD: password
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:

PHPからMySQLに接続する場合、php-mysqli または php-pdo_mysql 拡張が必要です。カスタムDockerfileで追加できます:

# Dockerfile
FROM php:8.2-apache
RUN docker-php-ext-install mysqli pdo pdo_mysql

docker-compose.yml でイメージの代わりにDockerfileを指定:

services:
  web:
    build: .
    ports:
      - "8080:80"
    volumes:
      - ./public:/var/www/html

WindowsとMacの差異まとめ

Windowsでのパフォーマンス注意: プロジェクトファイルを C:\Users\ 以下ではなく、WSL2内の ~/ 以下に置くことでDockerのファイルマウントが高速になります。

コンテナログの確認

動作がおかしい場合はログで原因を確認します:

# 全サービスのログ
docker compose logs

# webサービスのみリアルタイムで表示
docker compose logs -f web

まとめ & 次のステップ

• DockerはPHP環境をコードで定義し、どのPCでも同じ状態を再現できる
• docker-compose.yml の services にPHPとMySQLを定義して起動する
• WindowsはWSL2が必要、MacはDocker Desktopをインストールするだけ
• ファイルをWSL2/Mac側に置くとマウントのパフォーマンスが向上する

次回は「よくあるエラーとトラブルシューティング」を解説します。環境構築でつまずきやすいエラーとその解決策を、OS別にまとめます。

The post 第09回: DockerでPHP環境をつくる — 再現性の高い環境をコードで定義する first appeared on 未経験から実務レベルへ｜PHP初心者向け実践学習ブログ.

章: 第5章: より本格的な環境

対象OS: Windows 専用

「Windowsだと本番と違う」—— その問題を根本から解消する

多くのサーバーはLinuxで動いています。WindowsのXAMPPはWindowsネイティブで動くため、パスの区切り文字や改行コード、パーミッションの扱いが本番環境と微妙に異なります。チームにMacユーザーが混在しているとさらに差が生じやすくなります。

WSL2（Windows Subsystem for Linux 2）を使えば、Windows上でLinux環境を動かせます。 DockerもLinuxの上で動くため、WSL2はDocker学習の前段階としても有効です。

WSL2とは

WSL2はWindows 10/11に組み込まれたLinux互換レイヤーです。仮想マシンとは異なり、Linuxカーネルが直接動作するため、パフォーマンスが高くWindowsとのファイル共有も自然にできます。

WSL2のインストール

PowerShellを管理者として実行して、次のコマンドを入力します:

wsl --install

このコマンドで:

• WSL2機能が有効化される
• Ubuntu（最新LTS）が自動的にインストールされる

完了後、PCを再起動します。

再起動後、Ubuntuが起動してユーザー名とパスワードの設定を求められます。任意のユーザー名とパスワードを入力してください（このパスワードはUbuntu内でのsudoコマンドに使います）。

確認コマンド:

`powershell

wsl –list –verbose

`

STATE が Running または Stopped と表示されれば正常です。

Ubuntu上にPHPをインストールする

WSL2のUbuntuターミナルを開いて、以下を実行します:

# パッケージリストを更新
sudo apt update && sudo apt upgrade -y

# PHPと必要なモジュールをインストール
sudo apt install -y php php-cli php-mbstring php-xml php-curl php-mysql php-zip

# バージョン確認
php -v

PHP 8.x.x と表示されれば完了です。

Composerのインストール

# 必要なパッケージ
sudo apt install -y curl

# Composerをインストール
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

# 確認
composer --version

PHPビルトインサーバーで動作確認

# プロジェクトフォルダを作成
mkdir ~/myproject && cd ~/myproject

# テストファイルを作成
echo '<?php echo "Hello from WSL2!"; ?>' > index.php

# ビルトインサーバーを起動
php -S localhost:8000

Windowsのブラウザで http://localhost:8000/ にアクセスすると、WSL2上のPHPが応答します。

チェックポイント: WSL2内のlocalhostはWindowsのブラウザから直接アクセスできます。ファイアウォールの設定なしに http://localhost でつながります。

VS CodeとWSL2を連携させる

VS CodeにはWSL2専用の拡張機能があります。

1. VS Codeで拡張機能「WSL」（ID: ms-vscode-remote.remote-wsl）をインストール

2. WSL2のターミナルでプロジェクトフォルダに移動して:

`bash

code .

`

3. VS CodeがWSL2モードで起動し、Linux側のファイルをWindowsのUIで編集できる

この状態で拡張機能（PHP Intelephense、PHP Debugなど）はWSL2側にインストールされ、Linuxのパスで動作します。

ファイルシステムの注意点

WSL2にはファイルシステムの境界があります。

プロジェクトファイルはLinux側（~/）に置くのが原則です。 /mnt/c/ 以下に置くとファイルアクセスが遅くなります。

まとめ & 次のステップ

• WSL2はWindows上でLinuxを動かす機能で、wsl --install で導入できる
• Ubuntu上にPHPとComposerをインストールすれば、Macとほぼ同じ操作感になる
• VS Codeの「WSL」拡張でWindows UIのままLinux側のファイルを編集できる
• ファイルはLinux側（~/）に置くことでパフォーマンスが維持される

次回はWindowsとMac共通で使える「DockerでPHP環境をつくる」を解説します。チーム開発に耐えうる再現性の高い環境をコードで定義する方法です。

The post 第08回: WSL2でPHP環境をつくる — WindowsでLinux開発体験を実現する first appeared on 未経験から実務レベルへ｜PHP初心者向け実践学習ブログ.

章: 第4章: エディタとデバッグ環境

対象OS: Windows / Mac 共通（差異は各セクションに記載）

「var_dumpを消し忘れた」—— デバッグのやり方を変える

PHPを学び始めると、変数の中身を確認するために var_dump() や echo を使うのが定番です。しかし、これには問題があります。コードを一時的に書き換え、確認したら消して、また書き換えて……この繰り返しは非効率ですし、消し忘れるリスクもあります。

Xdebugを使えば、コードを変更せずにブレークポイントで実行を止め、その時点の変数をすべて確認できます。 セットアップに少し手間がかかりますが、一度整えると開発速度が大きく上がります。

Xdebugとは

Xdebugはphp.ini拡張として動作するデバッグツールです。VS Codeの「PHP Debug」拡張と連携して、IDEからブレークポイントデバッグが可能になります。

Xdebugのインストール

### Windowsの場合（XAMPP）

1. XAMPPをインストールしている場合、Xdebugは最初から含まれています

2. C:\xampp\php\php.ini をメモ帳（または VS Code）で開く

3. [XDebug] セクションを探す（なければファイル末尾に追記）

[XDebug]
zend_extension=xdebug
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003

4. XAMPP Control PanelでApacheを再起動する

### Macの場合（MAMP）

1. 使用しているPHPバージョンに対応したXdebugをインストールします

まず、PHPのバージョンを確認:

php -v

次に、Homebrewでxdebugをインストール（PHP 8.2の場合）:

pecl install xdebug

2. php.ini に設定を追記します

MAMPのphp.iniのパス例（バージョンによって異なります）:

/Applications/MAMP/bin/php/php8.2.0/conf/php.ini

追記する内容:

[XDebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003

3. MAMPのサーバーを再起動する

チェックポイント: phpinfo() の出力ページで「xdebug」のセクションが表示されれば、有効化されています。

VS Code側の設定

1. 拡張機能「PHP Debug」（ID: xdebug.php-debug）をインストール

2. VS Codeのサイドバーで「実行とデバッグ」（虫のアイコン）を開く

3. 「launch.json ファイルを作成します」をクリック → 「PHP」を選択

自動生成される launch.json（プロジェクトの .vscode/launch.json）:

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003
    }
  ]
}

ブレークポイントデバッグの手順

1. VS Codeで確認したい行の行番号の左をクリックして、赤い丸（ブレークポイント）を設置する

2. 「実行とデバッグ」パネルで「Listen for Xdebug」を実行（F5）

3. ブラウザでPHPページにアクセスする

4. ブレークポイントの行で実行が止まり、VS Codeで変数一覧が確認できる

ステップ実行のキーボードショートカット:

WindowsとMacの差異まとめ

まとめ & 次のステップ

• Xdebugを使えばコードを変えずに変数をリアルタイム確認できる
• php.ini に4行設定を追記して、Apacheを再起動するだけで有効化できる
• VS Codeの「PHP Debug」拡張と組み合わせてブレークポイントデバッグが可能
• WindowsはXAMPPに同梱済み、MacはMAMPでも pecl install で導入できる

次回はWindowsユーザー向けに「WSL2でPHP環境をつくる」を解説します。WindowsでMacに近いLinux開発体験を実現する方法です。

The post 第07回: Xdebugの設定 — var_dumpを卒業してブレークポイントデバッグへ first appeared on 未経験から実務レベルへ｜PHP初心者向け実践学習ブログ.

章: 第4章: エディタとデバッグ環境

対象OS: Windows / Mac 共通

「テキストエディタで書けばいい」—— それは正しいが、非効率

メモ帳でもPHPは書けます。でも補完がなく、エラーがあってもわからず、ファイルをまたいだ検索もできない——そういった状態で書き続けると、ミスが増えてデバッグに時間がかかります。

エディタの設定は開発速度に直結します。 VS Codeは無料でWindows・Mac両方で使え、PHP向けの拡張機能が充実しています。最初にしっかり整えると、その後の学習スピードが大きく変わります。

VS Codeのインストール

[https://code.visualstudio.com/](https://code.visualstudio.com/) からダウンロードします。

Macの補足: インストール後、コマンドパレット（Cmd+Shift+P）で「Shell Command: Install 'code' command in PATH」を実行すると、ターミナルから code . でVS Codeを開けるようになります。

おすすめの拡張機能

### 必須: PHP Intelephense

拡張機能ID: bmewburn.vscode-intelephense-client

PHP向けの高性能な補完・定義ジャンプ・エラーチェック機能を提供します。デフォルトの「PHP Language Features」より高機能です。インストール後は、デフォルトのPHP補完を無効化することを推奨します。

設定手順:

1. Ctrl+Shift+P（Mac: Cmd+Shift+P）でコマンドパレットを開く

2. 「Extensions: Show Built-in Extensions」を検索

3. 「PHP Language Features」を見つけて無効化

### 推奨: PHP Debug（Xdebug連携）

拡張機能ID: xdebug.php-debug

Xdebugと連携してブレークポイントデバッグができます。詳しくは次回の「Xdebugの設定」で解説します。

### 推奨: PHP CS Fixer

拡張機能ID: junstyle.php-cs-fixer

PSR-12などのコーディング規約に沿って自動整形します。保存時に自動フォーマットされるよう設定すると、コードスタイルの手間がなくなります。

### あると便利: その他

基本的なVS Code設定（settings.json）

Ctrl+Shift+P（Mac: Cmd+Shift+P）→「Open User Settings (JSON)」で設定ファイルを開き、以下を追記します:

{
  "editor.tabSize": 4,
  "editor.insertSpaces": true,
  "editor.formatOnSave": true,
  "files.eol": "\n",
  "[php]": {
    "editor.defaultFormatter": "junstyle.php-cs-fixer"
  },
  "php.validate.executablePath": "/usr/bin/php"
}

Windowsの場合: php.validate.executablePath は "C:\\xampp\\php\\php.exe" のように設定します（バックスラッシュを \\ でエスケープ）。

PHPの実行パスをVS Codeに教える

VS CodeがPHPをどこで実行するか認識できないと、エラーチェックが機能しません。

### Windowsの設定例

"php.validate.executablePath": "C:\\xampp\\php\\php.exe"

### Macの設定例（MAMP使用時）

"php.validate.executablePath": "/Applications/MAMP/bin/php/php8.2.0/bin/php"

### Macの設定例（Homebrew使用時）

"php.validate.executablePath": "/opt/homebrew/bin/php"

ターミナルの設定

VS Codeの統合ターミナルは Ctrl+ ` で開けます。

Windowsでターミナルシェルを変更したい場合は、Ctrl+Shift+P → 「Terminal: Select Default Profile」から選択します。

まとめ & 次のステップ

• VS CodeはWindows・Mac両方で同じUIで使えるエディタ
• PHP Intelephenseは必須の拡張機能（補完・エラーチェックが大幅に向上する）
• settings.json でPHPの実行パスを設定すると機能がフル活用できる
• WindowsはバックスラッシュをJSONで \\ にエスケープする点に注意

次回は「Xdebugの設定」を解説します。var_dump のデバッグから卒業して、ブレークポイントで変数を確認する方法を学びます。

The post 第06回: VS Codeとおすすめ拡張機能 — PHP開発を快適にする設定 first appeared on 未経験から実務レベルへ｜PHP初心者向け実践学習ブログ.

章: 第3章: コマンドラインで動かす

対象OS: Windows / Mac 共通（差異は各セクションに記載）

「ライブラリをコピーして使う時代は終わった」

かつてはPHPライブラリを手動でダウンロードしてフォルダに配置していました。しかしそのやり方では、バージョン管理が煩雑になり、依存関係の整合性を手で維持しなければなりません。

Composerはこの問題をすべて解決します。 composer require コマンド1つで、必要なライブラリとその依存ライブラリをまとめてインストールできます。LaravelをはじめほぼすべてのモダンなPHPプロジェクトで使われており、早い段階で使い方を覚えておく価値があります。

Composerとは

Composerは「PHPの依存関係管理ツール」です。composer.json というファイルに必要なライブラリを定義し、composer install でまとめて取得します。

インストール手順

### Windowsの場合

1. [https://getcomposer.org/download/](https://getcomposer.org/download/) から「Composer-Setup.exe」をダウンロード

2. インストーラーを実行し、画面の指示に従って進める

3. PHPのパス（C:\xampp\php\php.exe など）を選択する画面が出たら、使用するPHPを指定する

4. インストール完了後、コマンドプロンプトを新しく開いて確認:

composer --version

### Macの場合

ターミナルで公式のインストールスクリプトを使います。

# インストールスクリプトをダウンロードして実行
curl -sS https://getcomposer.org/installer | php

# システム全体から使えるように移動
sudo mv composer.phar /usr/local/bin/composer

# 確認
composer --version

Homebrewを使っている場合は1コマンドで完了します:

brew install composer

チェックポイント: Composer version 2.x.x のように表示されれば、インストール成功です。

プロジェクトを初期化する

新しいプロジェクトにComposerを導入するには:

# プロジェクトフォルダを作成して移動
mkdir myproject && cd myproject

# composer.json を対話式で作成
composer init

いくつかの質問に答えると composer.json が生成されます。スキップしたい項目はEnterを押すだけで構いません。

ライブラリをインストールする

例として、日付処理ライブラリの「Carbon」を追加します:

composer require nesbot/carbon

実行すると:

• composer.json にライブラリ情報が追記される
• composer.lock が生成（または更新）される
• vendor/ フォルダにライブラリの実体がダウンロードされる

インストールしたライブラリを使う

Composerがインストールしたライブラリは、vendor/autoload.php を読み込むだけで使えるようになります。

<?php
require __DIR__ . '/vendor/autoload.php';

use Carbon\Carbon;

$now = Carbon::now();
echo $now->format('Y年m月d日 H:i:s');

require_once を複数書かなくても、1行の require で全ライブラリが使える——これがオートロードの便利さです。

よく使うコマンド

vendor/ フォルダはGitに含めない

vendor/ はComposerが自動生成するため、Gitで管理する必要はありません。

.gitignore に以下を追記します:

/vendor/

チームメンバーが git clone した後は composer install を実行すれば、composer.lock を元に同じバージョンのライブラリが再現されます。

WindowsとMacの差異まとめ

まとめ & 次のステップ

• Composerはライブラリの依存関係を composer.json で管理するツール
• composer require でライブラリを追加し、vendor/autoload.php で読み込む
• vendor/ はGitで管理せず、.gitignore に追加する
• WindowsはGUIインストーラー、MacはHomebrewが便利

次回は「VS Codeとおすすめ拡張機能」を解説します。コーディング効率を上げるための設定と拡張機能を、Windows・Mac共通で紹介します。

The post 第05回: Composerのインストールと使い方 — PHPライブラリ管理の基本 first appeared on 未経験から実務レベルへ｜PHP初心者向け実践学習ブログ.

章: 第3章: コマンドラインで動かす

対象OS: Windows / Mac 共通

「XAMPPを起動し忘れた」—— もっと軽い方法がある

Webサーバーを使うたびにXAMPPやMAMPを起動するのは手間です。ちょっとした動作確認のためだけにApacheを立ち上げるのはオーバースペックに感じることもあるでしょう。

PHPには最初からWebサーバー機能が内蔵されています。 コマンド1つで起動でき、終わったら Ctrl+C で止めるだけです。学習や小規模なローカル開発に最適な方法です。

ビルトインサーバーとは

PHP 5.4以降に組み込まれた簡易Webサーバーです。ApacheやNginxが不要で、PHPがインストールされていれば追加設定なしで使えます。

起動する

ターミナル（WindowsはコマンドプロンプトかPowerShell、Macはターミナル）を開き、PHPファイルが置いてあるディレクトリに移動してから起動します。

# プロジェクトフォルダに移動
cd /path/to/myproject

# ビルトインサーバーを起動
php -S localhost:8000

起動すると次のような出力が表示されます:

PHP 8.2.12 Development Server (http://localhost:8000) started

ブラウザで http://localhost:8000/ を開くと、フォルダ内の index.php が読み込まれます。

チェックポイント: ターミナルを閉じるとサーバーも止まります。開発中はターミナルを開いたままにしておきましょう。

WindowsとMacでのパス指定の違い

cd コマンドで移動するときのパスの書き方に注意が必要です。

PowerShellでは \ の代わりに / も使えます。Macでは ~ がホームディレクトリのショートカットです。

ドキュメントルートを指定する

ファイルが別のフォルダにある場合は、-t オプションでドキュメントルートを指定できます。

# public フォルダを公開ルートに設定
php -S localhost:8000 -t public/

これにより、http://localhost:8000/ にアクセスすると public/index.php が読み込まれます。Laravelなど多くのフレームワークは public/ をドキュメントルートとして使うため、このオプションが重要になります。

ポート番号を変える

8000 がすでに使われている場合は別の番号を使います。

php -S localhost:8080
php -S localhost:3000

よく使われるポートが競合しているときは 8080 や 3000 が代替候補です。

確認に使えるサンプルファイル

<?php
// index.php
echo '<h1>Hello, PHP!</h1>';
echo '<p>現在時刻: ' . date('Y-m-d H:i:s') . '</p>';

このファイルを置いてブラウザで確認し、時刻が表示されればビルトインサーバーが動作しています。

ビルトインサーバーの制限と注意点

ルーティングをビルトインサーバーで再現するには router.php を使う方法もありますが、フレームワークを使うなら素直にDockerやMAMP/XAMPPを使う方が管理しやすいです。

まとめ & 次のステップ

• php -S localhost:8000 でWebサーバーが即時起動する
• XAMPPやMAMPなしでも動作確認が可能
• -t オプションでドキュメントルートを指定できる
• 本番環境では使わない（学習・ローカル開発専用）

次回はWindowsとMac共通で使える「Composerのインストールと使い方」を解説します。PHPの外部ライブラリを管理するために必須のツールです。

The post 第04回: PHPビルトインサーバーの使い方 — インストール不要で即起動する first appeared on 未経験から実務レベルへ｜PHP初心者向け実践学習ブログ.

章: 第2章: GUIツールで即起動

対象OS: Mac

「ターミナルは難しそう」—— GUIから始めて正解

Macにはもともとコマンドラインツールが豊富に揃っていますが、「まずPHPを動かしたい」という段階では、GUIツールの方が迷いが少なく済みます。MAMPはインストールからサーバー起動まですべてGUIで完結するため、ターミナルが苦手な人でも安心して使えます。

MAMPとは何か

MAMPは「Mac + Apache + MySQL + PHP」の頭文字をとったパッケージです。GUIアプリとして動作し、ボタン1つでWebサーバーとデータベースを起動できます。

MAMP と MAMP PRO の違い: 無料版の「MAMP」で十分です。「MAMP PRO」は有料で、バーチャルホストや複数サイト管理などの機能が追加されますが、学習目的では不要です。

インストール手順

### 1. インストーラーをダウンロードする

[https://www.mamp.info/](https://www.mamp.info/) にアクセスし、「MAMP & MAMP PRO」をダウンロードします。

ダウンロードされる .pkg ファイルを開いてインストールします。インストール先はデフォルト（/Applications/MAMP/）のままで構いません。

### 2. MAMPを起動する

/Applications/MAMP/MAMP.app を起動します。Finderの「アプリケーション」フォルダ内の MAMP フォルダにあります。

### 3. サーバーを起動する

MAMPのウィンドウが開いたら「Start Servers」ボタンをクリックします。

• ApacheとMySQLのランプが緑になれば起動成功です
• 自動的にブラウザが開いてMAMPのスタートページが表示されます

チェックポイント: http://localhost:8888/ にアクセスして「MAMP」のページが表示されれば、Webサーバーが動作しています。（MAMPはデフォルトでポート8888を使用します）

PHPファイルを置いて動かす

MAMPの公開ディレクトリは /Applications/MAMP/htdocs/ です。このフォルダにPHPファイルを置くとブラウザからアクセスできます。

<?php
// /Applications/MAMP/htdocs/test.php
phpinfo();

ブラウザで http://localhost:8888/test.php にアクセスして、PHPの設定情報が表示されれば成功です。

PHPバージョンを切り替える

MAMPは複数のPHPバージョンを内蔵しており、GUIから切り替えられます。

1. MAMPのメニューバー → MAMP → Preferences…

2. PHP タブを選択

3. 使用するバージョンをドロップダウンで選択（8.2以上を推奨）

4. OKをクリック → サーバーを再起動

ターミナルから php コマンドを使う

MAMPのPHPをターミナルから使うには、シェルのPATHを設定します。

# ~/.zshrc に追記する（PHP 8.2の場合）
export PATH="/Applications/MAMP/bin/php/php8.2.0/bin:$PATH"

ファイルを保存した後、ターミナルで:

source ~/.zshrc
php -v

バージョンが表示されれば設定完了です。

注意: MAMPのPHPバージョンを切り替えた場合、PATH設定のバージョン番号も手動で更新が必要です。Homebrewでインストールする方法（後述）の方が管理しやすいケースもあります。

フォルダ構成のおすすめ

/Applications/MAMP/htdocs/
├── myproject/
│   ├── index.php
│   └── about.php
└── test.php

ブラウザでは http://localhost:8888/myproject/ のようにアクセスします。

Homebrewを使う方法との比較

Macには Homebrew というパッケージマネージャーがあり、コマンドでPHPをインストールする方法もあります。

まとめ & 次のステップ

• MAMPはGUIだけでApache・MySQL・PHPを管理できるパッケージ
• 公開ディレクトリは /Applications/MAMP/htdocs/
• デフォルトのポートは 8888（http://localhost:8888/）
• ターミナルでも使いたい場合は ~/.zshrc にPATHを追記する

次回はWindowsとMac共通で使える「PHPビルトインサーバーの使い方」を解説します。XAMPPやMAMPなしで、PHPコマンドだけでWebサーバーを起動する方法です。

The post 第03回: MAMPインストールとセットアップ — MacでPHPを最短で動かす first appeared on 未経験から実務レベルへ｜PHP初心者向け実践学習ブログ.

章: 第2章: GUIツールで即起動

対象OS: Windows

「インストールしたのに動かない」—— 順番を間違えると詰まる

Windowsで初めてPHP環境を構築しようとして、公式ドキュメントをそのまま読み進めたら途中で詰まった——そんな経験をする人は少なくありません。インストール自体は難しくないのですが、起動順序とフォルダの場所を間違えると、ブラウザで何も表示されません。

この記事では、XAMPPのインストールからPHPファイルの確認まで、つまずきポイントを先回りして解説します。

XAMPPとは何か

XAMPPは「Apache + MySQL + PHP + Perl」をまとめてインストールできるパッケージです。GUIのコントロールパネルから各サービスをワンクリックで起動・停止できるため、コマンド操作に慣れていない初学者に向いています。

インストール手順

### 1. インストーラーをダウンロードする

[https://www.apachefriends.org/](https://www.apachefriends.org/) にアクセスし、「XAMPP for Windows」をダウンロードします。

注意: ダウンロードするPHPのバージョンは 8.2以上 を推奨します。古いバージョンはサポートが終了しており、ライブラリとの互換性問題が出やすくなっています。

### 2. インストーラーを実行する

ダウンロードした .exe ファイルをダブルクリックして実行します。

• インストール先は C:\xampp のままにすることを強く推奨します（パスにスペースや日本語が含まれるとApacheが起動しないことがあります）
• インストールするコンポーネントは初期設定のままで構いません

### 3. XAMPP Control Panelを起動する

インストール完了後、「XAMPP Control Panel」を起動します。スタートメニューから検索するか、C:\xampp\xampp-control.exe を実行します。

### 4. ApacheとMySQLを起動する

Control Panelで Apache と MySQL の Start ボタンをクリックします。

• ステータスが緑色になれば起動成功です
• Apacheが起動しない場合は「ポート競合」が原因であることがほとんどです（後述のトラブルシューティングを参照）

チェックポイント: http://localhost/ をブラウザで開いて「XAMPP」のウェルカムページが表示されれば、Apacheが正常に動作しています。

PHPファイルを置いて動かす

XAMPPでは、C:\xampp\htdocs\ フォルダが公開ディレクトリです。このフォルダにPHPファイルを置くとブラウザからアクセスできます。

C:\xampp\htdocs\test.php

test.php の内容:

<?php
phpinfo();

ブラウザで http://localhost/test.php にアクセスすると、PHPの設定情報一覧が表示されます。この画面が出れば、PHPが正しく動作しています。

コマンドプロンプトからPHPを使う

XAMPPをインストールした後、コマンドプロンプトから php コマンドを使うには パスの設定 が必要です。

1. スタートメニューで「環境変数」と検索し、「システム環境変数の編集」を開く

2. 「環境変数」ボタンをクリック

3. 「システム環境変数」の Path を選択して「編集」

4. 「新規」で C:\xampp\php を追加

5. OKをクリックして閉じる

コマンドプロンプトを新しく開いて確認:

php -v

バージョンが表示されれば設定完了です。

注意: 環境変数の変更は、変更後に開いたターミナルから有効になります。既に開いているコマンドプロンプトでは反映されません。

ファイルの編集場所

C:\xampp\htdocs\ 以下に自分のプロジェクト用フォルダを作って管理するのが基本的な使い方です。

C:\xampp\htdocs\
├── myproject\
│   ├── index.php
│   └── about.php
└── test.php

ブラウザでは http://localhost/myproject/ のようにアクセスします。

まとめ & 次のステップ

• XAMPPはApache・MySQL・PHPをまとめてセットアップするGUIパッケージ
• インストール先は C:\xampp（スペース・日本語なし）が安全
• PHPファイルは C:\xampp\htdocs\ 以下に置く
• コマンドから php を使うには環境変数 Path に C:\xampp\php を追加する

次回はMacユーザー向けに「MAMPのインストールとセットアップ」を解説します。

The post 第02回: XAMPPインストールとセットアップ — WindowsでPHPを最短で動かす first appeared on 未経験から実務レベルへ｜PHP初心者向け実践学習ブログ.

章: 第1章: 環境の選び方と基礎知識

「どれを使えばいいの?」—— 選択肢が多すぎる問題

PHPを学ぼうと決めてまず検索すると「XAMPP」「MAMP」「Docker」「WAMP」「WSL2」……と、さまざまなキーワードが出てきます。それぞれ何が違うのか、自分にはどれが合っているのか、最初はまったくわかりません。

環境選びで迷っている間は、1行もコードが書けません。

この記事では、主な選択肢をOSと目的ごとに整理して「まず何を選べばいいか」を明確にします。

そもそも「PHPを動かす環境」とは何か

PHPはサーバーサイドの言語です。HTMLのようにブラウザが直接読み込むのではなく、PHPエンジン（インタプリタ）がコードを処理してからブラウザに結果を返します。

これを実現するために最低限必要なものが3つあります。

「環境を構築する」とは、この3つをまとめてセットアップすることを指します。

OSと目的別の選択マップ

### Windowsの場合

### Macの場合

チェックポイント: 学習のスタートはGUIツール（XAMPP/MAMP）が最速です。Dockerは「環境を再現できることの価値」がわかってきてから学ぶと理解が深まります。

WindowsとMacで何が違うのか

PHPの文法やコードは同じですが、環境構築の手順には差があります。主な違いを把握しておきましょう。

MacはもともとUnix系OSのため、Linux系の操作に慣れやすいという特徴があります。一方Windowsは、WSL2を使うとMacに近い操作感で開発できるようになります。

PHPのバージョンをどこで確認するか

環境を構築したら、まず次のコマンドで動作を確認します。

php -v

出力例:

PHP 8.2.12 (cli) ...

8.2 のような形式でバージョンが表示されれば、PHPが正しくインストールされています。このコマンドはWindowsでもMacでも同じです。

まとめ & 次のステップ

• PHP実行には「PHPエンジン」「Webサーバー」「データベース」の3点セットが必要
• Windowsの入門はXAMPP、Macの入門はMAMPが最短の選択肢
• WindowsはWSL2を使うとMacに近い開発体験になる
• コマンドラインに慣れてきたらDockerへ進むのがおすすめ

次回はWindowsユーザー向けに「XAMPPのインストールとセットアップ」を解説します。インストーラーをダウンロードしてから、PHPファイルが動くまでの手順を実際の画面の流れに沿って進めます。

The post 第01回: 開発環境の全体像と選び方 — 迷わず選ぶための比較マップ first appeared on 未経験から実務レベルへ｜PHP初心者向け実践学習ブログ.