【PHP8.x】MON_11定数の使い方

Copy
1<?php
2
3/**
4 * MON_11 定数は、PHPの何らかの拡張機能によって提供される定数です。
5 * リファレンス情報では「戻り値なし」とありますが、これは定数であるため、
6 * 関数のように呼び出して値が返されることはない、という意味合いです。
7 * ここでは、MON_11 が文字列型の値を保持する定数であると仮定し、
8 * 文字列と16進数表現の相互変換の例を示します。
9 *
10 * 実際の MON_11 の値や用途は、利用するPHP拡張機能のリファレンスをご確認ください。
11 */
12if (!defined('MON_11')) {
13    // MON_11 が未定義の場合、サンプル用に文字列を定義します。
14    // この値は、システムエンジニアが扱う可能性のある任意の文字列です。
15    define('MON_11', 'Hello PHP World!');
16}
17
18/**
19 * 文字列を16進数表現に変換し、さらに元の文字列に戻すサンプル関数です。
20 * PHPでの文字列と16進数の基本的な扱い方を、初心者にも分かりやすく示します。
21 */
22function demonstrateStringHexConversion(): void
23{
24    echo "--- PHP文字列と16進数変換のデモンストレーション ---" . PHP_EOL;
25    echo "使用する定数 MON_11 の値: " . MON_11 . PHP_EOL . PHP_EOL;
26
27    // 1. 元の文字列を準備します。ここでは定数 MON_11 の値を使用します。
28    $originalString = MON_11;
29    echo "1. 元の文字列: " . $originalString . PHP_EOL;
30
31    // 2. 文字列を16進数表現に変換します。
32    //    `bin2hex()` 関数は、バイナリデータを16進数表現の文字列に変換します。
33    $hexString = bin2hex($originalString);
34    echo "2. 16進数表現: " . $hexString . PHP_EOL;
35
36    // 3. 16進数表現の文字列を元の文字列に戻します。
37    //    `hex2bin()` 関数は、16進数表現の文字列を元のバイナリデータ（文字列）に戻します。
38    $decodedString = hex2bin($hexString);
39    echo "3. 16進数から戻した文字列: " . $decodedString . PHP_EOL;
40
41    // 4. 元の文字列と復元した文字列を比較し、変換が正しく行われたかを確認します。
42    if ($originalString === $decodedString) {
43        echo "4. 結果: 文字列の変換と復元が正常に行われました。" . PHP_EOL;
44    } else {
45        echo "4. 結果: エラー！文字列の変換または復元に問題が発生しました。" . PHP_EOL;
46    }
47}
48
49// サンプル関数を実行します。
50demonstrateStringHexConversion();
51

PHPのMON_11定数は、何らかの拡張機能によって提供される値ですが、このサンプルコードでは、システムエンジニアが実務で扱う可能性のある文字列を格納する定数として仮定し、その文字列を16進数表現に変換する処理を解説しています。定数は引数を取らず、戻り値という概念もありませんが、MON_11自体が特定の値を保持しています。

このコードの中心は、文字列と16進数表現の相互変換です。まず、bin2hex()関数は、引数として渡された文字列（バイナリデータ）を、その内容に対応する16進数表現の文字列に変換して返します。例えば、「Hello」という文字列は「48656c6c6f」のような16進数文字列になります。

次に、hex2bin()関数は、bin2hex()の逆の処理を行います。引数として渡された16進数表現の文字列を、元のバイナリデータ（PHPではこれも文字列として扱われます）に変換して返します。これにより、一度16進数に変換された文字列を、元の状態に戻すことができます。

サンプルコードでは、MON_11に格納された文字列をbin2hex()で16進数に変換し、さらにhex2bin()で元の文字列に復元し、両者が一致するかを確認しています。これは、データのエンコードとデコードが正しく行われていることを検証する基本的な方法です。初心者の方も、このコードを通じてPHPでの文字列操作とデータの表現方法の基礎を学ぶことができます。

