【PHP】「Parse error: syntax error, unexpected」エラーの原因と解決方法｜全パターン完全解説

この記事で解決できるエラーパターン

• unexpected } / expecting } — 波括弧の問題
• unexpected ; — セミコロンの位置ミス
• unexpected T_STRING — 文字列・クォートの問題
• unexpected , / expecting , — カンマの問題
• unexpected T_VARIABLE — 変数の前のエラー
• unexpected T_FUNCTION / T_CLASS — PHPバージョン非対応
• unexpected ( / ) — 括弧の不一致
• unexpected end of file — ファイル末尾の問題
• unexpected T_ECHO / T_IF / T_WHILE — 制御構文のエラー
• WordPress / フレームワーク特有のParse error

Parse error: syntax error, unexpected 'X', expecting 'Y' in /path/to/file.php on line N

Parse error: syntax error, unexpected T_VARIABLE, expecting ';' in /var/www/test.php on line 5

注意：Parse error で表示される行番号は「エラーが検出された行」であり、「実際にミスがある行」とは限りません。多くの場合、エラー行の1〜2行前に本当の原因があります。必ず前後の行も確認しましょう。

<?php
$name = 'John'
$age = 25;    // ← ここでエラー報告（line 3）
echo 'Hello';

ポイント：エラーが報告された行にミスが見つからない場合は、必ず1〜3行前を確認しましょう。特にセミコロン忘れ、クォートの閉じ忘れが多いパターンです。

Parse error: syntax error, unexpected end of file, expecting '}' in /var/www/test.php on line 20

function calculateTotal($items) {
    $total = 0;
    foreach ($items as $item) {
        if ($item['price'] > 0) {
            $total += $item['price'];
        }
    // ← foreach の閉じ括弧 } がない！
}  // ← これは function の閉じ括弧

function calculateTotal($items) {
    $total = 0;
    foreach ($items as $item) {
        if ($item['price'] > 0) {
            $total += $item['price'];
        }
    }  // ← foreach の閉じ括弧を追加
    return $total;
}

Parse error: syntax error, unexpected '}' in /var/www/test.php on line 7

function greet($name) {
    if ($name !== '') {
        echo "Hello, $name!";
    }
}
}  // ← 余分な閉じ波括弧！

function greet($name) {
    if ($name !== '') {
        echo "Hello, $name!";
    }
}  // ← 余分な } を削除

