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.66 mysqli_real_connect()mysqli->real_connect()Ouvre une connexion à un serveur MySQL[ Exemples avec mysqli_real_connect ] PHP 5
Style procédural
bool
mysqli_real_connect (
mysqli
link
,
string
hostname
,
string
username
,
string
passwd
,
string
dbname
,
int
port
,
string
socket
,
int
flags
)
Style orienté objet (méthode)
mysqli
bool
real_connect (
string
hostname
,
string
username
,
string
passwd
,
string
dbname
,
int
port
,
string
socket
,
int
flags
)
mysqli_real_connect
tente d'établir une connexion avec un serveur MySQL
d'un hôte.
Cette fonction diffère de
mysqli_connect
en ces points :
-
mysqli_real_connect
a besoin d'un objet valide issu de la fonction
mysqli_init
-
Avec la fonction
mysqli_options
, vous pouvez définir différentes
options pour la connexion.
-
Avec les paramètres
flags
, vous pouvez définir
différents options de la connexion :
| Nom |
Description |
|
MYSQLI_CLIENT_COMPRESS
|
Utilise un protocole de compression |
|
MYSQLI_CLIENT_FOUND_ROWS
|
Retourne le nombre de lignes sélectionnées, et non pas le nombre de lignes
affectées |
|
MYSQLI_CLIENT_IGNORE_SPACE
|
Accepte les espaces après les noms de fonctions.
Fait que tous les noms de fonctions sont des mots réservés. |
|
MYSQLI_CLIENT_INTERACTIVE
|
Permet
interactive_timeout
secondes (au lieu de
wait_timeout
secondes) d'inactivité avant de
fermer la connexion
|
|
MYSQLI_CLIENT_SSL
|
Utilise SSL (chiffrage) |
| Note | |
Pour des raisons de sécurité, le flag
MULTI_STATEMENT
n'est pas
supporté en PHP. Si vous voulez exécuter plusieurs requêtes, utilisez la fonction
mysqli_multi_query
.
|
Cette fonction retourne
TRUE
en cas de
succès,
FALSE
en cas d'échec.
| Style orienté objet |
<?php
/* Création d'un objet de connexion, sans être connecté */ $mysqli = mysqli_init();
/* Définition des quelques options de connexion */ $mysqli->options(MYSQLI_INIT_COMMAND, "SET AUTOCOMMIT=0"); $mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5);
/* Connexion au serveur */ $mysqli->real_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(); }
printf ("Connecté : %s\n.", $mysqli->host_info);
$mysqli->close(); ?>
|
| Style procédural |
<?php
/* Création d'un objet de connexion, sans être connecté */ $link = mysqli_init();
/* Définition des quelques options de connexion */ mysqli_options($link, MYSQLI_INIT_COMMAND, "SET AUTOCOMMIT=0"); mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 5);
/* Connexion au serveur */ mysqli_real_connect($link, '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(); }
printf ("Connecté : %s\n.", mysqli_get_host_info($link));
mysqli_close($link); ?>
|
L'exemple ci-dessus va afficher :
Connecté: Localhost via UNIX socket
mysqli_connect
,
mysqli_init
,
mysqli_options
,
mysqli_ssl_set
et
mysqli_close
.
|