(PECL ibm_db2 >= 1.0.0)
db2_autocommit — Retourne ou modifie l'état AUTOCOMMIT de la connexion à la base de données
Modifie ou lit le comportement de AUTOCOMMIT de la connexion spécifiée.
connectionUne variable de connexion à une base de données valide retournée par db2_connect() ou db2_pconnect().
valueUne des constantes suivantes :
Désactive AUTOCOMMIT.
Active AUTOCOMMIT.
Lorsque db2_autocommit() reçoit seulement
connection comme paramètre, la fonction retourne
un entier représentant l'état courant de AUTOCOMMIT de la connexion fournie.
Une valeur de 0 signifie que AUTOCOMMIT est désactivé, tandis qu'une valeur
de 1 signifie que AUTOCOMMIT est activé.
Lorsque db2_autocommit() reçoit les deux paramètres
connection et autocommit,
la fonction essaie de modifier l'état AUTOCOMMIT à l'état
autocommit de la connexion fournie.
Cette fonction retourne TRUE en cas de
succès ou FALSE si une erreur survient.
Exemple #1 Récupération de la valeur de AUTOCOMMIT pour une connexion
Dans l'exemple suivant, une connexion qui a été initialisée avec l'état AUTOCOMMIT désactivé est testé avec la fonction db2_autocommit().
<?php
$options = array('autocommit' => DB2_AUTOCOMMIT_OFF);
$conn = db2_connect($database, $user, $password, $options);
$ac = db2_autocommit($conn);
if ($ac == 0) {
print "$ac -- AUTOCOMMIT est désactivé.";
} else {
print "$ac -- AUTOCOMMIT est activé.";
}
?>
L'exemple ci-dessus va afficher :
0 -- AUTOCOMMIT est désactivé.
Exemple #2 Modification de la valeur de AUTOCOMMIT pour une connexion
Dans l'exemple suivant, une connexion qui a été préalablement initialisée avec l'état AUTOCOMMIT désactivé a son comportement changé lors de l'activation de l'état AUTOCOMMIT.
<?php
$options = array('autocommit' => DB2_AUTOCOMMIT_OFF);
$conn = db2_connect($database, $user, $password, $options);
// Active AUTOCOMMIT
$rc = db2_autocommit($conn, DB2_AUTOCOMMIT_ON);
if ($rc) {
print "Activation AUTOCOMMIT réussie.\n";
}
// Vérification de l'état AUTOCOMMIT
$ac = db2_autocommit($conn);
if ($ac == 0) {
print "$ac -- AUTOCOMMIT est désactivé.";
} else {
print "$ac -- AUTOCOMMIT est activé.";
}
?>
L'exemple ci-dessus va afficher :
Activation AUTOCOMMIT réussie. 1 -- AUTOCOMMIT est activé.