PHP 8.1の主要機能と変更点のまとめ｜Enumsや読み取り専用プロパティの実装方法

PHP 8.1は、モダンなPHP開発において基盤となる重要なアップデートとして、多くの開発現場で活用され続けています。

このバージョンでは、列挙型（Enums）や読み取り専用プロパティ（Readonly Properties）といった、コードの堅牢性と可読性を劇的に向上させる機能が導入されました。

当時のリリースはPHPの型システムをさらに進化させ、より安全で保守しやすいプログラムの記述を可能にしました。

本記事では、PHP 8.1の主要な新機能を中心に、その具体的な実装方法や実戦での活用シーンを詳しく解説します。

最新のプロジェクトでも頻繁に利用されるこれらの機能を再確認し、より高品質なコードを書くための知識を深めていきましょう。

PHP 8.1で導入された列挙型（Enums）の基本と実装

PHP 8.1において最も注目された機能の一つが、列挙型（Enums）の導入です。

Enumsを使用することで、これまでクラス定数や文字列で代用していた「特定の選択肢」を、言語レベルで厳密に定義できるようになりました。

これにより、無効な値が混入するリスクを排除し、型安全なプログラミングが可能になります。

純粋なEnum（Pure Enums）の定義

まずは、最もシンプルな「純粋なEnum」の書き方を見ていきましょう。

純粋なEnumは、単純に名前の付いた定数をグループ化する際に便利です。

enum OrderStatus {
    case Pending;
    case Processing;
    case Shipped;
    case Delivered;
    case Cancelled;
}

// 関数の引数に型指定として使用
function updateStatus(OrderStatus $status): void {
    // ステータスを更新する処理
    echo "ステータスが更新されました。";
}

// 呼び出し例
updateStatus(OrderStatus::Shipped);

この例では、updateStatus関数はOrderStatus型の値以外を受け付けません。

これまでは整数や文字列で管理していたため、予期せぬ値が渡される可能性がありましたが、Enumsによって静的解析ツールやランタイムでのチェックが強力に機能するようになります。

値を持つEnum（Backed Enums）

データベースに保存したり、APIで送信したりする場合、各ケースにスカラー値（文字列や整数）を紐付けたいことがあります。

これを「Backed Enums」と呼びます。

enum UserRole: string {
    case Admin = 'administrator';
    case Editor = 'editor';
    case Viewer = 'viewer';
}

// 値を取得する場合
echo UserRole::Admin->value;

administrator

Backed Enumsを使用する場合、stringまたはintの型を指定する必要があります。

また、UserRole::from('editor')のように記述することで、文字列からEnumのインスタンスを生成することも可能です。

存在しない値を渡した場合にはValueErrorがスローされるため、バリデーションの手間も省けます。

Enum内でのメソッド定義

PHPのEnumはクラスのように振る舞うことができ、インターフェースの実装やメソッドの定義も可能です。

これにより、ステータスに応じた日本語ラベルの取得などをEnum自身にカプセル化できます。

enum SubscriptionStatus: string {
    case Active = 'active';
    case Expired = 'expired';

    public function getLabel(): string {
        return match($this) {
            self::Active => '契約中',
            self::Expired => '期限切れ',
        };
    }
}

$status = SubscriptionStatus::Active;
echo $status->getLabel();

契約中

このように、データとそのデータに関連するロジックを1か所にまとめられる点は、オブジェクト指向設計において非常に強力です。

読み取り専用プロパティ（Readonly Properties）の活用

PHP 8.1から導入された読み取り専用プロパティ（Readonly Properties）は、オブジェクトの不変性（Immutability）を担保するための強力な機能です。

一度初期化されたプロパティは、その後一切変更できなくなります。

基本的な書き方とルール

プロパティ宣言時にreadonlyキーワードを付与することで、そのプロパティは読み取り専用となります。

