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

Copy
1<?php
2
3/**
4 * 指定された日付の月が何日あるかを取得する関数。
5 *
6 * PHPの date() 関数でフォーマット文字 't' を使用すると、
7 * 指定された月の合計日数を簡単に取得できます。
8 * これは、うるう年や月の長さの違いを考慮する際に便利です。
9 *
10 * @param string $dateString 処理する日付文字列 (例: '2023-01-15', 'now')
11 * @return string 指定された月の合計日数を含む文字列
12 */
13function getDaysInMonth(string $dateString = 'now'): string
14{
15    // strtotime() で日付文字列をタイムスタンプに変換します。
16    // 'now' の場合、現在のタイムスタンプが使用されます。
17    $timestamp = strtotime($dateString);
18
19    // date() 関数とフォーマット文字 't' を使用して、指定された月の日数を取得します。
20    // 't' は「その月に含まれる日数 (28から31まで)」を表します。
21    $daysInMonth = date('t', $timestamp);
22
23    return "日付 '{$dateString}' の月は {$daysInMonth} 日あります。";
24}
25
26// サンプル使用例
27// 1. 現在の月の日数を取得
28echo getDaysInMonth() . PHP_EOL;
29
30// 2. 特定の日付（例: 2023年2月）の月の日数を取得
31echo getDaysInMonth('2023-02-15') . PHP_EOL;
32
33// 3. うるう年の2月（例: 2024年2月）の月の日数を取得
34echo getDaysInMonth('2024-02-01') . PHP_EOL;
35
36// 4. 31日ある月（例: 2023年3月）の日数を取得
37echo getDaysInMonth('2023-03-10') . PHP_EOL;

このPHPサンプルコードは、指定された日付の月が何日あるかを簡単に取得する方法をシステムエンジニアを目指す初心者の方向けに解説します。getDaysInMonth関数は、日付文字列を受け取り、その月の合計日数を判別して文字列として返します。

この機能の核心は、PHPのdate()関数と、特殊なフォーマット文字't'の組み合わせにあります。date()関数は、タイムスタンプを指定されたフォーマットで日付や時刻に変換しますが、フォーマット文字't'を使用すると「その月に含まれる日数（28日から31日）」を直接取得できます。これにより、うるう年の2月（29日）や、30日の月、31日の月といった、月の長さの違いを自動的に考慮し、正確な日数を取得することが可能です。

関数内部では、まずstrtotime()関数を用いて、入力された日付文字列（例: '2023-02-15' や 'now'）を数値のタイムスタンプに変換しています。引数$dateStringには、処理したい日付を文字列で渡しますが、省略した場合は現在の月の日数を取得します。そして、date('t', $timestamp)でそのタイムスタンプが示す月の日数を取得し、最終的に「日付 '〇〇' の月は △△ 日あります。」という形式の文字列として結果を返します。この関数は、カレンダー機能の実装や、特定月のデータ処理などで役立つでしょう。

Copy
1<?php
2
3/**
4 * バックグラウンドタスクを実行し、メインプロセスが完了を待たずに続行します。
5 *
6 * @param string $taskName 実行するタスクの名前
7 * @return void
8 */
9function runBackgroundTask(string $taskName): void
10{
11    // PHP の `T_FOR` は、`for` キーワードのトークン定数です。
12    // 通常、構文解析器が内部的に使用し、直接アプリケーションコードで非同期処理を制御するためには使いません。
13    // しかし、ここでは `for` ループを使って複数のバックグラウンドタスクを起動する例を示します。
14
15    // バックグラウンドで実行されるPHPスクリプトの内容
16    // このコードは新しいPHPプロセスとして起動されます。
17    // `escapeshellarg` を使用して、シェルコマンドに安全に渡します。
18    $backgroundScriptContent = '
19        <?php
20        $taskName = getenv("BG_TASK_NAME"); // 環境変数からタスク名を取得
21        if (!$taskName) {
22            $taskName = "Unknown Task";
23        }
24        $logFile = "/tmp/background_tasks.log";
25        $startTime = date("Y-m-d H:i:s");
26        file_put_contents($logFile, "[$startTime] Starting task: {$taskName}" . PHP_EOL, FILE_APPEND);
27
28        // 模擬的に時間がかかる処理
29        sleep(rand(2, 5));
30
31        $endTime = date("Y-m-d H:i:s");
32        file_put_contents($logFile, "[$endTime] Finished task: {$taskName}" . PHP_EOL, FILE_APPEND);
33        ?>
34    ';
35
36    // `BG_TASK_NAME=...` で環境変数を設定し、バックグラウンドスクリプトにタスク名を渡します。
37    // `php -r ...` でインラインPHPスクリプトを実行します。
38    // `> /dev/null 2>&1 &` は、標準出力と標準エラーを破棄し、プロセスをバックグラウンドで実行するためのシェル構文です。
39    $command = 'BG_TASK_NAME=' . escapeshellarg($taskName) . ' php -r ' . escapeshellarg($backgroundScriptContent) . ' > /dev/null 2>&1 &';
40
41    echo "[$taskName] Background task initiated. Main script will not wait for it to finish." . PHP_EOL;
42    
43    // システムコマンドを実行し、バックグラウンドで新しいプロセスを起動します。
44    exec($command);
45}
46
47// for ループを使って複数のバックグラウンドタスクを開始します。
48// `T_FOR` は、この `for` キーワードに対応するPHPのトークン定数です。
49for ($i = 0; $i < 3; $i++) {
50    runBackgroundTask("Task " . ($i + 1));
51}
52
53echo "All background tasks have been launched." . PHP_EOL;
54echo "Main script continues its execution immediately." . PHP_EOL;
55echo "バックグラウンドタスクの結果は、数秒後に '/tmp/background_tasks.log' ファイルで確認してください。" . PHP_EOL;
56
57// メインスクリプトの完了
58sleep(1); // バックグラウンドプロセスの初期化を確実にするため、少し待機
59echo "Main script finished." . PHP_EOL;
60

このPHPサンプルコードは、メインプログラムがバックグラウンドで実行されるタスクの完了を待たずに、次の処理へ進む方法を示しています。PHPのT_FORは、プログラミング言語の構文解析器がforキーワードを識別するために内部的に使用する定数であり、直接プログラムの実行を制御するものではありませんが、このコードではforループを使って複数のバックグラウンドタスクを起動する例として使用されています。

runBackgroundTask関数は、引数として受け取った$taskName（実行するタスクの名前）を使って、新しいPHPプロセスをバックグラウンドで起動します。この関数はvoidを返すため、特別な戻り値はありません。タスクはexec関数を通じてシェルコマンドとして実行され、コマンド末尾の&記号によって非同期に起動されます。これにより、メインスクリプトはタスクの起動後すぐに次の行へ進み、タスクが終了するのを待つことはありません。バックグラウンドで実行されるタスクは、/tmp/background_tasks.logファイルに開始と終了の情報を記録します。

サンプルコードでは、forループを用いて3つのタスクを次々に起動し、その直後に「Main script finished.」と表示されて、メインスクリプトが速やかに終了する様子が確認できます。バックグラウンドタスクの実際の完了状況は、指定されたログファイルを参照することで確認できます。