8.81 Extension MySQL améliorée
8 Référence des fonctions
Manuel PHP
. Introduction . Pré-requis . Installation . Configuration à l'exécution . Classes pré-définies . Constantes pré-définies . mysqli_affected_rows . mysqli_autocommit . mysqli_bind_param . mysqli_bind_result . mysqli_change_user . mysqli_character_set_name . mysqli_client_encoding . mysqli_close . mysqli_commit . mysqli_connect_errno . mysqli_connect_error . mysqli_connect . mysqli_data_seek . mysqli_debug . mysqli_disable_reads_from_master . mysqli_disable_rpl_parse . mysqli_dump_debug_info . mysqli_embedded_connect . mysqli_enable_reads_from_master . mysqli_enable_rpl_parse . mysqli_errno . mysqli_error . mysqli_escape_string . mysqli_execute ->mysqli_fetch_array . mysqli_fetch_assoc . mysqli_fetch_field_direct . mysqli_fetch_field . mysqli_fetch_fields . mysqli_fetch_lengths . mysqli_fetch_object . mysqli_fetch_row . mysqli_fetch . mysqli_field_count . mysqli_field_seek . mysqli_field_tell . mysqli_free_result . mysqli_get_client_info . mysqli_get_client_version . mysqli_get_host_info . mysqli_get_metadata . mysqli_get_proto_info . mysqli_get_server_info . mysqli_get_server_version . mysqli_info . mysqli_init . mysqli_insert_id . mysqli_kill . mysqli_master_query . mysqli_more_results . mysqli_multi_query . mysqli_next_result . mysqli_num_fields . mysqli_num_rows . mysqli_options . mysqli_param_count . mysqli_ping . mysqli_prepare . mysqli_query . mysqli_real_connect . mysqli_real_escape_string . mysqli_real_query . mysqli_report . mysqli_rollback . mysqli_rpl_parse_enabled . mysqli_rpl_probe . mysqli_rpl_query_type . mysqli_select_db . mysqli_send_long_data . mysqli_send_query . mysqli_server_end . mysqli_server_init . mysqli_set_charset . mysqli_set_opt . mysqli_sqlstate . mysqli_ssl_set . mysqli_stat . mysqli_stmt_affected_rows . mysqli_stmt_bind_param . mysqli_stmt_bind_result . mysqli_stmt_close . mysqli_stmt_data_seek . mysqli_stmt_errno . mysqli_stmt_error . mysqli_stmt_execute . mysqli_stmt_fetch . mysqli_stmt_free_result . mysqli_stmt_init . mysqli_stmt_num_rows . mysqli_stmt_param_count . mysqli_stmt_prepare . mysqli_stmt_reset . mysqli_stmt_result_metadata . mysqli_stmt_send_long_data . mysqli_stmt_sqlstate . mysqli_stmt_store_result . mysqli_store_result . mysqli_thread_id . mysqli_thread_safe . mysqli_use_result . mysqli_warning_count
|
8.81.31 mysqli_fetch_array()result->fetch_array()
Retourne une ligne de résultat sous la forme d'un
tableau associatif, d'un tableau indexé, ou les deux
[ Exemples avec mysqli_fetch_array ] PHP 5
Style procédural
mixed
mysqli_fetch_array (
mysqli_result
result
,
int
resulttype
)
Style orienté objet (méthode)
mysqli_result
mixed
fetch_array (
int
resulttype
)
Retourne un tableau qui correspond à la ligne lue ou
FALSE
s'il n'y a
plus de lignes dans le jeu de résultats
result
.
mysqli_fetch_array
est une version étendue de la fonction
mysqli_fetch_row
. En plus d'enregistrer les données
sous forme d'un tableau à indices numériques, elle peut aussi les
enregistrer dans un tableau associatif, en utilisant les noms des champs
comme clés.
| Note | |
Les noms des champs retournés par
cette fonction sont
sensibles à la casse
.
|
| Note | |
Cette fonction définit les champs NULL à la
valeur PHP
NULL
.
|
Si plusieurs colonnes portent le même nom, la dernière colonne aura la
priorité. Pour accéder aux autres colonnes du même nom, vous devez
utiliser l'index numérique, ou faire un alias pour chaque colonne.
Le second argument optionnel
resulttype
est une
constante indiquant quel type de tableau doit être renvoyé à
partir de la ligne de données courante. Les valeurs possibles pour ce
paramètre sont les constantes MYSQLI_ASSOC, MYSQLI_NUM, et MYSQLI_BOTH.
MYSQLI_BOTH est la valeur par défaut de ce paramètre.
En utilisant la constante MYSQLI_ASSOC, cette fonction se comportera comme
la fonction
mysqli_fetch_assoc
, tandis que MYSQLI_NUM
la fera agir comme la fonction
mysqli_fetch_row
.
La constante MYSQLI_BOTH, créera elle un tableau qui sera à la fois
associatif et indexé numériquement.
Retourne un tableau qui correspond à la ligné récupérée ou
NULL
s'il n'y a plus de résultat
ou bien s'il n'y a plus de résultat disponible dans le jeu de résultats.
| Style orienté objet |
<?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Echec de la connexion : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER by ID LIMIT 3"; $result = $mysqli->query($query);
/* Tableau indexé numériquement */ $row = $result->fetch_array(MYSQLI_NUM); printf ("%s (%s)\n", $row[0], $row[1]);
/* Tableau associatif */ $row = $result->fetch_array(MYSQLI_ASSOC); printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]);
/* Tableau associatif et indexé numériquement */ $row = $result->fetch_array(MYSQLI_BOTH); printf ("%s (%s)\n", $row[0], $row["CountryCode"]);
/* Libération des résultats */ $result->close();
/* Fermeture de la connexion */ $mysqli->close(); ?>
|
| Style procédural |
<?php $link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Echec de la connexion : %s\n", mysqli_connect_error()); exit(); }
$query = "SELECT Name, CountryCode FROM City ORDER by ID LIMIT 3"; $result = mysqli_query($link, $query);
/* Tableau indexé numériquement */ $row = mysqli_fetch_array($result, MYSQLI_NUM); printf ("%s (%s)\n", $row[0], $row[1]);
/* Tableau associatif */ $row = mysqli_fetch_array($result, MYSQLI_ASSOC); printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]);
/* Tableau associatif et indexé numériquement */ $row = mysqli_fetch_array($result, MYSQLI_BOTH); printf ("%s (%s)\n", $row[0], $row["CountryCode"]);
/* Libération des résultats */ mysqli_free_result($result);
/* Fermeture de la connexion */ mysqli_close($link); ?>
|
L'exemple ci-dessus va afficher :
Kabul (AFG)
Qandahar (AFG)
Herat (AFG)
mysqli_fetch_assoc
,
mysqli_fetch_row
,
mysqli_fetch_object
,
mysqli_query
et
mysqli_data_seek
.
|