Mysqli_Resultを反復可能なオブジェクトとしてカプセル化する方法

M66 2025-05-18

PHP開発では、 MySQLI拡張機能を使用してMySQLデータベースと対話することがよくあります。特にクエリ操作を実行するときは、通常MySQLI_RESULTオブジェクトを取得します。ただし、 MySQLI_RESULTオブジェクト自体は、Arrayやその他の反復可能なオブジェクトなどのQUERY結果を通過するためのForeachの直接使用をサポートしていないため、クエリの結果を処理するときにデータの各行を取得するために、fetch_assoc（）または他の同様の機能を手動で呼び出す必要があります。

より便利にクエリの結果を処理するために、 mysqli_resultを反復可能なオブジェクトにカプセル化することができ、クエリの結果を処理する際のより簡潔で直感的になります。次に、これを達成する方法を探ります。

ステップ1： Iteratorクラスを作成します

Iteratorインターフェイスを実装するクラスを作成して、 mysqli_resultを反復可能なオブジェクトとしてカプセル化できるようにすることができます。まず、クラスがMySQLI_RESULTオブジェクトを受信し、インターフェイスメソッドを実装することで反復をサポートできるようにする必要があります。

 <?php
class MysqliResultIterator implements Iterator {
    private $result;
    private $currentRow;
    private $currentIndex;

    public function __construct($mysqliResult) {
        $this->result = $mysqliResult;
        $this->currentIndex = 0;
    }

    public function rewind() {
        $this->currentIndex = 0;
        $this->currentRow = $this->result->fetch_assoc();
    }

    public function current() {
        return $this->currentRow;
    }

    public function key() {
        return $this->currentIndex;
    }

    public function next() {
        $this->currentRow = $this->result->fetch_assoc();
        $this->currentIndex++;
    }

    public function valid() {
        return $this->currentRow !== null;
    }
}
?>

このクラスでは、 Iteratorインターフェイスの5つの方法を実装します。

Rewind（）：イテレーターを最初の要素にリセットします。
current（）：現在の要素を返します。
key（）：現在の要素のインデックスを返します。
次（）：次の要素に移動します。
valid（）：現在の要素が有効かどうかを確認します。

これらの方法により、 MySqliresUltiteratorクラスを使用すると、操作アレイやその他の反復可能なオブジェクトなどのクエリ結果を直接通過できます。

ステップ2： mysqliresultiteratorを使用します

このIteratorクラスを定義したら、 mysqli_resultオブジェクトをmysqliresultiteratorクラスに渡すことにより、反復可能なオブジェクトを作成できます。

 <?php
// データベース接続を確立し、クエリを実行したとします
$mysqli = new mysqli("localhost", "username", "password", "database");

$query = "SELECT id, name, email FROM users";
$result = $mysqli->query($query);

if ($result) {
    // aを作成します MysqliResultIterator 物体
    $iterator = new MysqliResultIterator($result);

    // 合格 foreach 反復クエリの結果
    foreach ($iterator as $index => $row) {
        echo "Index: " . $index . "<br>";
        echo "ID: " . $row['id'] . "<br>";
        echo "Name: " . $row['name'] . "<br>";
        echo "Email: " . $row['email'] . "<br><hr>";
    }

    // クエリの結果を閉じます
    $result->free();
} else {
    echo "Query failed: " . $mysqli->error;
}

$mysqli->close();
?>

上記のコードでは、 MySqliresUltiteratorオブジェクトを作成し、結果を照会するためにforeachステートメントを繰り返します。このイテレーターを使用すると、コードがより簡潔になり、 fetch_assoc（）メソッドへの手動呼び出しが回避されることがわかります。

ステップ3：イテレーターを最適化する（オプション）

複数のデータ形式（アソシエーション配列、数値配列など）のサポートなど、より柔軟な機能が必要な場合は、さらに多くのオプションをサポートするためにイテレーターをさらに拡張できます。たとえば、パラメーターを追加して、連想配列の形でデータを返すか、数字の配列を返すかを指定します。

 <?php
class MysqliResultIterator implements Iterator {
    private $result;
    private $currentRow;
    private $currentIndex;
    private $fetchType;

    public function __construct($mysqliResult, $fetchType = MYSQLI_ASSOC) {
        $this->result = $mysqliResult;
        $this->currentIndex = 0;
        $this->fetchType = $fetchType;
    }

    public function rewind() {
        $this->currentIndex = 0;
        $this->currentRow = $this->result->fetch_array($this->fetchType);
    }

    public function current() {
        return $this->currentRow;
    }

    public function key() {
        return $this->currentIndex;
    }

    public function next() {
        $this->currentRow = $this->result->fetch_array($this->fetchType);
        $this->currentIndex++;
    }

    public function valid() {
        return $this->currentRow !== null;
    }
}
?>

この改善により、 mysqli_assocまたはmysqli_numを使用して連想配列または数値配列を返すなど、イテレーターを作成するときにクエリ結果の形式を指定できます。

まとめ

mysqli_resultをイテレーターインターフェイスを実装するオブジェクトにカプセル化することにより、データベースクエリの結果の処理をより便利でエレガントにすることができます。これにより、コードが簡潔になるだけでなく、より柔軟性を提供し、さまざまなタイプのクエリ結果をより適切に処理できます。

このカプセル化方法は、特に大量のデータが必要なシナリオでは、コードの保守性と読みやすさを大幅に改善できます。