• « pg_lo_truncate
  • pg_lo_write »
  • PHP Manual
  • Funciones de PostgreSQL
  • Elimina un objeto grande de PostgreSQL

pg_lo_unlink

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_lo_unlink — Elimina un objeto grande de PostgreSQL

Descripción

pg_lo_unlink(PgSql\Connection $connection, int $oid): bool

pg_lo_unlink() elimina el objeto grande cuyo identificador es oid, para la conexión connection. Esta función retorna true en caso de éxito o false si ocurre un error.

Para utilizar un objeto grande (lo), es necesario hacerlo dentro de una transacción.

Nota:

Anteriormente, esta función se llamaba pg_lounlink().

Parámetros

connection

Una instancia PgSql\Connection. Cuando connection no es especificado, se usa la conexión por defecto. La conexión por defecto es la última conexión hecha por pg_connect() o pg_pconnect()

Advertencia

Desde PHP 8.1.0, usar la conexión por defecto está obsoleto.

oid

El OID del objeto grande en la base de datos.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Historial de cambios

Versión Descripción
8.1.0 El parámetro connection ahora espera una instancia de PgSql\Connection ; anteriormente, se esperaba un resource.

Ejemplos

Ejemplo #1 Ejemplo con pg_lo_unlink()

<?php
// OID del objeto grande a eliminar
$doc_oid = 189762345;
$database = pg_connect("dbname=jacarta");
pg_query($database, "begin");
pg_lo_unlink($database, $doc_oid);
pg_query($database, "commit");
?>

Ver también

  • pg_lo_create() - Crea un objeto de gran tamaño de PostgreSQL
  • pg_lo_import() - Importa un objeto de gran tamaño desde un fichero