function processOrder($order) {
    if ($order['status'] === 'pending') {
        if ($order['total'] > 0) {
            if ($order['payment'] === 'credit') {
                processCredit($order);
            } else {
                processCash($order);
            }
        // ← if ($order['total'] > 0) の } がない！
    } else {
        echo "Order already processed";
    }
}

function processOrder($order) {
    if ($order['status'] === 'pending') {
        if ($order['total'] > 0) {
            if ($order['payment'] === 'credit') {
                processCredit($order);
            } else {
                processCash($order);
            }
        }  // ← 閉じ括弧を追加
    } else {
        echo "Order already processed";
    }
}

ポイント：波括弧の対応を確認するには、エディタの「括弧のハイライト機能」を使いましょう。VSCode では波括弧にカーソルを置くと、対応する括弧がハイライトされます。

switch ($status) {
    case 'active':
        echo "Active";
        break;
    case 'inactive':
        echo "Inactive";
        break;
    default:
        echo "Unknown";
// ← switch の閉じ波括弧 } がない！

switch ($status) {
    case 'active':
        echo "Active";
        break;
    case 'inactive':
        echo "Inactive";
        break;
    default:
        echo "Unknown";
}  // ← 閉じ括弧を追加

class User {
    private $name;
    private $email;

    public function __construct($name, $email) {
        $this->name = $name;
        $this->email = $email;
    // ← __construct の閉じ括弧 } がない！

    public function getName() {
        return $this->name;
    }
}

class User {
    private $name;
    private $email;

    public function __construct($name, $email) {
        $this->name = $name;
        $this->email = $email;
    }  // ← 閉じ括弧を追加

    public function getName() {
        return $this->name;
    }
}

波括弧エラーの予防策

• 適切なインデントを徹底する（タブまたはスペース4つ）
• { を書いたら即座に } も書き、その間にコードを入れる
• VSCode の Bracket Pair Colorization を有効にして、対応する括弧を色で識別する
• ネストが3階層以上になったら、早期リターン（Early Return）でネストを減らすことを検討する
• // end foreach のようなコメントを閉じ括弧の後に書く

function processUser($user) {
    if ($user !== null) {
        if ($user->isActive()) {
            if ($user->hasPermission()) {
                // メイン処理
                return $user->process();
            }
        }
    }
    return false;
}

function processUser($user) {
    if ($user === null) {
        return false;
    }
    if (!$user->isActive()) {
        return false;
    }
    if (!$user->hasPermission()) {
        return false;
    }
    // メイン処理
    return $user->process();
}

Parse error: syntax error, unexpected ';' in /var/www/test.php on line 3

// for文の括弧内でカンマの代わりにセミコロンを使用
for ($i = 0; $j = 0; $i < 10; $i++; $j++) {
    // 4つのセミコロンがある（3つまで）
}

// 同じパートの複数式はカンマで区切る
for ($i = 0, $j = 0; $i < 10; $i++, $j++) {
    // セミコロンは2つだけ（初期化;条件;更新）
}

注意：for文の構文は for (初期化; 条件; 更新) の3パートで、セミコロンは2つだけ使います。各パート内で複数の式を書く場合はカンマで区切ります。

// 関数定義の末尾にセミコロンを付けてしまった
function add($a, $b); {
    return $a + $b;
}

function add($a, $b) {
    return $a + $b;
}

$colors = [
    'red';    // ← カンマではなくセミコロン！
    'green';
    'blue'
];

$colors = [
    'red',    // ← カンマに修正
    'green',
    'blue'
];

if ($count > 0); {   // ← 条件の後にセミコロン！
    echo "Items found";
}

注意：この場合、PHPバージョンによっては Parse error にならず、空文（empty statement）として解釈されることがあります。その場合、if の条件に関係なく波括弧内のコードが常に実行されてしまうため、別の意味で問題になります。

if ($count > 0) {   // ← セミコロンを削除
    echo "Items found";
}

class Config {
    public $settings = [
        'debug' => true;     // ← カンマではなくセミコロン！
        'cache' => false;
    ];
}

class Config {
    public $settings = [
        'debug' => true,     // ← カンマに修正
        'cache' => false,
    ];
}

$greet = function($name) {
    return "Hello, $name";
}  // ← 無名関数の代入にはセミコロンが必要！

$result = $greet('World');

$greet = function($name) {
    return "Hello, $name";
};  // ← セミコロンを追加

$result = $greet('World');

ポイント：通常の関数定義（function foo() {}）にはセミコロンが不要ですが、無名関数を変数に代入する場合は文の終端なのでセミコロンが必要です。

Parse error: syntax error, unexpected T_STRING, expecting ',' or ';'

echo 'It's a beautiful day';
// PHPは 'It' で文字列が終わったと認識し、
// s が T_STRING（識別子）として検出される

echo 'It\'s a beautiful day';

echo "It's a beautiful day";

echo <<<EOT
It's a beautiful day
EOT;

$html = "<a href="https://example.com">Link</a>";
// ← 二重引用符の中に二重引用符がそのまま入っている

$html = "<a href="https://example.com">Link</a>";

$html = '<a href="https://example.com">Link</a>';

$html = <<<HTML
<a href="https://example.com">Link</a>
HTML;

$sql = "SELECT * FROM users WHERE name = 'O'Brien'";
// ← シングルクォート内のアポストロフィが問題

// プリペアドステートメントを使うのが最善
$stmt = $pdo->prepare("SELECT * FROM users WHERE name = ?");
$stmt->execute(['O\'Brien']);

// 'list' はPHPの予約語
function list($items) {
    foreach ($items as $item) {
        echo $item;
    }
}

// 予約語を避けた名前に変更
function listItems($items) {
    foreach ($items as $item) {
        echo $item;
    }
}

echo "Hello, " $name;
// ← 結合演算子 . がない

// 方法1: 結合演算子を使う
echo "Hello, " . $name;

// 方法2: ダブルクォート内に変数を埋め込む
echo "Hello, $name";

// 方法3: 波括弧で囲む（推奨）
echo "Hello, {$name}";

$path = "C:
ew	estfile.txt";
// 
 が改行、	 がタブとして解釈される

// 方法1: バックスラッシュをエスケープ
$path = "C:\new\test\file.txt";

// 方法2: シングルクォート
$path = 'C:
ew	estfile.txt';

// 方法3: スラッシュを使う（PHPはWindowsでも/を理解する）
$path = "C:/new/test/file.txt";

// 引数の間に値がないカンマ
myFunction($a, , $c);   // ← 第2引数がない

// 引数を正しく指定
myFunction($a, $b, $c);

// または引数を省略したい場合はデフォルト値を設定
function myFunction($a, $b = null, $c) {
    // ...
}

$data = [
    'name' => 'John',
    'age' => ,     // ← 値がない！
    'email' => 'john@example.com',
];

$data = [
    'name' => 'John',
    'age' => 25,     // ← 値を指定
    'email' => 'john@example.com',
];

// 関数呼び出しの末尾カンマ（PHP 7.3+ で対応）
myFunction(
    $arg1,
    $arg2,   // ← PHP 7.2以前ではエラー
);

// 関数定義の末尾カンマ（PHP 8.0+ で対応）
function myFunc(
    $param1,
    $param2,   // ← PHP 7.4以前ではエラー
) {
    // ...
}

ポイント：末尾カンマはGit差分を見やすくし、配列やパラメータの追加・削除時にエラーを防ぐ効果があります。プロジェクトのPHPバージョンを確認して、対応している場合は積極的に使いましょう。

$config = [
    'host' => 'localhost'    // ← カンマがない！
    'port' => 3306,
    'name' => 'mydb',
];

$config = [
    'host' => 'localhost',    // ← カンマを追加
    'port' => 3306,
    'name' => 'mydb',
];

$result = match($status) {
    'active' => '有効'     // ← カンマがない！
    'inactive' => '無効',
    default => '不明',
};

$result = match($status) {
    'active' => '有効',     // ← カンマを追加
    'inactive' => '無効',
    default => '不明',
};

$name = 'John'     // ← セミコロンがない！
$age = 25;          // ← ここでエラー報告

$name = 'John';     // ← セミコロンを追加
$age = 25;

$message = 'Hello '
            $name         // ← 結合演算子 . がない
            ', welcome!';

$message = 'Hello '
            . $name       // ← . を追加
            . ', welcome!';

$user = [
    'name' $name,     // ← => がない！
    'age' => $age,
];

$user = [
    'name' => $name,   // ← => を追加
    'age' => $age,
];

echo 'Name: ' $name;   // ← 結合演算子がない

// 方法1: 結合演算子
echo 'Name: ' . $name;

// 方法2: カンマ区切り（echo のみ可能）
echo 'Name: ', $name;

// 方法3: ダブルクォートで変数展開
echo "Name: $name";

$result = $value > 0    // ← ? がない
          'positive' : 'non-positive';

$result = $value > 0 ? 'positive' : 'non-positive';

// PHP 8.0+ では null合体演算子も便利
$name = $data['name'] ?? 'Unknown';

$length = strlen $text;   // ← 括弧がない

$length = strlen($text);   // ← 括弧を追加

// アロー関数は PHP 7.4+ の機能
$doubled = array_map(fn($n) => $n * 2, $numbers);

$doubled = array_map(function($n) {
    return $n * 2;
}, $numbers);

// 名前付き引数は PHP 8.0+ の機能
$result = str_contains(haystack: $text, needle: 'hello');

// 通常の位置引数を使う
$result = strpos($text, 'hello') !== false;

// match式は PHP 8.0+ の機能
$label = match($status) {
    1 => 'Active',
    2 => 'Inactive',
    default => 'Unknown',
};

// switch文で書き直す
switch ($status) {
    case 1:
        $label = 'Active';
        break;
    case 2:
        $label = 'Inactive';
        break;
    default:
        $label = 'Unknown';
}

// コンストラクタプロモーションは PHP 8.0+ の機能
class User {
    public function __construct(
        private string $name,
        private int $age,
    ) {}
}

class User {
    private $name;
    private $age;

    public function __construct(string $name, int $age) {
        $this->name = $name;
        $this->age = $age;
    }
}

// Enum は PHP 8.1+ の機能
enum Status: string {
    case Active = 'active';
    case Inactive = 'inactive';
}

// クラス定数で代替
class Status {
    const ACTIVE = 'active';
    const INACTIVE = 'inactive';
}

ポイント：自分のPHPバージョンを確認するには、php -v コマンドまたは phpinfo() を実行しましょう。サーバーとローカルのバージョンが異なる場合も多いので、両方を確認してください。

namespace AppControllers;

// use文の後にセミコロンを忘れた
use AppModelsUser

class UserController {   // ← T_CLASS が unexpected
    // ...
}

namespace AppControllers;

use AppModelsUser;   // ← セミコロンを追加

class UserController {
    // ...
}

// 関数の戻り値に対する即時配列アクセス
$first = explode(',', $csv)[0];  // PHP 5.4+

$parts = explode(',', $csv);
$first = $parts[0];

if ((is_array($data) && (count($data) > 0)) {
    // 開き括弧が3つ、閉じ括弧が2つ
}

if (is_array($data) && (count($data) > 0)) {
    // 開き括弧と閉じ括弧が2つずつ
}

// new の結果に対する即時メソッド呼び出し
$result = (new MyClass())->method();  // PHP 5.4+

$obj = new MyClass();
$result = $obj->method();

// 関数定義でのスプレッド演算子
function sum(int ...$numbers): int {
    return array_sum($numbers);
}

// 引数のアンパックは PHP 5.6+ で対応
sum(...$values);

if (
    ($user->isActive() || $user->isAdmin())
    && ($user->hasPermission('edit')
    || ($user->getRole() === 'superadmin')
) {
    // 括弧の対応が取れていない
}

$isActiveOrAdmin = $user->isActive() || $user->isAdmin();
$hasEditAccess = $user->hasPermission('edit')
    || $user->getRole() === 'superadmin';

if ($isActiveOrAdmin && $hasEditAccess) {
    // 読みやすく、括弧エラーも防げる
}

ポイント：複雑な条件式は、意味のある変数名に分解すると括弧の不一致を防げるだけでなく、コードの可読性も大幅に向上します。

Parse error: syntax error, unexpected end of file, expecting '}' in /var/www/test.php on line 50

function process($data) {
    if ($data) {
        foreach ($data as $item) {
            echo $item;
        }
    }
// ← function の } がない！ ファイル終了

function process($data) {
    if ($data) {
        foreach ($data as $item) {
            echo $item;
        }
    }
}  // ← 閉じ括弧を追加

<?php
$title = 'My Page';
// <?php の閉じタグを忘れたまま HTML に入ると...
<html>
<head><title></title></head>

<?php
$title = 'My Page';
?>
<html>
<head><title><?php echo $title; ?></title></head>

注意：純粋なPHPファイル（HTMLを含まない）では、閉じタグ ?> は省略するのが推奨です。閉じタグの後に空白や改行があると、「Headers already sent」エラーの原因になります。

$html = <<<HTML
<div class="container">
    <h1>Hello World</h1>
</div>
  HTML;   // ← PHP 7.2以前ではインデント不可！

$html = <<<HTML
<div class="container">
    <h1>Hello World</h1>
</div>
HTML;   // ← 行頭に置く（インデントなし）

ポイント：PHP 7.3 以降では、ヒアドキュメントの終了マーカーをインデントできるようになりました。7.2 以前では行頭に置く必要があります。

$message = "This is a very long string
that spans multiple lines
but the closing quote is missing;
// ← 閉じダブルクォートがない！

echo $message;  // ← ここもまだ文字列の中と解釈される

$message = "This is a very long string "
    . "that spans multiple lines "
    . "and each line is properly quoted";

echo $message;

// <?php タグがない
$name = 'John';
echo "Hello, $name";

<?php
$name = 'John';
echo "Hello, $name";

function test() {
    /* コメントアウト開始
    $a = 1;
    $b = 2;
    閉じるのを忘れた

    return $a + $b;
}

function test() {
    /* コメントアウト開始
    $a = 1;
    $b = 2;
    ここで閉じる */

    $a = 1;
    $b = 2;
    return $a + $b;
}

$name = 'John'     // ← セミコロンがない
echo $name;          // ← unexpected T_ECHO

$name = 'John';
echo $name;

<?php if ($loggedIn) { ?>
    <p>Welcome!</p>
    <?php if ($isAdmin) { ?>     // ここまでOK
        <p>Admin Panel</p>
    <?php } ?>
<?php } ?>
<!-- ↑ 閉じの } が1つ足りない or 多い場合エラー -->

<?php if ($loggedIn): ?>
    <p>Welcome!</p>
    <?php if ($isAdmin): ?>
        <p>Admin Panel</p>
    <?php endif; ?>
<?php endif; ?>

ポイント：HTMLとPHPを混在させる場合は、代替構文（if(): ... endif;、foreach(): ... endforeach;）を使うと、対応関係が明確になりエラーを防げます。

$result = if ($value > 0) 'positive' else 'negative';
// ← if は式（expression）ではなく文（statement）

// 三項演算子を使う
$result = $value > 0 ? 'positive' : 'negative';

// PHP 8.0+ では match式も使える
$result = match(true) {
    $value > 0 => 'positive',
    default => 'negative',
};

<? echo 'Hello'; ?>
// short_open_tag が Off だとPHPとして認識されない

// 常にフルタグを使う
<?php echo 'Hello'; ?>

// ショートechoタグは PHP 5.4+ で常に使用可能
<?= 'Hello' ?>

foreach ($items as $item) {
    $total += $item['price']    // ← セミコロンがない
    if ($item['tax']) {      // ← unexpected T_IF
        $total += $item['tax'];
    }
}

foreach ($items as $item) {
    $total += $item['price'];    // ← セミコロンを追加
    if ($item['tax']) {
        $total += $item['tax'];
    }
}

注意：WordPress の管理画面（/wp-admin/）も表示されなくなるため、管理画面からの修正ができません。FTPまたはSSHでファイルを直接修正する必要があります。

# SSHでサーバーに接続
ssh user@your-server.com

# functions.php を編集
vi /path/to/wp-content/themes/your-theme/functions.php

# または直前のバックアップに戻す
cp /path/to/backup/functions.php /path/to/wp-content/themes/your-theme/functions.php

-- 現在のテーマを確認
SELECT option_value FROM wp_options
WHERE option_name = 'template';

-- デフォルトテーマに切り替え
UPDATE wp_options SET option_value = 'twentytwentyfour'
WHERE option_name = 'template';

UPDATE wp_options SET option_value = 'twentytwentyfour'
WHERE option_name = 'stylesheet';

// デバッグモードを有効にしてエラーの詳細を表示
define('WP_DEBUG', true);
define('WP_DEBUG_DISPLAY', true);
define('WP_DEBUG_LOG', true);
// エラーログは wp-content/debug.log に出力される

// DB接続情報でクォートのミス
define('DB_PASSWORD', 'my'password');  // ← エラー

// 修正: エスケープまたはダブルクォート
define('DB_PASSWORD', 'my\'password');
// または
define('DB_PASSWORD', "my'password");

# Composer autoload でParse errorが出た場合
# autoloadキャッシュをクリア
composer dump-autoload

# キャッシュのクリア
php artisan cache:clear
php artisan config:clear
php artisan view:clear

# 特定のファイルの構文チェック
php -l app/Http/Controllers/UserController.php

# CakePHP のキャッシュクリア
bin/cake cache clear_all

# Symfony のキャッシュクリア
php bin/console cache:clear

# プロジェクト全体の構文チェック
find . -name "*.php" -exec php -l {} ; | grep -i "error"

フレームワークでの Parse error 対策

• 本番環境にデプロイする前に、ローカルで構文チェックを行う
• Git を使って変更履歴を管理し、いつでも前のバージョンに戻せるようにする
• CI/CD パイプラインに php -l による構文チェックを組み込む
• WordPress の場合、子テーマを使ってカスタマイズし、親テーマのアップデートで壊れないようにする
• ステージング環境で動作確認してから本番にデプロイする

Parse error: syntax error, unexpected T_VARIABLE in /var/www/test.php on line 10

シンタックスハイライトで分かること

• 文字列のクォートが閉じていない → その行以降がすべて文字列色になる
• 波括弧が対応していない → 対応する括弧のハイライトがずれる
• 予約語のスペルミス → キーワードの色が付かない
• コメントが閉じていない → その行以降がコメント色になる

# 単一ファイルの構文チェック
php -l test.php

# 正常な場合の出力
No syntax errors detected in test.php

# エラーがある場合の出力
Parse error: syntax error, unexpected end of file in test.php on line 15
Errors parsing test.php

# Linux / macOS
find . -name "*.php" -exec php -l {} ; 2>&1 | grep -v "No syntax"

# Windows（PowerShell）
Get-ChildItem -Recurse -Filter *.php | ForEach-Object {
    php -l $_.FullName 2>&1
} | Where-Object { $_ -notmatch "No syntax" }

{
    // PHP実行ファイルのパスを設定
    "php.validate.executablePath": "C:/xampp/php/php.exe",
    "php.validate.enable": true,
    "php.validate.run": "onType",

    // 推奨拡張機能
    // - PHP Intelephense（構文チェック + 補完）
    // - PHP Debug（Xdebug連携）
    // - Error Lens（エラーをインラインで表示）
}

; 開発環境では有効にする
display_errors = On
error_reporting = E_ALL

; 本番環境では無効にし、ログに記録
display_errors = Off
log_errors = On
error_log = /var/log/php_errors.log

// ただし Parse error は実行前に発生するため
// 同じファイル内でこの設定をしても効果がない
// 別のファイル（共通設定ファイル等）で設定する
ini_set('display_errors', 1);
error_reporting(E_ALL);

注意：Parse error は実行前に発生するため、エラーが起きているファイル内で ini_set() や error_reporting() を設定しても効果がありません。php.ini で設定するか、別のファイル（例：.htaccess や共通のbootstrapファイル）で設定してください。

# 直前の変更を確認
git diff

# 特定のファイルの変更を確認
git diff path/to/file.php

# 直前のコミットとの差分
git diff HEAD~1

# 変更を元に戻す（注意して使用）
git checkout -- path/to/file.php

<?php
// ===== ここから上半分 =====
// コード...

/* ===== ここから下半分をコメントアウト =====
// コード...
===== ここまで */

ポイント：エラーが消えたら下半分に原因があり、消えなかったら上半分に原因があります。これを繰り返すと、log2(n) 回の試行で原因箇所を特定できます。

Parse error が出たらこの手順で解決

1. エラーメッセージを読む — unexpected と expecting を確認
2. 報告された行番号を確認 — その行と1〜3行前をチェック
3. エディタのハイライトを確認 — 色の変化で異常箇所を特定
4. 括弧・クォートの対応を確認 — 開きと閉じの数を数える
5. セミコロンを確認 — 文の末尾にあるか？不要な場所にないか？
6. php -l で構文チェック — 修正後に確認
7. PHPバージョンを確認 — 新しい構文を使っていないか？

#!/bin/bash
# コミット対象のPHPファイルを構文チェック
FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E ".php$")

if [ -z "$FILES" ]; then
    exit 0
fi

ERROR=0
for FILE in $FILES; do
    php -l "$FILE" > /dev/null 2>&1
    if [ $? -ne 0 ]; then
        echo "Syntax error in: $FILE"
        php -l "$FILE"
        ERROR=1
    fi
done

if [ $ERROR -ne 0 ]; then
    echo "Commit aborted due to PHP syntax errors."
    exit 1
fi

exit 0

ポイント：上のスクリプトを .git/hooks/pre-commit に保存して実行権限を付与すると、構文エラーのあるPHPファイルをコミットしようとしたときに自動的にブロックしてくれます。

この記事のまとめ

• Parse error は構文解析段階で発生し、コードは1行も実行されない
• エラー行の1〜3行前に本当の原因があることが多い
• 最も多い原因はセミコロン忘れ、波括弧の不一致、クォートの閉じ忘れ
• php -l コマンドで実行前に構文チェックができる
• IDE / エディタのシンタックスハイライトと構文チェック機能を活用する
• WordPress の場合、Parse error で画面が真っ白になったらFTP/SSHで復旧する
• Git pre-commit フックでコミット前の自動チェックを導入する