【PHP8.x】startメソッドの使い方

Copy
1<?php
2
3/**
4 * Fiber内で文字列が特定のプレフィックスで始まるかを確認する処理を実行します。
5 *
6 * この関数はPHP 8.1で導入されたFiber（ファイバー）の基本的な使い方と、
7 * PHP 8.0で導入されたstr_starts_with関数を組み合わせて、
8 * システムエンジニアを目指す初心者が理解しやすいように構成されています。
9 *
10 * @param string $text チェックする元の文字列。
11 * @param string $prefix 検索するプレフィックス（接頭辞）。
12 * @return string ファイバーの実行結果として返されるメッセージ。
13 */
14function checkStringStartsWithInFiber(string $text, string $prefix): string
15{
16    // Fiberインスタンスを作成します。
17    // Fiberは、実行を一時停止し、後で再開できる軽量な並行処理の仕組みです。
18    // ここでは、特定の処理（文字列チェック）をファイバー内で実行します。
19    $fiber = new Fiber(function (string $fiberText, string $fiberPrefix): string {
20        // ファイバー内で処理を開始したことを示します。
21        echo "ファイバー: 処理を開始します。元の文字列: '{$fiberText}', プレフィックス: '{$fiberPrefix}'\n";
22
23        // str_starts_with関数は、文字列が特定のプレフィックスで始まるかを効率的にチェックします。
24        // PHP 8.0以降で利用可能です。
25        if (str_starts_with($fiberText, $fiberPrefix)) {
26            $result = "ファイバー: はい、'{$fiberText}' は '{$fiberPrefix}' で始まります。";
27        } else {
28            $result = "ファイバー: いいえ、'{$fiberText}' は '{$fiberPrefix}' で始まりません。";
29        }
30
31        // ファイバー内で処理を完了したことを示します。
32        echo "ファイバー: 処理を完了します。\n";
33
34        // ファイバーの実行結果を返します。この値はFiber::start()の戻り値となります。
35        return $result;
36    });
37
38    // Fiber::start()メソッドを呼び出して、ファイバーの実行を開始します。
39    // ここで渡した引数($text, $prefix)は、Fiberのコールバック関数
40    // (上記の anonymous function) の引数 ($fiberText, $fiberPrefix) として渡されます。
41    // ファイバーが処理を完了すると、その戻り値がFiber::start()から返されます。
42    $fiberResult = $fiber->start($text, $prefix);
43
44    // メインスクリプトでファイバーの実行結果を受け取ったことを示します。
45    echo "メイン: ファイバーから結果を受け取りました。\n";
46
47    // ファイバーから受け取った最終結果を返します。
48    return $fiberResult;
49}
50
51// --- サンプル実行 ---
52
53echo "--- 実行例 1: 文字列がプレフィックスで始まる場合 ---\n";
54$output1 = checkStringStartsWithInFiber("HelloWorld", "Hello");
55echo "最終結果: " . $output1 . "\n\n";
56
57echo "--- 実行例 2: 文字列がプレフィックスで始まらない場合 ---\n";
58$output2 = checkStringStartsWithInFiber("OpenSource", "Proprietary");
59echo "最終結果: " . $output2 . "\n\n";
60
61echo "--- 実行例 3: 大文字・小文字を区別する場合 (str_starts_withの特性) ---\n";
62$output3 = checkStringStartsWithInFiber("php", "PHP");
63echo "最終結果: " . $output3 . "\n\n";

このサンプルコードは、PHP 8.1で導入されたFiber（ファイバー）の基本的な利用方法と、PHP 8.0で導入されたstr_starts_with関数を組み合わせて、文字列が特定のプレフィックスで始まるかを確認する処理を示しています。

Fiberは、実行を一時停止し、後で再開できる軽量な並行処理の仕組みです。まず、実行したい処理を無名関数として指定し、new Fiber()でFiberインスタンスを作成します。

Fiber::start(mixed ...$args)メソッドは、このFiberインスタンスの実行を開始します。引数...$argsに渡された値は、Fiber作成時に指定した無名関数（コールバック関数）の引数として順に渡されます。サンプルコードでは、チェック対象の文字列$textとプレフィックス$prefixがFiber::startに渡され、ファイバー内で利用されます。

ファイバー内の処理では、PHP 8.0以降で利用可能なstr_starts_with()関数を使って、文字列が指定されたプレフィックスで始まるかを効率的にチェックします。この関数は、大文字と小文字を区別して判定します。

ファイバー内の無名関数が処理を完了し、returnで値を返すと、その値がFiber::start()メソッドの戻り値として返されます。これにより、メインスクリプトはファイバーで実行された処理の結果を受け取ることができます。このように、Fiber::startはファイバーの実行開始と結果の取得を担う重要なメソッドです。