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.78 pg_send_prepare()
Envoie une requête pour créer une requête préparée avec les paramètres
donnés, sans attendre la fin de son exécution
[ Exemples avec pg_send_prepare ] PHP 5 >= 5.1.0RC1
bool
pg_send_prepare (
resource
connection
,
string
stmtname
,
string
query
)
Envoie une requête pour créer une requête préparée avec les paramètres
donnés, sans attendre la fin de son exécution.
Cette fonction est la version asynchrone de
pg_prepare
: elle retourne
TRUE
si elle a été capable de répartir la requête et
FALSE
si elle n'a pas été capable. Après un appel réussi, appelez
pg_get_result
pour déterminer si le serveur a créé
correctement la requête préparée.
Les paramètres de la fonctions sont gérés de la même manière que
pg_execute
. Comme
pg_execute
, la
fonction ne fonctionnera pas sur les versions antérieures à PostgreSQL 7.4.
-
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 à donner à la requête préparée. Il doit être unique à chaque
session. Si une chaîne vide est spécifiée ("") alors une requête sans
nom est créée, écrasant les requêtes sans nom précédemment définies.
-
query
-
La requête SQL paramétrisée. Elle doit contenir seulement une seule
requête. (Plusieurs requêtes séparées par des points-virgules ne sont
pas autorisées.) Si des paramètres sont utilisés, ils sont référés à
$1, $2, etc.
Retourne
TRUE
en cas de succès,
FALSE
en cas d'échec. Utilisez
pg_get_result
pour déterminer le résultat de la
requête.
| Exemple pg_send_prepare |
<?php
$dbconn = pg_connect("dbname=publisher") or die("Connexion impossible");
// Prépare une requête pour l'exécution
if (!pg_connection_busy($dbconn)) {
pg_send_prepare($dbconn, "my_query", 'SELECT * FROM magasins WHERE nom = $1');
$res1 = pg_get_result($dbconn);
}
// Exécute la requête préparée. Notez qu'il n'est pas nécessaire d'échapper
// la chaîne "Joe's Widgets"
if (!pg_connection_busy($dbconn)) {
pg_send_execute($dbconn, "my_query", array("Joe's Widgets"));
$res2 = pg_get_result($dbconn);
}
// Exécute la même requête préparée, cette fois avec un paramètre différent
if (!pg_connection_busy($dbconn)) {
pg_send_execute($dbconn, "my_query", array("Vêtements Vêtements Vêtements"));
$res3 = pg_get_result($dbconn);
}
?>
|
|
