この記事の要点
PHP Parse error: syntax error, unexpected 'class' (T_CLASS) は古い PHP バージョンで新しい構文を使ったとき発生 原因 ①: PHP 5.4 以前で trait や class const 表現を使った 原因 ②: ::class 構文（PHP 5.5+）を古い PHP で使った 原因 ③: 名前空間 / use トレイトの記法エラー 対処: PHP バージョン確認 + コードに合うバージョンへアップグレード

 

エラーの状況

PHP Parse error:  syntax error, unexpected 'class' (T_CLASS) in /path/to/file.php on line 10
PHP Parse error:  syntax error, unexpected 'class' (T_CLASS), expecting identifier (T_STRING) ...

このエラーは PHP パーサが「ここで class キーワードは予期していない」と判断した時に発生します。多くは使用している PHP の機能がそのバージョンでは未対応の場合です。

主な原因と対処

原因 1: ::class 構文 (PHP 5.5+)

// PHP 5.5+ で導入された ::class
$className = User::class;       // → "App\Models\User"

class_alias(MyClass::class, "Alias");

// PHP 5.4 以前で実行するとエラー
// 対処: PHP 5.5+ にアップグレード
// または文字列リテラルで書く
$className = "App\\Models\\User";

原因 2: 配列の短縮構文 [] (PHP 5.4+)

// PHP 5.4+
$arr = ["a", "b", "c"];

// PHP 5.3 以前
$arr = array("a", "b", "c");  // ← こちらが必要

原因 3: トレイト (PHP 5.4+)

// PHP 5.4+
trait Loggable {
    public function log() { ... }
}

class User {
    use Loggable;
}

// PHP 5.3 以前は trait 自体が存在しない

原因 4: 名前空間 (PHP 5.3+)

// PHP 5.3+ のみ
namespace App\Models;

use App\Http\Controllers\Controller;

class User extends Controller { }

// PHP 5.2 以前は名前空間なし、_ 区切りで擬似化
class App_Models_User extends App_Http_Controllers_Controller { }

原因 5: 無名クラス (PHP 7.0+)

// PHP 7.0+
$obj = new class {
    public function hello() { return "Hi"; }
};

// PHP 5.x ではエラー

原因 6: タイプヒント / 戻り値型 (PHP 7.0+ / 7.1+ / 8.0+)

// PHP 7.0+
function add(int $a, int $b): int {
    return $a + $b;
}

// PHP 7.1+
function find(?int $id): ?User { ... }

// PHP 8.0+
function process(string|int $value): array|false { ... }

// PHP 7 未満ではこれらの構文でエラー

原因の特定

PHP バージョン確認

# CLI
$ php -v
PHP 7.4.33 (cli) (built: ...)
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies

# Web サーバ経由


# または info.php
$ echo " /var/www/info.php

エラー行の前後を確認

エラーメッセージの「line N」の前後 5 行を見て、新しい構文を使っていないかチェック:

# ファイルの該当行を表示
$ sed -n "5,15p" /path/to/file.php

対処方法

方法 1: PHP をアップグレード（推奨）

# Ubuntu/Debian
$ sudo apt update
$ sudo apt install php8.2

# CentOS/RHEL
$ sudo yum install epel-release
$ sudo yum install https://rpms.remirepo.net/enterprise/remi-release-8.rpm
$ sudo yum module enable php:remi-8.2
$ sudo yum install php

# macOS Homebrew
$ brew install php@8.2

# 確認
$ php -v

方法 2: コードを古い PHP 互換に書き換え

本番サーバの PHP を上げられない場合は、コードを書き換え:

// PHP 5.5+ の ::class を文字列に
// Before:
$className = User::class;
// After:
$className = "App\\Models\\User";

// [] 配列を array() に
// Before:
$arr = [1, 2, 3];
// After:
$arr = array(1, 2, 3);

// 型宣言を削除
// Before:
function add(int $a, int $b): int { return $a + $b; }
// After:
function add($a, $b) { return $a + $b; }

方法 3: composer の PHP 要件で互換性チェック

// composer.json
{
    "require": {
        "php": "^8.1"
    }
}

# 依存ライブラリが PHP 8.1+ を要求しているか確認
$ composer outdated --direct

類似エラー

エラー	原因
unexpected \'class\' (T_CLASS)	このページのケース
unexpected \'[\' (T_ARRAY)	PHP 5.3 で短縮配列構文 []
unexpected \'use\' (T_USE)	PHP 5.3 で use 構文（名前空間 / トレイト）
unexpected \'?\'	PHP 7 未満で nullable / 三項演算子省略形
unexpected \'function\'	アロー関数 (PHP 7.4+)

PHP バージョン別新機能まとめ

PHP	新機能
5.3	namespace, use, クロージャ
5.4	trait, [] 短縮配列, callable 型
5.5	::class, generator, finally
5.6	可変引数 (...), 定数式
7.0	型宣言, 戻り値型, 無名クラス, ??演算子
7.1	nullable 型 (?), void 戻り値
7.4	アロー関数 (fn), 型プロパティ, ??=
8.0	match, ユニオン型, named arguments
8.1	readonly, enum, never 型
8.2	readonly class, 交差型
8.3	typed class constants, json_validate

関連記事

• the requested PHP extension mbstring is missing
• version less than X.X is not supported.