class UserDTO {
    public readonly int $id;
    public readonly string $name;

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

$user = new UserDTO(1, '田中太郎');
echo $user->name;

// 以下のコードはエラー（Error: Cannot modify readonly property）が発生します
// $user->name = '鈴木次郎';

これまでは、プロパティをprivateにしてゲッターメソッドを用意することで不変性を実現していましたが、readonlyを使えばpublicでありながら変更不可にできるため、コードの記述量を大幅に削減できます。

コンストラクタのプロパティプロモーションとの併用

PHP 8.0で導入されたプロパティプロモーションと組み合わせることで、さらに簡潔なクラス定義が可能になります。

class Product {
    public function __construct(
        public readonly int $id,
        public readonly string $title,
    ) {}
}

データ転送オブジェクト（DTO）や値オブジェクト（Value Object）を作成する際、この記述法は現在のPHP開発におけるスタンダードとなっています。

ただし、readonlyプロパティには「型指定が必須であること」や「一度初期化されるとリセットできない」といった制約がある点に注意してください。

First-class Callable Syntax（第一級コールバッチ構文）

PHP 8.1では、関数やメソッドをクロージャとして参照するための新しい構文が追加されました。

従来の[$this, 'methodName']や文字列による指定に比べ、静的解析が効きやすく、IDEのサポートも受けやすいのが特徴です。

構文の比較とメリット

従来のコールバック指定と、新しい構文を比較してみましょう。

$fn = strlen(...); // 第一級コールバッチ構文
echo $fn('Hello PHP 8.1');

13

関数名の後ろに(...)を付けるだけで、その関数を指すClosureオブジェクトが生成されます。

メソッドの場合も同様に記述可能です。

class Formatter {
    public function format(string $text): string {
        return strtoupper($text);
    }
}

$formatter = new Formatter();
$callback = $formatter->format(...);

$items = ['apple', 'banana'];
$upperItems = array_map($callback, $items);

print_r($upperItems);

Array
(
    [0] => APPLE
    [1] => BANANA
)

文字列でメソッド名を指定する古い方法では、タイポ（打ち間違い）があっても実行時までエラーに気付きにくいという問題がありました。

新しい構文は静的にチェック可能なため、リファクタリングの際も安全にコードを修正できます。

初期化時におけるnew演算子の許可（New in Initializers）

PHP 8.1からは、関数のデフォルト引数やプロパティの初期値、アトリビュートの引数などでnew演算子を使用できるようになりました。

これにより、依存性の注入（DI）をより簡潔に行えるようになっています。

実装例：デフォルトの依存関係を指定する

例えば、ロガークラスを引数で受け取る際、指定がなければデフォルトのインスタンスを生成するといった処理がスマートに書けます。

class NullLogger {
    public function log(string $message) { /* 何もしない */ }
}

class Service {
    private $logger;

    public function __construct(
        $logger = new NullLogger(), // ここでnewが利用可能
    ) {
        $this->logger = $logger;
    }
}

以前のバージョンでは、一度nullを許容してからコンストラクタ内でインスタンス化する必要がありました。

この改善により、ボイラープレートコードが削減され、意図が明確なコードになります。

交差型（Intersection Types）による型定義の強化

PHP 8.0で導入された「結合型（Union Types）」に対し、PHP 8.1では「交差型（Intersection Types）」が導入されました。

これは「AかつBの両方のインターフェースを満たす型」を定義するための機能です。

交差型の利用シーン

複数のインターフェースを実装していることを保証したい場合に役立ちます。

function process(Iterator&Countable $value) {
    echo "要素数: " . count($value);
    foreach ($value as $item) {
        // 反復処理
    }
}

記号&を使用して型を繋ぎます。

これにより、特定の機能を複数併せ持つオブジェクトのみを安全に受け取ることができます。

なお、PHP 8.1時点ではスカラー型（intやstringなど）の交差型は作成できないため、主にオブジェクトやインターフェースに対して使用します。

ファイバー（Fibers）による非同期処理の基盤

PHP 8.1の内部的な大きな変更として、Fibers（ファイバー）の導入が挙げられます。

これは、コルーチン（中断・再開可能な関数）を実現するための低レイヤーな仕組みです。

ファイバーの役割

ファイバー自体は非常に低レベルなAPIであるため、一般的なWebアプリケーション開発者が直接触れる機会は少ないかもしれません。

しかし、AMPHPやReactPHPといった非同期ライブラリの基盤として活用されています。

これにより、PHPでもNode.jsやGoのような効率的な並行処理ライブラリがより作りやすくなりました。

ブロッキングI/O（ファイルの読み書きや通信待ち）を効率的に処理するための第一歩として、PHPの歴史において重要な転換点となりました。

PHP 8.1での主要な変更点と互換性の確認

新機能だけでなく、既存の動作に対する変更や非推奨化された機能についても理解しておく必要があります。

特にアップグレードを検討する際には、以下の点に注意してください。

パフォーマンスの改善

PHP 8.1では、継承キャッシュ（Inheritance Cache）の導入により、クラスの継承関係を解決する際のオーバーヘッドが削減されました。

これにより、大規模なフレームワークを使用したアプリケーションでは、コードを書き換えなくても数％のパフォーマンス向上が期待できます。

非推奨となった機能の例

一部の古い機能は非推奨（Deprecated）となり、将来のバージョンで削除される予定です。

特にmysqliの変更は、古いコードベースをそのまま動かす際にエラーで停止する原因になることがあるため、注意が必要です。

まとめ

PHP 8.1は、開発効率とコードの安全性を高めるための強力な武器を数多く提供してくれました。

特にEnumsと読み取り専用プロパティは、日常的なコーディングにおいてバグを未然に防ぎ、ドキュメントとしての価値も高い優れた機能です。

また、第一級コールバッチ構文や交差型といった機能も、PHPの型システムを現代的で洗練されたものに進化させています。

最新のPHP環境を活用することで、よりシンプルで、かつ堅牢なシステムを構築することが可能になります。

本記事で紹介した機能を積極的に取り入れ、日々のプログラミングに役立てていただければ幸いです。