PHP 5.5.16 is released

Objetos grandes (LOBs)

En algún punto de una aplicación, podría ser necesario almacenar datos "grandes" en la base de datos. Grande típicamente significa "alrededor de 4kb o más", aunque algunas bases de datos pueden manejar fácilmente hasta 32kb antes de que los datos se consideren "grandes". Los LOBs (acrónimo de 'Large Objects') pueden ser de texto o binarios. PDO permite trabajar con este tipo de datos grandes usando el código del tipo PDO::PARAM_LOB en llamadas a PDOStatement::bindParam() o PDOStatement::bindColumn(). PDO::PARAM_LOB indica a PDO que haga corresponder los datos como un flujo, por lo que se pueden manipular usando la API de flujos de PHP.

Ejemplo #1 Mostrar una imagen desde una base de datos

Este ejemplo vincula un LOB a una variable llamada $lob, y luego lo envía al navegador usando fpassthru(). Ya que el LOB está representado como un flujo, se pueden usar funciones tales como fgets(), fread() y stream_get_contents() para manejarlo.

<?php
$bd 
= new PDO('odbc:SAMPLE''db2inst1''ibmdb2');
$sentencia $bd->prepare("select contenttype, imagedata from images where id=?");
$sentencia->execute(array($_GET['id']));
$sentencia->bindColumn(1$tipoPDO::PARAM_STR256);
$sentencia->bindColumn(2$lobPDO::PARAM_LOB);
$sentencia->fetch(PDO::FETCH_BOUND);

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

Ejemplo #2 Insertar una imagen en una base de datos

Este ejemplo abre un fichero y pasa el gestor del fichero a PDO para insertarlo como un LOB. PDO hará todo lo posible para enviar el contenido del fichero a la base de datos de la manera más eficiente.

<?php
$bd 
= new PDO('odbc:SAMPLE''db2inst1''ibmdb2');
$sentencia $bd->prepare("insert into images (id, contenttype, imagedata) values (?, ?, ?)");
$id get_new_id(); // alguna función para asignar un nuevo ID

// se asume que se está ejecutando como parte de un formulario de subidas de ficheros
// Se puede encontrar más información en la documentación de PHP

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

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

$bd->beginTransaction();
$sentencia->execute();
$bd->commit();
?>

Ejemplo #3 Insertar una imagen en una base de datos: Oracle

Oracle requiere una sintaxis ligeramente diferente para insertar un LOB desde un fichero. También es esencial que se realice la inserción bajo una transacción, si no, el LOB recién insertado será consignado con una longitud cero como parte de la consigna implícita que ocurre cuando la consulta se ejecuta:

<?php
$bd 
= new PDO('oci:''scott''tiger');
$sentencia $bd->prepare("insert into images (id, contenttype, imagedata) " .
"VALUES (?, ?, EMPTY_BLOB()) RETURNING imagedata INTO ?");
$id get_new_id(); // alguna función para asignar un nuevo ID

// se asume que se está ejecutando como parte de un formulario de subidas de ficheros
// Se puede encontrar más información en la documentación de PHP

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

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

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

add a note add a note

User Contributed Notes 5 notes

up
2
diogoko at gmail dot com
5 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
1
knl at bitflop dot com
5 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
1
xorinox at gmx dot ch
3 years ago
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->fetchAll( PDO::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 );
}
?>
up
1
Jeremy Cook
4 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
0
http://matts.org/
4 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.
To Top