【PHP8.x】DateException::__wakeup()メソッドの使い方

Copy
1<?php
2
3declare(strict_types=1);
4
5/**
6 * DateException::__wakeup() の動作を実証するクラス。
7 *
8 * PHP 8以降、セキュリティ上の理由からDateExceptionとそのサブクラスの
9 * シリアライズ解除は許可されていません。unserialize() が呼び出されると、
10 * 内部的に __wakeup() メソッドが実行され、例外がスローされます。
11 * このコードは、その挙動を確認するものです。
12 */
13class WakeupDemo
14{
15    /**
16     * デモを実行します。
17     */
18    public static function run(): void
19    {
20        $dateException = null;
21
22        // 1. まず、DateExceptionのサブクラスであるDateInvalidTimeZoneExceptionを意図的に発生させます。
23        try {
24            new DateTimeImmutable('now', new DateTimeZone('Invalid/TimeZone'));
25        } catch (DateException $e) {
26            echo "意図的にDateExceptionを発生させました。" . PHP_EOL;
27            $dateException = $e;
28        }
29
30        if ($dateException === null) {
31            echo "例外の生成に失敗しました。" . PHP_EOL;
32            return;
33        }
34
35        // 2. 捕捉した例外オブジェクトをシリアライズ（文字列に変換）します。
36        $serialized = serialize($dateException);
37        echo "オブジェクトのシリアライズに成功しました。" . PHP_EOL;
38        echo "----------------------------------------" . PHP_EOL;
39
40        // 3. シリアライズされた文字列をアンシリアライズ（オブジェクトに復元）しようとします。
41        // この時、DateException::__wakeup() が呼び出され、例外がスローされます。
42        try {
43            echo "アンシリアライズを試みます..." . PHP_EOL;
44            unserialize($serialized);
45        } catch (Exception $e) {
46            // __wakeup() がスローした例外をここで捕捉します。
47            echo "アンシリアライズに失敗しました。__wakeup() が例外をスローしました。" . PHP_EOL;
48            echo "キャッチしたメッセージ: " . $e->getMessage() . PHP_EOL;
49        }
50    }
51}
52
53// デモを実行
54WakeupDemo::run();

このサンプルコードは、PHPの DateException クラスに定義されている __wakeup() メソッドの動作を説明するものです。__wakeup() は、unserialize() 関数によってオブジェクトが文字列から復元される際に、自動的に呼び出される特殊なメソッドです。このメソッドは引数を取らず、戻り値もありません。

PHP 8以降、セキュリティ上の理由から DateException やその派生クラスのオブジェクトをアンシリアライズ（復元）することは禁止されています。そのため、DateException::__wakeup() メソッドは、呼び出されると必ず例外をスローして処理を中断させるように実装されています。

このコードでは、まず意図的に無効なタイムゾーンを指定して DateException を発生させます。次に、捕捉した例外オブジェクトを serialize() 関数で文字列データに変換します。最後に、その文字列を unserialize() 関数でオブジェクトに復元しようと試みます。この復元の過程で __wakeup() が内部的に呼び出され、設計通りに例外が発生します。この挙動を try-catch 構文で確認することで、DateException オブジェクトがアンシリアライズできない仕様であることを実証しています。