L'extension mysqli vous permet d'accéder aux fonctionnalités fournies par MySQL 4.1 et plus. Plus d'informations sur le serveur de bases de données MySQL peuvent être trouvées sur http://www.mysql.com/
La documentation de MySQL peut être trouvée sur http://www.mysql.com/documentation/.
| Avertissement |
Ce module est EXPERIMENTAL. Cela signifie que le comportement de ces fonctions, leurs noms et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez ce module à vos risques et périls. |
Pour faire fonctionner ces fonctions, vous devez compiler PHP avec le support de l'extension MySQLi.
Note : L'extension MySQLi est conçue pour fonctionner avec la version 4.1 ou plus de MySQL. Pour les versions plus anciennes, voyez la documentation de l'extension mysql.
Pour installer l'extension mysqli pour PHP, utilisez l'option de configuration --with-mysqli=mysql_config_path où mysql_config_path représente l'endroit où se trouve le programme mysql_config qui accompagne les versions de MySQL supérieures à la 4.1. Désactivez aussi l'extension standard MySQL (qui est activée par défaut) en utilisant aussi l'option de configuration --without-mysql. Si vous voulez installer l'extension standard mysql en même temps que l'extension mysqli, la librairie embarquée libmysql distribuée avec PHP ne peut être utilisée. Utilisez à la place les librairies clientes installées par MySQL avec des versions inférieures à la 4.1. Cela forcera PHP à utiliser les librairies du client installées par MySQL pour éviter les conflits.
Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.
Tableau 1. Options de configuration MySQLi
| Nom | Par défaut | Modifiable |
|---|---|---|
| mysqli.max_links | "-1" | PHP_INI_SYSTEM |
| mysqli.default_port | NULL | PHP_INI_ALL |
| mysqli.default_socket | NULL | PHP_INI_ALL |
| mysqli.default_host | NULL | PHP_INI_ALL |
| mysqli.default_user | NULL | PHP_INI_ALL |
| mysqli.default_pw | NULL | PHP_INI_ALL |
Voici un éclaircissement sur l'utilisation des directives de configuration.
Le nombre maximal de connexions MySQL par processus, incluant les connexions persistantes.
Le numéro par défaut de port TCP à utiliser lors de la connexion au serveur si aucun autre port n'est fourni. Si il n'est pas défini, le port sera obtenu à partir de la variable d'environnement MYSQL_TCP_PORT, l'entrée mysql-tcp dans /etc/services ou la constante de compilation MYSQL_PORT, dans cet ordre. Win32 n'utilisera que la constante MYSQL_PORT.
Le nom par défaut de la socket à utiliser lors des connexions locales au serveur si aucun autre nom n'est fourni.
Le serveur par défaut à utiliser lors de la connexion à un serveur si aucun autre hôte n'est fourni. Ne s'applique pas avec le safe mode.
Le nom d'utilisateur par défaut à utiliser lors de la connexion à un serveur si aucun autre nom n'est fourni. Ne s'applique pas avec le safe mode.
Le mot de passe par défaut à utiliser lors de la connexion à un serveur si aucun autre mot de passe n'est fourni. Ne s'applique pas avec le safe mode.
Tableau 2. Constantes MySQLi
| Nom | Description |
|---|---|
| MYSQLI_READ_DEFAULT_GROUP (integer) | |
| MYSQLI_READ_DEFAULT_FILE (integer) | |
| MYSQLI_OPT_CONNECT_TIMEOUT (integer) | |
| MYSQLI_OPT_LOCAL_INFILE (integer) | |
| MYSQLI_INIT_COMMAND (integer) | |
| MYSQLI_CLIENT_SSL (integer) | |
| MYSQLI_CLIENT_COMPRESS (integer) | |
| MYSQLI_CLIENT_INTERACTIVE (integer) | |
| MYSQLI_CLIENT_IGNORE_SPACE (integer) | |
| MYSQLI_CLIENT_NO_SCHEMA (integer) | |
| MYSQLI_CLIENT_MULTI_QUERIES (integer) | |
| MYSQLI_STORE_RESULT (integer) | |
| MYSQLI_USE_RESULT (integer) | |
| MYSQLI_ASSOC (integer) | |
| MYSQLI_NUM (integer) | |
| MYSQLI_BOTH (integer) | |
| MYSQLI_NOT_NULL_FLAG (integer) | |
| MYSQLI_PRI_KEY_FLAG (integer) | |
| MYSQLI_UNIQUE_KEY_FLAG (integer) | |
| MYSQLI_MULTIPLE_KEY_FLAG (integer) | |
| MYSQLI_BLOB_FLAG (integer) | |
| MYSQLI_UNSIGNED_FLAG (integer) | |
| MYSQLI_ZEROFILL_FLAG (integer) | |
| MYSQLI_AUTO_INCREMENT_FLAG (integer) | |
| MYSQLI_TIMESTAMP_FLAG (integer) | |
| MYSQLI_SET_FLAG (integer) | |
| MYSQLI_NUM_FLAG (integer) | |
| MYSQLI_PART_KEY_FLAG (integer) | |
| MYSQLI_GROUP_FLAG (integer) | |
| MYSQLI_TYPE_DECIMAL (integer) | |
| MYSQLI_TYPE_TINY (integer) | |
| MYSQLI_TYPE_SHORT (integer) | |
| MYSQLI_TYPE_LONG (integer) | |
| MYSQLI_TYPE_FLOAD (integer) | |
| MYSQLI_TYPE_DOUBLE (integer) | |
| MYSQLI_TYPE_NULL (integer) | |
| MYSQLI_TYPE_TIMESTAMP (integer) | |
| MYSQLI_TYPE_LONGLONG (integer) | |
| MYSQLI_TYPE_INT24 (integer) | |
| MYSQLI_TYPE_DATE (integer) | |
| MYSQLI_TYPE_TIME (integer) | |
| MYSQLI_TYPE_DATETIME (integer) | |
| MYSQLI_TYPE_YEAR (integer) | |
| MYSQLI_TYPE_NEWDATE (integer) | |
| MYSQLI_TYPE_ENUM (integer) | |
| MYSQLI_TYPE_SET (integer) | |
| MYSQLI_TYPE_TINY_BLOB (integer) | |
| MYSQLI_TYPE_MEDIUM_BLOB (integer) | |
| MYSQLI_TYPE_LONG_BLOB (integer) | |
| MYSQLI_TYPE_BLOB (integer) | |
| MYSQLI_TYPE_VAR_STRING (integer) | |
| MYSQLI_TYPE_STRING (integer) | |
| MYSQLI_TYPE_CHAR (integer) | |
| MYSQLI_TYPE_INTERVAL (integer) | |
| MYSQLI_TYPE_GEOMETRY (integer) | |
| MYSQLI_BIND_STRING (integer) | |
| MYSQLI_BIND_INT (integer) | |
| MYSQLI_BIND_DOUBLE (integer) | |
| MYSQLI_BIND_SEND_DATA (integer) | |
| MYSQLI_RPL_MASTER (integer) | |
| MYSQLI_RPL_SLAVE (integer) | |
| MYSQLI_RPL_ADMIN (integer) | |
| MYSQLI_NEED_DATA (integer) | |
| MYSQLI_NO_DATA (integer) | |
| MYSQLI_PR_REPORT_STDERR (integer) | |
| MYSQLI_PR_REPORT_PORT (integer) | |
| MYSQLI_PR_REPORT_FILE (integer) |
| Précédent | Sommaire | Suivant |
| mysql_unbuffered_query | Niveau supérieur | mysqli_affected_rows |