8.103 PostgreSQL
8 Référence des fonctions
Manuel PHP
. Introduction . Pré-requis . Installation . Configuration à l'exécution . Types de ressources . Constantes pré-définies . Notes . Exemples . pg_affected_rows . pg_cancel_query . pg_client_encoding . pg_close . pg_connect . pg_connection_busy . pg_connection_reset . pg_connection_status . pg_convert . pg_copy_from . pg_copy_to . pg_dbname . pg_delete . pg_end_copy . pg_escape_bytea . pg_escape_string ->pg_execute . pg_fetch_all_columns . pg_fetch_all . pg_fetch_array . pg_fetch_assoc . pg_fetch_object . pg_fetch_result . pg_fetch_row . pg_field_is_null . pg_field_name . pg_field_num . pg_field_prtlen . pg_field_size . pg_field_type_oid . pg_field_type . pg_free_result . pg_get_notify . pg_get_pid . pg_get_result . pg_host . pg_insert . pg_last_error . pg_last_notice . pg_last_oid . pg_lo_close . pg_lo_create . pg_lo_export . pg_lo_import . pg_lo_open . pg_lo_read_all . pg_lo_read . pg_lo_seek . pg_lo_tell . pg_lo_unlink . pg_lo_write . pg_meta_data . pg_num_fields . pg_num_rows . pg_options . pg_parameter_status . pg_pconnect . pg_ping . pg_port . pg_prepare . pg_put_line . pg_query_params . pg_query . pg_result_error_field . pg_result_error . pg_result_seek . pg_result_status . pg_select . pg_send_execute . pg_send_prepare . pg_send_query_params . pg_send_query . pg_set_client_encoding . pg_set_error_verbosity . pg_trace . pg_transaction_status . pg_tty . pg_unescape_bytea . pg_untrace . pg_update . pg_version
|
8.103.25 pg_execute()
Envoie une requête pour exécuter une requête préparée avec les
paramètres donnés et attend le résultat
[ Exemples avec pg_execute ] PHP 5 >= 5.1.0RC1
resource
pg_execute (
resource
connection
,
string
stmtname
,
array
params
)
resource
pg_execute (
string
stmtname
,
array
params
)
Envoie une requête pour exécuter une requête préparée avec les
paramètres donnés et attend le résultat.
pg_execute
est comme
pg_query_params
,
mais la commande qui sera exécutée est spécifiée en nommant une requête
préalablement préparée, au lieu de donner une chaîne en tant que requête.
Cette caractéristique permet aux commandes qui seront utilisées à
plusieurs reprises d'être analysées et planifiées qu'une seule fois,
plutôt que d'être exécutées chaque fois. La requête doit avoir été
préalablement préparée dans la session courante.
pg_execute
est supportée seulement avec les versions
PostgreSQL 7.4 ou plus récentes; la commande échouera si vous l'utilisez
avec des versions antérieures.
Les paramètres sont identiques à la fonction
pg_query_params
à l'exception du nom de la requête préparée qui est donnée à la place de la
requête sous forme de chaîne.
-
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
.
-
stmtname
-
Le nom de la requête préparée à exécuter. Si une chaîne vide est
spécifiée (""), alors la requête qui n'est pas nommée est exécutée. Le
nom doit avoir été précédemment préparé en utilisant
pg_prepare
,
pg_send_prepare
ou une commande SQL
PREPARE
.
-
params
-
Un tableau de valeurs de paramètres pour substituer les variables $1, $2, etc.
dans la requête préparée originale. Le nombre d'éléments présents dans
le tableau doit concorder avec le nombre de variables à remplacer.
Une ressource de résultats en cas de succès ou
FALSE
en cas d'échec.
| Exemple avec pg_execute |
<?php // Connexion à une base de données nommée "marie" $dbconn = pg_connect("dbname=marie");
// Prépare une requête pour l'exécution $result = pg_prepare($dbconn, "my_query", 'SELECT * FROM magasins WHERE nom = $1');
// Exécute la requête préparée. Notez qu'il n'est pas nécessaire d'échapper // la chaîne "Joe's Widgets" $result = pg_execute($dbconn, "my_query", array("Joe's Widgets"));
// Exécute la même requête préparée, cette fois avec un paramètre différent $result = pg_execute($dbconn, "my_query", array("Vêtements Vêtements Vêtements"));
?>
|
|