cubrid_execute

(PECL CUBRID >= 8.3.0)

cubrid_execute — Exécute une requête SQL préparée

Description

cubrid_execute ( resource $conn_identifier , string $sql [, int $option = 0 ] ) : resource

cubrid_execute ( resource $request_identifier [, int $option = 0 ] ) : bool

La fonction cubrid_execute() est utilisée pour exécuter une requête SQL. Elle exécute la requête en utilisant le paramètre conn_identifier et SQL, puis, retourne l'identifiant de requête créé. Elle est utilisée pour une exécution simple de requête, où le liage de paramètre n'est pas nécessaire. De plus, la fonction cubrid_execute() est utilisée pour exécuter la requête préparée en utilisant cubrid_prepare() et cubrid_bind(). À ce point, vous devez spécifier les arguments request_identifier et option.

L'option est utilisé pour déterminer si l'on doit récupérer l'IOD après l'exécution de la requête, et si l'on doit exécuter la requête en mode asynchrone ou non. CUBRID_INCLUDE_OID et CUBRID_ASYNC (ou CUBRID_EXEC_QUERY_ALL si vous voulez exécuter plusieurs requêtes SQL) peuvent être spécifiés en utilisant l'opérateur OR. Si l'opérateur n'est pas spécifié, aucun des deux ne sera sélectionné. Si le drapeau CUBRID_EXEC_QUERY_ALL est défini, le mode synchrone (sync_mode) sera utilisé pour récupérer les résultats de la requête, et dans un tel cas, les règles suivantes seront appliquées :

La valeur retournée sera le résultat de la première requête.
Si une erreur survient dans une des requêtes, l'exécution sera vu comme étant un échec.
Pour une requête composée de q1 q2 et q3, si une erreur survient dans q2 alors que q1 a été exécutée avec succès, le résultat de q1 reste valide. Ainsi, l'exécution avec succès d'une précédente requête ne sera pas annulée lorsqu'une erreur survient.
Si une requête est exécutée avec succès, le résultat de la seconde requête peut être obtenu en utilisant la fonction cubrid_next_result().

Si le premier paramètre est request_identifier pour exécuter la fonction cubrid_prepare(), vous pouvez spécifier une option, CUBRID_ASYNC uniquement.

Retour à la première page de Manuel PHP Table des matières Haut

Liste de paramètres

conn_identifier: Identifiant de connexion.
sql: SQL à exécuter.
option: Option d'exécution de la requête : CUBRID_INCLUDE_OID, CUBRID_ASYNC, CUBRID_EXEC_QUERY_ALL.
request_identifier: Identifiant de requête pour la fonction cubrid_prepare().

Retour à la première page de Manuel PHP Table des matières Haut

Valeurs de retour

Un identifiant de requête, lorsque l'opération a été réalisée avec succès et que le premier paramètre est l'identifiant de connexion ; TRUE, lorsque l'opération a été réalisée avec succès et que le premier paramètre est l'identifiant de requête.

FALSE, si une erreur survient.

Retour à la première page de Manuel PHP Table des matières Haut

Historique

Version	Description
8.4.0	Ajout d'une nouvelle option : CUBRID_EXEC_QUERY_ALL.

Retour à la première page de Manuel PHP Table des matières Haut

Exemples

Exemple #1 Exemple avec cubrid_execute()


<?php
$conn = cubrid_connect("localhost", 33000, "demodb");

$result = cubrid_execute($conn, "SELECT code FROM event WHERE name='100m Butterfly' and gender='M'", CUBRID_ASYNC);
$row = cubrid_fetch_array($result, CUBRID_ASSOC);
$event_code = $row["code"];

cubrid_close_request($result);

$history_req = cubrid_prepare($conn, "SELECT * FROM history WHERE event_code=?");
cubrid_bind($history_req, 1, $event_code, "number");
cubrid_execute($history_req);

printf("%-20s %-9s %-10s %-5s\n", "athlete", "host_year", "score", "unit");
while ($row = cubrid_fetch_array($history_req, CUBRID_ASSOC)) {
    printf("%-20s %-9s %-10s %-5s\n",
        $row["athlete"], $row["host_year"], $row["score"], $row["unit"]);
}

cubrid_close_request($history_req);

cubrid_disconnect($conn);
?>

L'exemple ci-dessus va afficher :

athlete              host_year score      unit
Phelps Michael       2004      51.25      time

Retour à la première page de Manuel PHP Table des matières Haut

Voir aussi

cubrid_prepare() - Prépare une requête SQL pour son exécution
cubrid_bind() - Lie des valeurs à une requête préparée
cubrid_next_result() - Récupère le résultat de la prochaine requête lors de l'exécution de requêtes SQL multiples
cubrid_close_request() - Ferme le gestionnaire de requête
cubrid_commit() - Commit une transaction
cubrid_rollback() - Annule une transaction

Rechercher une fonction PHP

Version en cache

26/11/2024 10:15:57 Cette version de la page est en cache (à la date du 26/11/2024 10:15:57) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-cubrid-execute.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut