PHPは、2026年現在も多くのWebシステムやCMSの基盤として広く利用されています。

しかし、開発中や本番環境へのデプロイ時に「プログラムが意図した通りに動かない」というトラブルは、初心者からベテランまで避けては通れない課題です。

コードに一箇所ミスがあるだけで画面が真っ白になったり、サーバーの設定不備でエラーすら表示されなかったりと、原因の特定に時間がかかることも少なくありません。

本記事では、PHPが動作しない時の基本的な確認事項から、最新のPHP 8.x系（8.3、8.4以降）特有の注意点、さらに効率的なデバッグ方法までを網羅して解説します。

トラブルを早期に解決し、開発の生産性を向上させるためのチェックリストとして活用してください。

目次 [ close ]
  1. PHPが動かないときにまず確認すべき基本事項
    1. エラー表示設定の確認
    2. サーバーログの確認
  2. 症状別：PHPが動作しない原因と解決策
    1. 画面が真っ白になる (White Screen of Death)
    2. 500 Internal Server Error が発生する
    3. 構文エラー (Syntax Error)
  3. 環境起因のトラブルチェックリスト
    1. PHPバージョンの不一致と非推奨機能
    2. 必須拡張モジュールの不足
  4. データベース接続に関するトラブル
    1. 接続情報の誤り
    2. 文字コードの不一致
  5. デバッグを効率化する最新の対処法
    1. Xdebugの導入
    2. 静的解析ツールの活用
    3. Docker環境でのネットワーク確認
  6. 開発環境別の注意点
    1. 共有レンタルサーバー
    2. ローカル開発環境 (XAMPP / MAMP / Herd)
    3. クラウド・コンテナ環境
  7. まとめ

PHPが動かないときにまず確認すべき基本事項

PHPが正常に動作しない場合、まずは「何が原因で止まっているのか」を特定するための情報を集める必要があります。

エラー内容が表示されない状態では、解決への道筋を立てることは困難です。

エラー表示設定の確認

多くのレンタルサーバーや本番環境では、セキュリティ上の理由からエラー内容を画面に出力しない設定になっています。

開発環境でプログラムが動かない場合は、まずPHPのエラー表示を強制的に有効化して、具体的なエラーメッセージを確認しましょう。

以下のコードをPHPファイルの先頭に記述することで、ブラウザ上にエラー情報を出力させることができます。

PHP
<?php
// すべてのエラーを表示する設定
ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

echo "デバッグ中...";
// ここから下に動かないコードを記述

この設定を行うことで、Parse error（構文エラー）やFatal error（致命的なエラー）が画面に表示されるようになります。

サーバーログの確認

画面に何も表示されない場合（ホワイトスクリーン現象など）は、Webサーバー（ApacheやNginx）のエラーログファイルを直接確認するのが最も確実です。

PHPの処理が開始される前の段階でエラーが発生している場合、PHPの設定変更だけでは原因を特定できません。

一般的なログファイルの場所は以下の通りです。

サーバー/OSログファイルの一般的なパス
Apache (Linux)/var/log/httpd/error_log または /var/log/apache2/error.log
Nginx (Linux)/var/log/nginx/error.log
PHP-FPM/var/log/php-fpm/error.log

「Permission denied」や「File not found」といったログが残っていれば、PHPのコードではなくサーバーの権限やパス設定に問題があることがわかります。

症状別：PHPが動作しない原因と解決策

「動かない」と言っても、その症状は多岐にわたります。

ここではよく遭遇するトラブルを症状別に分類し、その対処法を解説します。

画面が真っ白になる (White Screen of Death)

PHPで最も頻繁に遭遇する問題の一つが、ブラウザに何も表示されず真っ白な画面になる現象です。

これは主に「致命的なエラーが発生したが、エラー表示がオフになっている」場合に起こります。

メモリ制限への到達

PHPには1つのスクリプトが使用できるメモリの上限（memory_limit）があります。

大量の画像処理や巨大なデータの読み込みを行うと、この制限を超えて処理が強制終了されます。

PHP
// php.ini またはコード内でメモリ制限を拡張する例
ini_set('memory_limit', '512M');

タイムアウト

