Retourne ou modifie l'état AUTOCOMMIT de la connexion à la base de données

# db2_autocommit

(PECL ibm_db2 >= 1.0.0)

db2_autocommit — Retourne ou modifie l'état AUTOCOMMIT de la connexion à la base de données

### Description

function db2_autocommit(resource `$connection`, int `$value` = ?): int|bool

Modifie ou lit le comportement de AUTOCOMMIT de la connexion spécifiée.

### Liste de paramètres

`connection`
  Une variable de connexion à une base de données valide retournée par db2_connect() ou db2_pconnect().
`value`

  Une des constantes suivantes :

  `DB2_AUTOCOMMIT_OFF`
    Désactive AUTOCOMMIT.
  `DB2_AUTOCOMMIT_ON`
    Active AUTOCOMMIT.

### Valeurs de retour

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 `DB2_AUTOCOMMIT_OFF` signifie que AUTOCOMMIT est désactivé, tandis qu'une valeur de `DB2_AUTOCOMMIT_ON` 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.

### Exemples

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ée 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 == DB2_AUTOCOMMIT_OFF) {
        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 == DB2_AUTOCOMMIT_OFF) {
        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é.

### Voir aussi

- db2_connect() - Retourne une connexion à une base de données
- db2_pconnect() - Retourne une connexion persistante à une base de données

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open