PHPファイルをプレビューする方法について

2026年4月12日

PHPファイルをプレビューするには、PHPが実行できる環境でブラウザ表示する必要があります。

HTMLファイルはブラウザで直接開いて表示できますが、PHPファイルは少し仕組みが異なります。

PHPはサーバー側で実行される言語なので、ファイルをそのままダブルクリックして開くだけでは、通常どおりの結果は確認できません。

つまり、PHPファイルの内容を正しく確認するには、PHPを実行できるサーバー環境を使ってブラウザからアクセスする必要があります。

PHPプレビューの基本的な仕組み

たとえば、次のような index.php があるとします。

<?php
echo "こんにちは";
?>

このファイルをブラウザで正しく表示する流れは、次のとおりです。

ブラウザが index.php にアクセスする
サーバーがPHPコードを実行する
実行結果がHTMLとしてブラウザに返される
ブラウザに「こんにちは」と表示される

このように、PHPはブラウザが直接読むのではなく、サーバーが処理した結果を表示する仕組みです。

PHPファイルをそのまま開いてもプレビューできない理由

PHPファイルを file:// で直接開いた場合、ブラウザはPHPを実行しません。

そのため、期待した表示にならず、環境によっては次のような状態になります。

何も正しく表示されない
表示が崩れる
PHPコードがそのまま見えてしまうことがある

重要なのは、PHPが実行されていない状態では、正しいプレビューにならないという点です。

一番手軽な方法：PHPの組み込みサーバーを使う

単体のPHPファイルをすぐに確認したい場合は、PHPに標準で用意されている組み込みサーバーを使う方法が簡単です。

PHPがインストールされているか確認する

ターミナルやコマンドプロンプトで次を実行します。

php -v

PHPのバージョンが表示されれば、実行環境は利用できます。

PHPファイルがあるフォルダに移動する

cd フォルダのパス

例

cd C:\web\sample

または

cd /Users/yourname/web/sample

組み込みサーバーを起動する

php -S localhost:8000

ブラウザでアクセスする

http://localhost:8000

index.php がある場合はそのまま表示されることが多く、別ファイルなら次のようにアクセスします。

http://localhost:8000/sample.php

これで、PHPが実行された結果をブラウザで確認できます。

組み込みサーバーの特徴

この方法は、次のような用途に向いています。

PHP学習の初期段階
単体ファイルの動作確認
簡単なフォームや出力確認
ちょっとしたテスト

ただし、本格的な開発では次のような点に注意が必要です。

ApacheやNginxと完全に同じ挙動ではない
複雑なルーティングやサーバー設定の再現には向かない
CMSやフレームワークでは別の構成が必要になることがある

VS CodeでPHPをプレビューする方法

VS Codeを使っている場合でも、VS Code単体でPHPを実行できるわけではありません。

VS Codeはコードを書くためのエディタであり、PHPの実行そのものは別の環境が担当します。

一般的な流れは次の通りです。

VS CodeでPHPファイルを編集する
ターミナルで php -S localhost:8000 を実行する
ブラウザで http://localhost:8000 を開く

つまり、VS Codeは編集、ブラウザは確認、PHP実行環境は別で必要、という役割分担になります。

Live ServerでPHPはプレビューできるのか

VS Codeには「Live Server」という便利な拡張機能がありますが、これは基本的にHTML・CSS・JavaScriptなどの静的ファイル確認向けです。

そのため、Live Serverだけでは通常、PHPコードは実行されません。

整理するとこうなります。

純粋なHTMLファイルの見た目確認
→ Live Serverでも対応しやすい
PHPの実行結果を確認したい
→ PHP実行環境が必要

PHPファイル内にHTMLが書かれていても、PHP部分を処理した結果を見たいなら、Live Serverだけでは不十分です。

XAMPP・MAMP・Laragonを使う方法

サイト全体をローカルで確認したい場合は、PHPだけでなく、Webサーバーやデータベースをまとめて使えるローカル開発環境が便利です。

代表的なものは以下です。

XAMPP
MAMP
Laragon
Local（WordPress向け）
Docker

これらを使うと、次のような構成をまとめて準備できます。

Apache または Nginx
PHP
MySQL / MariaDB
管理ツール

XAMPPを使った基本的な流れ

たとえばXAMPPでは、次のように進めます。

XAMPPをインストールする
Apacheを起動する
PHPファイルを htdocs 内に配置する

例

C:\xampp\htdocs\sample\index.php

ブラウザでアクセスする

http://localhost/sample/

この方法は、単体ファイルよりもサイト全体をローカルで再現したい場合に向いています。

WordPressのPHPファイルをプレビューする場合

WordPressのPHPファイルは、単体のPHPファイルとは考え方が異なります。

たとえば、以下のようなファイルです。

header.php
footer.php
single.php
page.php
archive.php
functions.php

これらはWordPress本体の中で読み込まれて動作するため、ファイル単体を直接確認しても正しく表示されないことが多いです。

また、WordPressでは次のような要素も関係します。

WordPress本体
データベース
テーマ
プラグイン
パーマリンク設定
wp-config.php
サーバー側のリライトルール

そのため、WordPressを確認したい場合は、php -S だけで済ませるのではなく、WordPress用のローカル環境を構築する方法が現実的です。

よく使われる方法は以下です。

Local
XAMPP
MAMP
Docker
ステージング環境

