Pdo\Pgsql::setNoticeCallback

(PHP 8 >= 8.4.0)

Pdo\Pgsql::setNoticeCallback — Set a callback to handle notice and warning messages generated by the backend

Beschreibung

public Pdo\Pgsql::setNoticeCallback(?callable $callback): void

Set a callback to handle notice and warning messages generated by the backend. This includes messages emitted by PostgreSQL itself, as well as those raised by user-defined SQL functions using RAISE. Please note that the actual receipt of these messages depends on the backend setting client_min_messages.

Parameter-Liste

callback

If null is passed, the handler is reset to its default state.

Otherwise, the handler is a callback with the following signature:

handler(string $message): void

message: A message generated by the backend.

Rückgabewerte

Es wird kein Wert zurückgegeben.

Beispiele

Beispiel #1 Pdo\Pgsql::setNoticeCallback() example

<?php
$pdo = new Pdo\Pgsql('pgsql:dbname=test host=localhost', $user, $pass);

$pdo->exec('CREATE TABLE parent(id int primary key)');
$pdo->exec('CREATE TABLE child(id int references parent)');

$pdo->setNoticeCallback(function ($message) {
    echo $message;
});

$pdo->exec('TRUNCATE parent CASCADE');
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

NOTICE:  truncate cascades to table "child"