PHPのお勉強！

PHP TOP
PHP 8.4.2 Released!

    ラージオブジェクト (LOB)

    アプリケーション内で、データベースに「大きな」データを格納する 必要を感じることがあるかもしれません。「大きな」とは、一般的には 「4kb 程度以上」を指しますが、データベースによっては 32kb くらいまでは 「大きい」と判断されずにすむこともあります。ラージオブジェクトは テキストあるいはバイナリの両方の形式をとり得ます。 PDO でこのラージデータ型を扱うには、 PDOStatement::bindParam() や PDOStatement::bindColumn() のコール時に 型コードとして PDO::PARAM_LOB を使用します。 PDO::PARAM_LOB を指定すると、PDO は データをストリームにマップします。これにより、 PHP ストリーム API を使用してデータを扱えるようになります。

    例1 データベース内の画像を表示する

    この例では $lob という名前の変数に LOB をバインドし、 fpassthru() を使用してそれをブラウザに送信します LOB はストリームで表されるので、 fgets()、fread() および stream_get_contents() といった関数を 使用することができます。

    <?php
    $db     = new PDO('odbc:SAMPLE', 'db2inst1', 'ibmdb2');
    $stmt = $db->prepare("select contenttype, imagedata from images where id=?");
    $stmt->execute(array($_GET['id']));
    $stmt->bindColumn(1, $type, PDO::PARAM_STR, 256);
    $stmt->bindColumn(2, $lob, PDO::PARAM_LOB);
    $stmt->fetch(PDO::FETCH_BOUND);

    header("Content-Type: $type");
    fpassthru($lob);
    ?>

    例2 画像をデータベースに挿入する

    この例では、ファイルをオープンしてそのハンドルを PDO に渡し、 LOB としてデータベースに挿入します。PDO は、データベースに応じた もっとも適切な方法でデータを取得します。

    <?php
    $db     = new PDO('odbc:SAMPLE', 'db2inst1', 'ibmdb2');
    $stmt = $db->prepare("insert into images (id, contenttype, imagedata) values (?, ?, ?)");
    $id = get_new_id(); // 新しい ID を割り当てるための何らかの関数

    // フォームからファイルをアップロードしていると仮定します。
    // 詳細な情報は PHP のドキュメントを参照ください。

    $fp = fopen($_FILES['file']['tmp_name'], 'rb');

    $stmt->bindParam(1, $id);
    $stmt->bindParam(2, $_FILES['file']['type']);
    $stmt->bindParam(3, $fp, PDO::PARAM_LOB);

    $db->beginTransaction();
    $stmt->execute();
    $db->commit();
    ?>

    例3 画像をデータベースに挿入する: Oracle

    Oracle は、ファイルから LOB を挿入する方法が他とは少し違います。 また、必ずトランザクション内で挿入しなければなりません。 それ以外の場合、新しく挿入された LOB は長さゼロとなり、クエリの 実行時に暗黙的にコミットされます。

    <?php
    $db     = new PDO('oci:', 'scott', 'tiger');
    $stmt = $db->prepare("insert into images (id, contenttype, imagedata) " .
    "VALUES (?, ?, EMPTY_BLOB()) RETURNING imagedata INTO ?");
    $id = get_new_id(); // 新しい ID を割り当てるための何らかの関数

    // フォームからファイルをアップロードしていると仮定します。
    // 詳細な情報は PHP のドキュメントを参照ください。

    $fp = fopen($_FILES['file']['tmp_name'], 'rb');

    $stmt->bindParam(1, $id);
    $stmt->bindParam(2, $_FILES['file']['type']);
    $stmt->bindParam(3, $fp, PDO::PARAM_LOB);

    $db->beginTransaction();
    $stmt->execute();
    $db->commit();
    ?>

    Found A Problem?

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

    User Contributed Notes 6 notes

    up
    12
    http://matts.org/
    15 years ago
    A big gotcha exists for Oracle users.

    You have to save CLOB objects using PDO::PARAM_STR, not PDO::PARAM_LOB.

    But you MUST send the 4th argument, usually strlen($subject) or you get a LONG error.
    up
    10
    diogoko at gmail dot com
    15 years ago
    PDOStatement's methods bindParam and bindValue also work with strings, as in:

    <?php
    $data     = file_get_contents($filename);
    $stmt->bindValue(1, $data, PDO::PARAM_LOB);
    //...
    ?>

    This was the only way I could make it work with PostgreSQL.
    up
    11
    Jeremy Cook
    14 years ago
    There seems to be a bug that affects example 1 above. PDO::PARAM_LOB when used with pdo::bindColumn() is supposed to return a stream but it returns a string. Passing this string to fpassthru() then triggers an error with the message 'supplied argument is not a valid stream resource'. This has been reported in bug #40913. The work around is to do the following:

    <?php
    $stmt     = $db->prepare("select contenttype, imagedata from images where id=?");
    $stmt->execute(array($_GET['id']));
    $stmt->bindColumn(1, $type, PDO::PARAM_STR, 256);
    $stmt->bindColumn(2, $lob, PDO::PARAM_LOB);
    $stmt->fetch(PDO::FETCH_BOUND);

    header("Content-Type: $type");
    echo(    $lob);
    ?>

    Since the browser is expecting an image after the call to header() writing the string representation of the binary output with echo() has the same affect as calling fpassthru().
    up
    5
    knl at bitflop dot com
    16 years ago
    I spend a lot of time trying to get this to work, but no matter what I did PDO corrupted my data.

    I finally discovered that I had been using:

    $pdo->exec('SET CHARACTER SET utf8');

    in the TRY part of my connection script.

    This off course doesn't work when you feed binary input to PDO using the parameter lob.
    up
    2
    ben dot leiting at gmail dot com
    8 years ago
    For selecting data out of Postgres, the data type of the column in the table determined if the parameter bound with PARAM_LOB returned a string or returned a resource.

    <?php

    // create table log ( data text ) ;
    $geth = $dbh->prepare('select data from log ');
    $geth->execute();
    $geth->bindColumn(1, $dataString, PDO::PARAM_LOB);
    $geth->fetch(PDO::FETCH_BOUND);

    echo (    $dataString); // $dataString is a string

    // create table log ( data bytea ) ;
    $geth = $dbh->prepare('select data from log');
    $geth->execute();
    $geth->bindColumn(1, $dataFH, PDO::PARAM_LOB);
    $geth->fetch(PDO::FETCH_BOUND);

    fpassthru($dataFH); // $dataFH is a resource
    up
    -1
    phpcoder at gmail dot com
    6 years ago
    The DBMSs that are listed above have these (default) limits on the maximum size of a char string. The maximum is given in bytes so the number of characters storable can be smaller if a multibyte encoding is used.

    CUBRID: 16kB
    SQL Server: 2GB
    Firebird: 32kB
    IBM Db2: 32kB
    Informix: 32kB
    MySQL: 16kB
    Oracle: 2kB
    PostgreSQL: 1GB
    SQLite: 1 billion bytes
    4D: Unknown, but LOBs are limited to 2GB.
    ＋add a note
    To Top