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

Copy
1<?php
2
3/**
4 * URLなどのスラッシュを含むデータをJSON形式にエンコードする関数。
5 * JSON_UNESCAPED_SLASHES オプションの有無によるスラッシュのエスケープ挙動の違いを示します。
6 *
7 * システムエンジニアを目指す初心者向けに、PHPのjson_encode関数における
8 * JSON_UNESCAPED_SLASHES オプションの基本的な使い方を理解してもらうためのサンプルコードです。
9 * PHP 8 の環境で動作します。
10 */
11function encodeJsonWithUnescapedSlashesDemo(): void
12{
13    // JSONエンコードするサンプルデータ
14    // URLやファイルパスなど、スラッシュを含む文字列を含みます。
15    $data = [
16        'product_name' => 'Example Widget',
17        'product_id' => 'item-123',
18        'url' => 'https://api.example.com/v1/products/item-123/details',
19        'description' => 'A detailed description with /some/ internal/slashes.',
20    ];
21
22    // 1. デフォルト設定でJSONエンコード
23    // スラッシュ (/) は自動的にバックスラッシュ (\) でエスケープされます (例: "https:\/\/api.example.com\/...").
24    // これはJSON標準に則った挙動で、互換性を高めます。
25    $jsonDefault = json_encode($data);
26
27    // 2. JSON_UNESCAPED_SLASHES オプションを使用してJSONエンコード
28    // スラッシュ (/) はエスケープされず、そのまま出力されます (例: "https://api.example.com/...").
29    // 特定のAPI要件や、JSONデータの可読性を重視する場合に有用です。
30    $jsonUnescapedSlashes = json_encode($data, JSON_UNESCAPED_SLASHES);
31
32    // 3. JSON_UNESCAPED_SLASHES と JSON_PRETTY_PRINT を組み合わせて、整形されたJSONを生成
33    // 出力を人間が読みやすい形式にしつつ、スラッシュのエスケープを防ぎます。
34    $jsonPrettyUnescapedSlashes = json_encode($data, JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT);
35
36    // 実際のアプリケーションでは、これらの結果はファイルに保存されたり、
37    // HTTPレスポンスとして送信されたりすることが一般的です。
38    // 以下は、デモンストレーションのために各変数に格納される結果の例をコメントで示します。
39
40    // $jsonDefault の内容例:
41    // {"product_name":"Example Widget","product_id":"item-123","url":"https:\/\/api.example.com\/v1\/products\/item-123\/details","description":"A detailed description with \/some\/ internal\/slashes."}
42
43    // $jsonUnescapedSlashes の内容例:
44    // {"product_name":"Example Widget","product_id":"item-123","url":"https://api.example.com/v1/products/item-123/details","description":"A detailed description with /some/ internal/slashes."}
45
46    // $jsonPrettyUnescapedSlashes の内容例:
47    /*
48    {
49        "product_name": "Example Widget",
50        "product_id": "item-123",
51        "url": "https://api.example.com/v1/products/item-123/details",
52        "description": "A detailed description with /some/ internal/slashes."
53    }
54    */
55
56    // 注: 本サンプルコードは、変数を生成し、その結果をコメントで示すことで動作を示しています。
57    // 実際にこれらのJSON文字列を出力する場合は、以下のようなコードを追加します。
58    // echo $jsonUnescapedSlashes;
59    // header('Content-Type: application/json');
60    // echo $jsonPrettyUnescapedSlashes;
61}
62
63// サンプル関数を実行
64encodeJsonWithUnescapedSlashesDemo();

このサンプルコードは、PHPでデータをJSON形式に変換する際に使用するjson_encode関数と、その挙動を制御するJSON_UNESCAPED_SLASHES定数の使い方を、システムエンジニアを目指す初心者の方に向けて解説しています。

json_encode関数は、配列やオブジェクトなどのPHPのデータを、Web APIなどで広く使われるJSON形式の文字列に変換する関数です。この関数は引数として変換したいデータを、戻り値としてJSON形式の文字列を返します。

通常、json_encode関数は、JSONデータ内のスラッシュ（/）を\/のようにバックスラッシュでエスケープします。これはJSONの仕様に準拠した互換性の高い挙動です。しかし、URLのようにスラッシュが頻繁に現れるデータでは、エスケープされることでデータの可読性が低下したり、特定のAPI要件でエスケープが不要な場合があります。

JSON_UNESCAPED_SLASHES定数は、json_encode関数の第二引数（オプション）として指定することで、このスラッシュのエスケープを無効にするためのフラグです。この定数自体には引数や戻り値はありませんが、json_encode関数に渡すことでそのエンコード挙動を変更します。サンプルコードでは、このオプションの有無によって、JSON出力に含まれるスラッシュがエスケープされるかどうかの違いを具体的に示しています。さらに、JSON_PRETTY_PRINT定数と組み合わせることで、スラッシュのエスケープを防ぎつつ、整形されて人間が読みやすいJSONを生成する方法も紹介されています。

Copy
1<?php
2
3/**
4 * sleep() 関数の同期的な動作を示すサンプルコード。
5 *
6 * sleep() 関数は、指定された秒数だけスクリプト全体の実行を一時停止させます。
7 * ウェブサーバー環境でこれを実行すると、その間ブラウザへの応答が停止するため、
8 * 「動かない」「レスポンスが遅い」と誤解されることがあります。
9 * このコードは、sleep() が実際にスクリプトの実行をブロックすることを示します。
10 */
11function demonstrateSleepBehavior(): void
12{
13    // 処理開始時刻を表示
14    echo "処理を開始します: " . date('H:i:s') . "\n";
15
16    $sleepDuration = 3; // 待機時間（秒）を設定
17
18    echo "{$sleepDuration}秒間スリープします...\n";
19    // sleep() 関数は、スクリプトの実行を指定された秒数だけ停止させます。
20    // この間、PHPコードの他の処理は全てブロックされます。
21    sleep($sleepDuration);
22
23    // スリープからの復帰時刻を表示
24    echo "スリープから復帰しました: " . date('H:i:s') . "\n";
25    echo "処理を終了します。\n";
26}
27
28// 関数の実行
29demonstrateSleepBehavior();

このサンプルコードは、PHP 8におけるsleep()関数の基本的な動作と、その特性を示しています。sleep()関数は、指定された秒数だけスクリプト全体の実行を一時的に停止させるために使用されます。

この関数は引数として、スクリプトを停止させたい秒数を整数で受け取ります。サンプルコードでは$sleepDuration変数で3秒と設定されています。sleep()が呼び出されると、その間はPHPスクリプトの他の処理が一切実行されず、完全にブロックされます。

特にウェブサーバー環境でこの関数を使用すると、指定された時間だけブラウザへの応答が停止します。そのため、ユーザーは「ページが動かない」「レスポンスが遅い」と感じることがあります。このコードは、処理開始時刻とスリープからの復帰時刻を表示することで、実際にスクリプトが3秒間停止していることを確認できます。sleep()関数は、同期的に処理を一時停止させるため、ウェブアプリケーションでは、ユーザー体験を損なわないよう注意して利用することが重要です。