Laravelなどのフレームワークは専用の起動方法を使う

LaravelやSymfony、CakePHPのようなフレームワークも、単体PHPファイルとは異なります。

アプリケーション全体の仕組みの中で動くため、ファイル単体を開いても正しく確認できない場合があります。

Laravelなら、一般的には次のコマンドを使います。

php artisan serve

そのうえで、ブラウザから次のようなURLにアクセスします。

http://127.0.0.1:8000

このように、フレームワークではその仕組みに合った起動方法で確認するのが基本です。

CSSや画像が正しく表示されない理由

PHPのプレビューでは、PHP本体だけでなく、CSS・JavaScript・画像が正しく読み込まれているかも重要です。

ここでよく起きるのがパスの問題です。

たとえば次のような記述があります。

<link rel="stylesheet" href="/css/style.css">

この /css/style.css は、URLルート基準のパスです。

そのため、プロジェクトがサブルートで動いている場合には、意図した場所を指さないことがあります。

たとえば、

http://localhost/ をルートとして動いているのか
http://localhost/sample/ のようなサブディレクトリで動いているのか

によって、読み込まれる場所が変わることがあります。

このため、CSSや画像が読み込まれない場合は、URLの基準位置を確認することが大切です。

include / require のパスでよくある注意点

PHPでは、次のようにファイルを読み込むことがあります。

<?php include 'header.php'; ?>

この書き方でも動く場合はありますが、相対パスの解釈で迷いやすく、環境によって不安定になることがあります。

より安全なのは、__DIR__ を使ってそのファイル自身を基準にパスを指定する方法です。

<?php include __DIR__ . '/header.php'; ?>

この書き方なら、読み込み元の場所が明確になるため、トラブルを減らしやすくなります。

例：パーツ分割したPHPページの基本構成

たとえば、次のような構成を考えます。

sample/
 ├─ index.php
 ├─ header.php
 ├─ footer.php
 └─ css/
    └─ style.css

index.php

<?php include __DIR__ . '/header.php'; ?>

<h1>トップページ</h1>
<p>これはPHPのプレビュー例です。</p>

<?php include __DIR__ . '/footer.php'; ?>

header.php

<!DOCTYPE html>
<html lang="ja">
<head>
  <meta charset="UTF-8">
  <title>サンプル</title>
  <link rel="stylesheet" href="css/style.css">
</head>
<body>

footer.php

</body>
</html>

このように分けておくと、ページ共通部分を整理しやすくなります。

PHPプレビューでよくあるエラー

何も表示されない、または白画面になる

PHPでは、エラーが発生していても画面に出ない設定だと、真っ白に見えることがあります。

このような場合は、開発用としてエラー表示を確認します。

<?php
ini_set('display_errors', 1);
error_reporting(E_ALL);
?>

ただし、環境によってはこれだけでは十分でないこともあり、エラーログの確認が必要になる場合もあります。

本番環境で常時表示するのは避けたほうが安全です。

500エラーが出る

500エラーは「サーバー側で問題が起きた」ことを示します。

原因は環境によって異なりますが、よくある例は以下です。

PHPの構文エラー
致命的な実行エラー
読み込みファイルの不備
サーバー設定やリライトルールの問題
PHPバージョンの差異

500エラーは原因がひとつとは限らないため、ログを見ることが近道です。

CSSが当たらない

この場合は、次の点を確認します。

読み込みパスが正しいか
URLの基準位置がずれていないか
キャッシュが残っていないか
ブラウザの開発者ツールで404になっていないか

PHP自体は動いていても、アセットのパスがずれていると見た目は崩れます。

どの方法を選べばよいか

目的ごとに選ぶとわかりやすいです。

すぐに単体ファイルを確認したい

PHPの組み込みサーバー

サイト全体をローカルで確認したい

XAMPP / MAMP / Laragon

WordPressテーマやプラグインを確認したい

Local / XAMPP / MAMP / Docker / ステージング環境

Laravelなどのフレームワークを確認したい

フレームワーク専用の起動コマンド

本番に近い形で再現したい

Docker などの環境構築ツール

初心者におすすめの最短手順

はじめてPHPをプレビューするなら、まずはこの方法がわかりやすいです。

PHPをインストールする
PHPファイルを1つのフォルダに置く
ターミナルでそのフォルダへ移動する
次を実行する

php -S localhost:8000

ブラウザで開く

http://localhost:8000

まずはここから始めると、PHPファイルをブラウザで確認する基本の流れを理解しやすくなります。

まとめ

PHPファイルをプレビューするには、PHPを実行できる環境を使ってブラウザからアクセスする必要があります。

HTMLのように直接開くだけでは、通常の意味でのプレビューにはなりません。

基本的な考え方は次のとおりです。

単体PHPなら php -S localhost:8000 が手軽
VS CodeやLive ServerだけではPHP実行はできない
WordPressやLaravelは、アプリ全体の環境で確認する必要がある
CSSや画像の表示崩れはパス指定を確認する
エラー時は画面表示だけでなくログ確認も重要

まずは小さなPHPファイルで組み込みサーバーを試し、そのあと必要に応じてXAMPPやWordPress用ローカル環境へ進むと、理解しやすく実践にもつながります。

以上、PHPファイルをプレビューする方法についてでした。

最後までお読みいただき、ありがとうございました。

よかったらシェアしてね！

URLをコピーしました！

URLをコピーしました！