処理に時間がかかりすぎると、WebサーバーやPHPの実行時間制限（max_execution_time）に引っかかり、途中で終了してしまいます。

ループ処理が無限ループになっていないか、外部APIのレスポンス待ちで止まっていないかを確認しましょう。

500 Internal Server Error が発生する

このエラーはWebサーバー側から返されるもので、プログラム自体に重大な欠陥があるか、サーバーの設定ファイルに誤りがあることを示しています。

.htaccess の記述ミス

Apacheサーバーを使用している場合、.htaccessファイルの記述に誤りがあると500エラーが発生します。

  • 許可されていないディレクティブを記述している
  • 改行コードが適切でない
  • スペルミスがある

一旦.htaccessのリネーム（例：_htaccessに変更）を行い、エラーが解消されるかを確認してください。

パーミッションの設定

PHPファイルや、そのファイルが設置されているディレクトリのパーミッションが適切でない場合にエラーとなります。

一般的には、ファイルは644、ディレクトリは755に設定されるのが標準的です。

構文エラー (Syntax Error)

PHPの文法規則に従っていない場合に発生します。

PHP 8.x以降では、以前のバージョンでは警告（Warning）だったものがエラー（Error）に格上げされているケースがあるため注意が必要です。

よくある構文ミスの例

  • 行末のセミコロン（;）忘れ
  • カッコ（{ }, ( ), [ ]）の閉じ忘れ
  • 変数名のドル記号（$）忘れ
  • 引用符（'や"）の不整合
