• « pg_lo_truncate
  • pg_lo_write »
  • PHP Manual
  • Fonctions PostgreSQL
  • Efface un objet de grande taille PostgreSQL

pg_lo_unlink

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

pg_lo_unlink — Efface un objet de grande taille PostgreSQL

Description

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

pg_lo_unlink() efface l'objet de grande taille dont l'identifiant est oid, pour la connexion connection. Cette fonction retourne true en cas de succès ou false si une erreur survient.

Pour utiliser un objet de grande taille (lo), il est nécessaire de le faire dans une transaction.

Note:

Auparavant, cette fonction s'appelait pg_lounlink().

Liste de paramètres

connection

Une instance PgSql\Connection. Quand connection est pas spécifié, la connexion par défaut est utilisé. La connexion par défaut est la dernière connexion faite par pg_connect() ou pg_pconnect()

Avertissement

À partir de PHP 8.1.0, utiliser la connection par défaut est obsolète.

oid

Le OID de l'objet de grande taille dans la base de données.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Historique

Version Description
8.1.0 Le paramètre connection attend désormais une instance de PgSql\Connection ; auparavant, une ressource était attendu.

Exemples

Exemple #1 Exemple avec pg_lo_unlink()

<?php
// OID de l'objet de grande taille à supprimer
$doc_oid = 189762345;
$database = pg_connect("dbname=jacarta");
pg_query($database, "begin");
pg_lo_unlink($database, $doc_oid);
pg_query($database, "commit");
?>

Voir aussi

  • pg_lo_create() - Crée un objet de grande taille PostgreSQL
  • pg_lo_import() - Importe un objet de grande taille depuis un fichier