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.30 pg_fetch_object()
Lit une ligne de résultat PostgreSQL dans un objet
[ Exemples avec pg_fetch_object ] PHP 3 >= 3.0.1, PHP 4, PHP 5
object
pg_fetch_object (
resource
result
,
int
row
,
int
result_type
)
object
pg_fetch_object (
resource
result
,
int
row
,
string
class_name
,
array
params
)
pg_fetch_object
retourne un objet ainsi que ses
propriétés qui correspond aux noms des champs de la ligne. La fonction
peut optionnellement instancier un objet d'une classe spécifique et passer
les paramètres au constructeur de cette classe.
| Note | |
Cette fonction définit les champs NULL à la
valeur PHP
NULL
.
|
Du point de vue vitesse, la fonction est identique à
pg_fetch_array
et est presque aussi rapide que
pg_fetch_row
(la différence est insignifiante).
| Note | |
row
est devenu optionnel depuis PHP 4.1.0.
|
| Note | |
La valeur par défaut de
result_type
a changé pour
passer de
PGSQL_BOTH
à
PGSQL_ASSOC
depuis PHP 4.3.0, depuis que les index
numériques sont devenus illégaux.
|
| Note | |
class_name
et
params
ont été
ajoutés dans PHP 5.0. L'ancienne syntaxe avec
result_type
existe toujours pour des compatibilités
antérieures.
|
-
result
-
Ressource de résultat de requête PostgreSQL, retournée par
pg_query
,
pg_query_params
ou
pg_execute
(entre autres).
-
row
-
Numéro de la ligne à récupérer. Les lignes sont numérotées de 0 en
montant. Si l'argument est omis, la ligne suivante est récupérée.
-
result_type
-
Ignoré et obsolète. Valeur par défaut :
PGSQL_ASSOC
-
class_name
-
Le nom de la classe à instancier, fixe les propriétés de celles-ci et
ses valeurs de retour. Si rien n'est spécifié, un objet de style
stdClass
est retourné.
-
params
-
Paramètre optionnel de type
array
pour passer des
arguments au constructeur de la classe
class_name
.
Un objet de type
object
avec les attributs pour chaque champ
dans le jeu de résultats.
Les valeurs
NULL
de la base de données sont retournées
NULL
.
FALSE
est retournée si
row
excède le nombre de
lignes dans le jeu de résultats, n'a plus de ligne disponible ou tout
autre erreur.
| Exemple avec pg_fetch_object |
<?php
$database = 'store';
$db_conn = pg_connect("host=localhost port=5432 dbname=$database");
if (!$db_conn) {
echo "La connexion a la base $database a échouée\n";
exit;
}
$qu = pg_query($db_conn, "SELECT * FROM livres ORDER BY auteur");
while ($data = pg_fetch_object($qu)) {
echo $data->auteur . " (";
echo $data->annee . "): ";
echo $data->titre . "<br />";
}
pg_free_result($qu);
pg_close($db_conn);
?>
|
|
