db2_conn_errormsg
(PECL ibm_db2 >= 1.0.0)
db2_conn_errormsg — Retourne le dernier message d'erreur de connexion ainsi que la valeur de SQLCODE
Description
$connection
] )
db2_conn_errormsg() retourne un message d'erreur et la
valeur de SQLCODE représentant la raison pour laquelle la dernière tentative
de connexion à la base de données a échouée. Lorsque
db2_connect() retourne FALSE
en cas d'une tentative de
connexion échouée, ne passez aucun paramètre à
db2_conn_errormsg() pour obtenir le message d'erreur et
la valeur de SQLCODE.
Si par contre la connexion était réussie mais est devenue invalide avec le
temps, vous pouvez passer le paramètre de connexion
connection
pour obtenir le message d'erreur et la
valeur de SQLCODE pour la connexion spécifique.
Liste de paramètres
-
connection
-
Une ressource de connexion associée à la connexion qui a préalablement été réussie, mais qui est devenue invalide avec le temps.
Valeurs de retour
Retourne une chaîne contenant le message d'erreur et la valeur de SQLCODE résultant d'une mauvaise tentative de connexion. Retourne une chaîne vide s'il n'y a pas d'erreur associée avec la dernière tentative de connexion.
Exemples
Exemple #1 Récupération du message d'erreur retourné par une tentative de connexion échouée
L'exemple suivant montre comment retourner un message d'erreur ainsi que la valeur de SQLCODE après un passage forcé d'un paramètre invalide à la fonction db2_connect(). db2_connect().
<?php
$conn = db2_connect('mauvaisnom', 'mauvaisutilisateur', 'mauvaismotdepasse');
if (!$conn) {
print db2_conn_errormsg();
}
?>
L'exemple ci-dessus va afficher :
[IBM][CLI Driver] SQL1013N The database alias name or database name "MAUVAISNOM" could not be found. SQLSTATE=42705 SQLCODE=-1013
Voir aussi
- db2_conn_error() - Retourne une chaîne contenant la valeur de SQLSTATE retournée par la dernière tentative de connexion
- db2_connect() - Retourne une connexion à une base de données
- db2_stmt_error() - Retourne une chaîne contenant la valeur de SQLSTATE retournée par une requête SQL
- db2_stmt_errormsg() - Retourne le dernier message d'erreur d'une requête SQL
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.db2-conn-errormsg.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
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.