Copy
1<?php
2
3/**
4 * PHPのMonadパターンを模倣するOptionalクラスのサンプルコード。
5 * NullPointerExceptionなどの問題を安全に処理し、関数型プログラミングのような
6 * チェーン可能な操作を提供します。
7 *
8 * リファレンス情報に記載の MON_11 定数は、具体的な用途が不明なため、
9 * ここでは例として任意の整数値を持つ定数として定義します。
10 * 定数には通常「戻り値」という概念はありませんが、もしこの定数が
11 * 特定の拡張機能の内部状態や設定値として利用される場合、
12 * その「利用」自体が戻り値を持たない副作用的な操作と解釈される可能性も考えられます。
13 */
14
15// MON_11 定数を定義
16// PHP 8では、グローバルスコープで `const` を使用して定義することも可能ですが、
17// 実行時に動的に定義する場合は `define()` を使用します。
18define('MON_11', 11); // 例として整数値11を設定
19
20/**
21 * Optionalクラスは、値が存在するかどうか（nullでないか）を安全にラップし、
22 * 条件付きで操作を行うためのモナド的なコンテナです。
23 * 値がnullである可能性のある変数に対して、安全にメソッドチェーンを適用できます。
24 */
25class Optional
26{
27    /**
28     * @var mixed 値が存在しない場合はnullを保持
29     */
30    private mixed $value;
31
32    /**
33     * プライベートコンストラクタ。
34     * 外部からの直接的なインスタンス生成を防ぎ、ファクトリメソッドの使用を強制します。
35     *
36     * @param mixed $value ラップする値
37     */
38    private function __construct(mixed $value)
39    {
40        $this->value = $value;
41    }
42
43    /**
44     * nullを許容する値からOptionalインスタンスを生成します。
45     * 値がnullの場合でも、空のOptionalとして扱われます。
46     *
47     * @param mixed $value ラップする値
48     * @return self 新しいOptionalインスタンス
49     */
50    public static function ofNullable(mixed $value): self
51    {
52        return new self($value);
53    }
54
55    /**
56     * 空のOptionalインスタンスを生成します。
57     * 値が存在しないことを明確に示します。
58     *
59     * @return self 新しい空のOptionalインスタンス
60     */
61    public static function empty(): self
62    {
63        return new self(null);
64    }
65
66    /**
67     * ラップしている値が存在するかどうか（nullではないか）をチェックします。
68     *
69     * @return bool 値が存在すればtrue、そうでなければfalse
70     */
71    public function isPresent(): bool
72    {
73        return $this->value !== null;
74    }
75
76    /**
77     * ラップしている値が存在しないかどうか（nullであるか）をチェックします。
78     *
79     * @return bool 値が存在しなければtrue、そうでなければfalse
80     */
81    public function isEmpty(): bool
82    {
83        return $this->value === null;
84    }
85
86    /**
87     * ラップしている値が存在する場合にのみ、指定されたクロージャを適用し、
88     * その結果を新しいOptionalインスタンスでラップして返します。
89     *
90     * @param callable $mapper 値に適用するクロージャ (値を受け取り、新しい値を返す)
91     * @return self 新しいOptionalインスタンス
92     */
93    public function map(callable $mapper): self
94    {
95        if ($this->isPresent()) {
96            return Optional::ofNullable($mapper($this->value));
97        }
98        return Optional::empty();
99    }
100
101    /**
102     * ラップしている値が存在する場合にのみ、指定されたクロージャを適用します。
103     * このクロージャは副作用を持つ操作（例: echoで出力）に適しており、
104     * 新しいOptionalインスタンスは返しません。
105     *
106     * @param callable $consumer 値に適用するクロージャ (値を受け取る)
107     */
108    public function ifPresent(callable $consumer): void
109    {
110        if ($this->isPresent()) {
111            $consumer($this->value);
112        }
113    }
114
115    /**
116     * ラップしている値が存在しない場合、指定されたデフォルト値を返します。
117     *
118     * @param mixed $other 値が存在しない場合に返すデフォルト値
119     * @return mixed ラップしている値、またはデフォルト値
120     */
121    public function orElse(mixed $other): mixed
122    {
123        return $this->isPresent() ? $this->value : $other;
124    }
125
126    /**
127     * ラップしている値が存在する場合、その値を返します。
128     * 存在しない場合はnullを返します。
129     *
130     * @return mixed ラップしている値、またはnull
131     */
132    public function get(): mixed
133    {
134        return $this->value;
135    }
136}
137
138// --- Optional モナドの利用例 ---
139echo "--- Optional モナドの利用例 ---" . PHP_EOL;
140
141// 1. 値が存在する場合の操作チェーン
142$userName = "Alice";
143$optionalUserName = Optional::ofNullable($userName);
144
145$greeting = $optionalUserName
146    ->map(fn($name) => strtoupper($name)) // 名前を大文字に変換
147    ->map(fn($upperName) => "Hello, " . $upperName . "!") // 挨拶文を作成
148    ->orElse("Hello, Guest!"); // 値が存在しない場合のデフォルト
149
150echo "Greeting: " . $greeting . PHP_EOL; // 出力: Greeting: Hello, ALICE!
151
152// 2. 値がnullの場合の操作チェーンとデフォルト値
153$nullUserName = null;
154$optionalNullUserName = Optional::ofNullable($nullUserName);
155
156$nullGreeting = $optionalNullUserName
157    ->map(fn($name) => strtoupper($name))
158    ->map(fn($upperName) => "Hello, " . $upperName . "!")
159    ->orElse("Hello, Anonymous User!"); // nullの場合はこちらが適用される
160
161echo "Null Greeting: " . $nullGreeting . PHP_EOL; // 出力: Null Greeting: Hello, Anonymous User!
162
163// 3. ifPresent() を使った副作用のある操作
164$productPrice = 123.45;
165Optional::ofNullable($productPrice)
166    ->map(fn($price) => $price * 1.10) // 10%上乗せ
167    ->ifPresent(fn($finalPrice) => echo "Final Price (with tax): $" . number_format($finalPrice, 2) . PHP_EOL); // 出力: Final Price (with tax): $135.80
168
169$emptyPrice = null;
170Optional::ofNullable($emptyPrice)
171    ->map(fn($price) => $price * 1.10)
172    ->ifPresent(fn($finalPrice) => echo "This will not be printed." . PHP_EOL); // 値がnullなので出力されない
173
174// 4. 入れ子のデータ構造への安全なアクセス
175$userProfile = [
176    'id' => 101,
177    'settings' => [
178        'theme' => 'dark',
179        'notifications' => true
180    ]
181];
182
183$theme = Optional::ofNullable($userProfile)
184    ->map(fn($profile) => $profile['settings'] ?? null) // 'settings'キーの有無をチェック
185    ->map(fn($settings) => $settings['theme'] ?? null) // 'theme'キーの有無をチェック
186    ->orElse('light'); // 最終的に値がなければ 'light'
187
188echo "User theme: " . $theme . PHP_EOL; // 出力: User theme: dark
189
190$profileWithoutSettings = ['id' => 102];
191$missingTheme = Optional::ofNullable($profileWithoutSettings)
192    ->map(fn($profile) => $profile['settings'] ?? null)
193    ->map(fn($settings) => $settings['theme'] ?? null)
194    ->orElse('default');
195
196echo "Missing theme: " . $missingTheme . PHP_EOL; // 出力: Missing theme: default
197
198// --- MON_11 定数の利用例 ---
199echo PHP_EOL . "--- MON_11 定数の利用例 ---" . PHP_EOL;
200echo "MON_11 の値: " . MON_11 . PHP_EOL; // 定数 MON_11 の値を出力
201
202if (MON_11 === 11) {
203    echo "MON_11 の値が期待通りです。" . PHP_EOL;
204}

PHP 8の拡張機能定数であるMON_11は、引数を持たず、戻り値もない固定値です。定数には通常「戻り値」という概念は適用されませんが、特定の拡張機能の設定値や状態を示すものとして、その値にアクセスする際に利用されます。このサンプルコードでは、MON_11を整数値11として定義し、その使用例を示しています。

このコードの中心は、Monad（モナド）パターンを模倣したOptionalクラスです。Optionalクラスは、値がnullである可能性のある変数（mixed $value）を安全にラップし、NullPointerExceptionなどのエラーを未然に防ぎます。ofNullable()静的メソッドでラップする値を渡してインスタンスを生成し、isPresent()やisEmpty()で値の有無を判定します。

特に重要なのは、map()メソッドとorElse()メソッドです。map()メソッドは、ラップされた値が存在する場合に指定された処理（callable $mapper）を適用し、その結果を新しいOptionalインスタンス（self）として返します。これにより、値が存在するかどうかの確認を繰り返し書くことなく、一連の操作をチェーン形式で記述できます。一方、orElse()メソッドは、値が存在しない場合に指定したデフォルト値（mixed $other）を返します。また、ifPresent()メソッドは、値が存在する場合にのみ副作用のある処理（callable $consumer）を実行し、戻り値は持ちません（void）。これにより、nullに対する安全な操作とコードの可読性向上を実現しています。