PHP 8.4.2 Released!

    手続き型とオブジェクト指向インターフェイス

    mysqli 拡張モジュールは、 ふたつのインターフェイスを提供しています。 手続き型とオブジェクト指向のインターフェイスです。

    古い mysql 拡張モジュールから移行するユーザーは、 手続き型のインターフェイスを好むかもしれません。 手続き型のインターフェイスは、古い mysql 拡張モジュールのそれに似ています。 多くの場合、関数名はプレフィックスのみが異なりますが、 mysqli の関数によっては、最初の引数に接続ハンドルを取るものもあります。 一方で、それと一致する古い mysql 拡張モジュールのインターフェイスは、 オプションの接続ハンドルを最後にとるようになっています。

    例1 古い mysql 拡張モジュールから移行する簡単な方法

    <?php
    $mysqli     = mysqli_connect("example.com", "user", "password", "database");
    $result = mysqli_query($mysqli, "SELECT 'Please do not use the deprecated mysql extension for new development. ' AS _msg FROM DUAL");
    $row = mysqli_fetch_assoc($result);
    echo     $row['_msg'];

    $mysql = mysql_connect("example.com", "user", "password");
    mysql_select_db("test");
    $result = mysql_query("SELECT 'Use the mysqli extension instead.' AS _msg FROM DUAL", $mysql);
    $row = mysql_fetch_assoc($result);
    echo     $row['_msg'];

    上の例の出力は以下となります。

    Please do not use the deprecated mysql extension for new development. Use the mysqli extension instead.

    オブジェクト指向インターフェイス

    伝統的な手続き型のインターフェイスに加えて、 ユーザーはオブジェクト指向インターフェイスを選ぶことができます。 このドキュメントは、 オブジェクト指向インターフェイスも使えるように整理されています。 オブジェクト指向インターフェイスは、 目的に応じてグループ化されていますし、 使い始めるのも簡単です。リファレンスのページでは、 手続き型に加えて、オブジェクト指向インターフェイスの使い方も示しています。

    この2つのインターフェイスの間に、 目立ったパフォーマンスの違いはありません。 ユーザーは、自分の好みに応じてインターフェイスを選択できます。

    例2 オブジェクト指向と手続き型のインターフェイス

    <?php

    $mysqli     = mysqli_connect("example.com", "user", "password", "database");

    $result = mysqli_query($mysqli, "SELECT 'A world full of ' AS _msg FROM DUAL");
    $row = mysqli_fetch_assoc($result);
    echo     $row['_msg'];

    $mysqli = new mysqli("example.com", "user", "password", "database");

    $result = $mysqli->query("SELECT 'choices to please everybody.' AS _msg FROM DUAL");
    $row = $result->fetch_assoc();
    echo     $row['_msg'];

    上の例の出力は以下となります。

    A world full of choices to please everybody.

    このクイックスタートガイドでは、 オブジェクト指向のインターフェイスを使います。 なぜなら、リファレンスのページが、そのように整理されているからです。

    ふたつのスタイルを混ぜる

    手続き型と、オブジェクト指向のやり方を切り替えることもできます。 これら両方のスタイルを混ぜることは、 コードの明確さやコーディングスタイルを統一する理由から、 推奨できません。

    例3 悪いコーディングスタイル

    <?php

    $mysqli     = new mysqli("example.com", "user", "password", "database");

    $result = mysqli_query($mysqli, "SELECT 'Possible but bad style.' AS _msg FROM DUAL");

    if (    $row = $result->fetch_assoc()) {
    echo     $row['_msg'];
    }

    上の例の出力は以下となります。

    Possible but bad style.

    参照

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    31
    Anonymous
    9 years ago
    Just want to add that both procedural mysqli_connect_errno and mysqli_connect_error DON'T accept any arguments!
    http://php.net/manual/de/mysqli.connect-errno.php
    http://php.net/manual/de/mysqli.connect-error.php
    "int mysqli_connect_errno ( void )"
    "string mysqli_connect_error ( void )"
    It clearly states "void" there.

    Adding the mysqli-Instance as a parameter makes it look like it pulls the error-number out of the provided instance, which is not actually happening. This could end in a hard to detect bug when connecting to multiple SQL servers.
    And it is confusing for beginners.
    ＋add a note
    To Top