Большие объекты (LOB)

Иногда для работы приложения необходимо хранить "большие" порции данных в базе. Обычно, под большим понимают объем данных около 4 килобайт или больше, хотя некоторые базы данных могут спокойно обрабатывать до 32 килобайт, прежде чем размер данных становится "большим". Большие объекты могут быть текстовыми или двоичными. PDO позволяет работать с такими объектами путем задания типа данных PDO::PARAM_LOB в методах PDOStatement::bindParam() или PDOStatement::bindColumn(). PDO::PARAM_LOB сообщает PDO, что нужно пометить эти данные, как поток. И соответственно работать с такими объектами можно, используя API потоков PHP.

Пример #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$typePDO::PARAM_STR256);
$stmt->bindColumn(2$lobPDO::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

// предположим, что мы находимся на странице загрузки файлов на удаленный сервер

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

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

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

Пример #3 Вставка изображения в базу данных: Oracle

В случае с базами Oracle требуется несколько иной синтаксис для извлечения содержимого файла и помещения в базу. Также необходимо выполнять вставку в рамках транзакции, иначе вставленный 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

// предположим, что мы находимся на странице загрузки файлов на удаленный сервер

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

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

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

Коментарии

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.
2008-09-23 15:07:10
http://php5.kiev.ua/manual/ru/pdo.lobs.html
PDOStatement's methods bindParam and bindValue also work with strings, as in:

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

This was the only way I could make it work with PostgreSQL.
2009-04-01 12:33:25
http://php5.kiev.ua/manual/ru/pdo.lobs.html
Автор:
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.
2009-08-28 16:30:57
http://php5.kiev.ua/manual/ru/pdo.lobs.html
Автор:
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$typePDO::PARAM_STR256);
$stmt->bindColumn(2$lobPDO::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().
2010-02-19 15:31:17
http://php5.kiev.ua/manual/ru/pdo.lobs.html
I find it easier to use stream_get_contens to fetch the data of a lob using the file handle.

<?php
$stmt 
$pdo->con->prepare'select * from filetable' );
$stmt->execute();
$res $stmt->fetchAllPDO::FETCH_ASSOC );

for( 
$i=0$i<count($res); $i++ ){
 
$filename "C:/tmp/".$res[$i]['FILE_ID'].'.xml';
 
$content stream_get_contents$res[$i]['DATA_FILE'] );
 
file_put_contents$filename$content );
}
?>
2011-01-13 13:11:56
http://php5.kiev.ua/manual/ru/pdo.lobs.html
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$dataStringPDO::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$dataFHPDO::PARAM_LOB);
$geth->fetch(PDO::FETCH_BOUND);

fpassthru($dataFH); // $dataFH is a resource
2016-06-13 20:56:17
http://php5.kiev.ua/manual/ru/pdo.lobs.html
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.
2018-10-31 13:34:00
http://php5.kiev.ua/manual/ru/pdo.lobs.html

    Поддержать сайт на родительском проекте КГБ