Löscht ein Large Object

Beschreibung

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

pg_lo_unlink() löscht das Large Object mit dem Objektbezeichner oid. Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Um die Large Object (lo) Schnittstelle benutzen zu können, müssen die Kommandos innerhalb einer Transaktion ausgeführt werden.

Hinweis:
Diese Funktion ersetzt die Funktion pg_lounlink()().

Parameter-Liste

connection

Eine PgSql\Connection-Instanz. Falls connection nicht angegeben wurde, wird die Standardverbindung benutzt. Das ist die zuletzt mit pg_connect() oder pg_pconnect() aufgebaute Verbindung.

Warnung

Seit PHP 8.1.0 ist die Verwendung der Standardverbindung veraltet.

oid

Der OID des Large Objects in der Datenbank.

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Changelog

Version	Beschreibung
8.1.0	Der Parameter `connection` erwartet nun eine PgSql\Connection-Instanz; vorher wurde eine Ressource erwartet.

Beispiele

Beispiel #1 pg_lo_unlink() Beispiel

<?php
   // OID des Large Objects, das gelöscht werden soll
   $doc_oid = 189762345;
   $database = pg_connect("dbname=jacarta");
   pg_query($database, "begin");
   pg_lo_unlink($database, $doc_oid);
   pg_query($database, "commit");
?>

Siehe auch

pg_lo_create() - Erzeugt ein Large Object
pg_lo_import() - Importiert ein Large Object aus einer Datei