PHP
<?php
// 間違いの例
$data = ["apple", "banana" // 閉じカッコ ] がない

if (true) {
    echo "Hello" // セミコロン ; がない
}

環境起因のトラブルチェックリスト

コード自体に問題がなくても、動作環境の差異や設定によってPHPが動かないことがあります。

PHPバージョンの不一致と非推奨機能

2026年現在、多くのシステムがPHP 8.2以上へ移行しています。

古いPHP 7.x系で動作していたコードを最新環境に持ってきた場合、過去に非推奨とされていた機能が完全に削除されているため動作しません。

PHP 8.x系での主な変更点

  • Undefined propertyの警告強化：定義されていないプロパティへのアクセスが厳格化されました。
  • 動的プロパティの非推奨化：クラス内で定義していない変数に値を代入することが原則禁止されました（#[AllowDynamicProperties]アトリビュートが必要）。
  • 関数の引数の厳格化：組み込み関数に無効な型の値を渡した際、以前はnullを返していたものがTypeErrorを投げるようになっています。

必須拡張モジュールの不足

PHPの機能の多くは「拡張モジュール」として提供されています。

特定の関数（mb_convert_encodingやcurl_initなど）が「Undefined function」としてエラーになる場合は、モジュールがインストールされていないか、有効化されていません。

以下のコマンド（CLIの場合）またはphpinfo()関数を使用して、必要なモジュールが含まれているか確認してください。

Shell
php -m | grep mbstring

特にマルチバイト文字を扱うmbstringや、データベース接続に必要なpdo_mysql、画像の加工を行うgdなどは必須となるケースが多いです。

データベース接続に関するトラブル

PHPプログラム自体は動作していても、データベース（MySQL/MariaDBなど）に接続できず、結果として「システムが動かない」状態になることがあります。

接続情報の誤り

接続に必要なホスト名、ユーザー名、パスワード、ポート番号のいずれかが間違っているケースです。

特にDocker環境やクラウド環境（AWS, Azureなど）では、「localhost」ではなくコンテナ名やエンドポイントを指定する必要がある点に注意してください。

PHP
<?php
$dsn = 'mysql:host=db_container;dbname=test_db;charset=utf8mb4';
$user = 'db_user';
$password = 'db_pass';

try {
    $pdo = new PDO($dsn, $user, $password);
    echo "接続成功";
} catch (PDOException $e) {
    // 接続失敗時の詳細を表示
    echo "接続エラー: " . $e->getMessage();
}

実行結果（失敗時）:

text
接続エラー: SQLSTATE[HY000] [2002] Connection refused

この「Connection refused」が出る場合は、データベースサーバーが起動していないか、指定したポートが閉じている、あるいは接続元のIPアドレスが許可されていない可能性があります。

文字コードの不一致

PHP 8.x系と最新のMySQL（8.x以降）を組み合わせる場合、デフォルトの文字コードがutf8mb4になっていることが推奨されます。

古いコードでutf8を指定していると、絵文字や一部の特殊文字の入力時にエラーが発生したり、文字化けしたりすることがあります。

デバッグを効率化する最新の対処法

2026年の開発環境において、原始的な「echoデバッグ」だけで解決するのは非効率です。

ツールを活用してスマートに原因を特定しましょう。

Xdebugの導入

XdebugはPHP開発において必須と言えるデバッグツールです。これを利用すると、プログラムを一行ずつ実行（ステップ実行）したり、特定の時点での変数の値を詳細に確認したりできます。

VS Codeなどのエディタと連携させることで、コード上の任意の場所に「ブレークポイント」を設置し、処理を一時停止させることが可能です。

「なぜこのif文の中に入らないのか」といった論理的なバグの特定に極めて有効です。

静的解析ツールの活用

実行前にコードの問題を見つける「静的解析ツール」の導入も検討してください。

  • PHPStan
  • Psalm

これらのツールは、コードを実行することなく「型の間違い」や「未定義の変数の使用」「将来的に削除される機能の使用」を指摘してくれます。

動かない原因を探る前に、これらのツールでチェックをかけることで、初歩的なミスを100%排除できます。

Docker環境でのネットワーク確認

現代のPHP開発はDockerを用いるのが一般的ですが、コンテナ間で通信ができないために「動かない」と悩むケースが増えています。

  • docker-compose.ymlでネットワークが共通化されているか
  • コンテナ内のPHP設定ファイル（php.ini）が正しくマウントされているか
  • ログが標準出力（stdout）に流れる設定になっているか

これらを確認するために、docker compose logs -fコマンドを常時流しておく習慣をつけましょう。

開発環境別の注意点

利用している環境によって、PHPが動かない原因の傾向が異なります。

共有レンタルサーバー

共有サーバーでは、php.iniを直接編集できない場合があります。

その際は.user.iniというファイルを作成して設定を上書きするか、コントロールパネルから設定変更を行う必要があります。

また、WAF（Web Application Firewall）が有効になっていると、特定のPOST送信がブロックされ、PHPまでリクエストが届かないことがあるため、一時的にWAFをオフにしてテストを行うのも有効です。

ローカル開発環境 (XAMPP / MAMP / Herd)

ローカル環境では、複数のPHPバージョンが混在していることによるトラブルが目立ちます。

コマンドラインで使用しているPHPと、Webブラウザ経由で動作しているPHPのバージョンが異なっていることが原因で、ライブラリの依存関係（Composer）が崩れるケースがあります。

常にwhich phpやphp -vで現在のパスを確認しましょう。

クラウド・コンテナ環境

AWS Lambda（Brefなどを使用）やGoogle Cloud RunでPHPを動かす場合、ファイルシステムが「読み取り専用」であることに起因するエラーが発生しがちです。

キャッシュファイルやログファイルの書き込み先を/tmpディレクトリに変更するか、外部ストレージを利用するようコードを修正する必要があります。

まとめ

PHPが動かない原因は、単純なタイポ（入力ミス）から、サーバーの複雑なネットワーク設定、PHPのバージョンアップに伴う仕様変更まで多岐にわたります。

しかし、どのような場合でも「エラーログを確認する」「環境の差異を把握する」「適切なデバッグツールを使う」という3つのステップを踏めば、必ず解決の糸口が見えてきます。

トラブルに遭遇した際は、まず冷静に現状を分析しましょう。

画面が白いのか、エラーコード（500や404）が出ているのか、あるいはエラーログに何か書き込まれていないか。

本記事で紹介したチェックリストを一つずつ確認していくことで、2026年のモダンなPHP開発においても、迅速かつ的確にトラブルを解消できるはずです。

最後に、PHPは進化の速い言語です。

常に最新の公式ドキュメントや変更点（Changelog）を参照する習慣をつけ、古い知識に縛られない柔軟なデバッグスキルを身につけていきましょう。