pg_query
Exécute une requête PostgreSQL
&reftitle.description;
resourcefalsepg_queryresourceconnectionstringquerypg_query exécute la requête
query sur la base de données spécifiée
connection.
pg_query_params doit être préféré dans la
plupart des cas.
Si une erreur se produit et &false; est retourné, les détails de l'erreur
peuvent être récupérés en utilisant la fonction
pg_last_error si la connexion est valide.
Bien que connection puisse être omis, il n'est
pas recommandé de le faire, car il peut se révéler difficile
de retrouver les bogues dans les scripts.
Auparavant, cette fonction s'appelait pg_exec.
pg_exec est toujours disponible pour des
raisons de compatibilité, mais les utilisateurs sont encouragés à
utiliser le nouveau nom.
&reftitle.parameters;
connection
La ressource de connexion de la base de données PostgreSQL. Lorsque
connection n'est pas présent, la connexion par
défaut est utilisée. La connexion par défaut est la dernière connexion
faite par pg_connect ou pg_pconnect.
query
La requête ou les requêtes SQL à être exécutées. Lorsque plusieurs
requêtes sont passées à la fonction, elles sont automatiquement
exécutées comme étant une transaction, à moins qu'il y aille les
commandes BEGIN/COMMIT incluses dans la requête. Cependant,
l'utilisation de transactions multiples dans un seul appel de fonction
n'est pas recommandée.
L'inperpolation des chaînes de caractères fournies par l'utilisateur
est extrèmement dangereux et vous devez garder en tête l'ensemble
des vulnérabilités concernant les
injections SQL.
Dans la plupart des cas, la fonction pg_query_params
doit être préférée ; il est préférable de passer les valeurs fournies
par l'utilisateur comme paramètres, plutôt que de les substituer
dans la requête.
Toutes données utilisateur substituées directement dans la chaîne
de la requête doivent être
proprement échappées.
&reftitle.returnvalues;
Une ressource de résultats en cas de succès&return.falseforfailure;.
&reftitle.examples;
Exemple avec pg_query
\n";
}
?>
]]>
Utilisation de pg_query avec plusieurs requêtes
]]>
&reftitle.seealso;
pg_connectpg_pconnectpg_fetch_arraypg_fetch_objectpg_num_rowspg_affected_rows