Cette extension était obsolète en PHP 5.5.0, et a été supprimée en PHP 7.0.0. À la place, vous pouvez utiliser l'extension MySQLi ou l'extension PDO_MySQL. Voir aussi MySQL : choisir une API du guide. Alternatives à cette fonction :
Pour compiler, utiliser tout simplement l'option de configuration
--with-mysql[=DIR]
où le paramètre optionnel [DIR] pointe vers
le dossier d'installation de MySQL.
Bien que cette extension MySQL soit compatible avec MySQL 4.1.0 et supérieur, elle ne supporte pas les fonctionnalités supplémentaires que cette version fournit. Pour cela, utiliser plutôt l'extension MySQLi.
Pour installer l'extension mysqli en même temps que l'extension mysql, il faut utiliser la même bibliothèque client afin d'éviter les conflits.
Note : [DIR] est le chemin vers la bibliothèque cliente
MySQL (en-têtes et bibliothèques), qui peut être
téléchargée depuis le site de » MySQL.
| PHP Version | Défaut | Options de configuration : mysqlnd | Options de configuration : libmysqlclient |
Historique |
|---|---|---|---|---|
| 4.x.x | libmysqlclient | Indisponible | --without-mysql pour désactiver | MySQL est actif par défaut, les bibliothèques clientes MySQL sont incluses en interne |
| 5.0.x, 5.1.x, 5.2.x | libmysqlclient | Indisponible | --with-mysql=[DIR] | MySQL n'est pas actif par défaut, et les bibliothèques clientes MySQL ne sont plus incluses en interne |
| 5.3.x | libmysqlclient | --with-mysql=mysqlnd | --with-mysql=[DIR] | mysqlnd est maintenant disponible |
| 5.4.x | mysqlnd | --with-mysql | --with-mysql=[DIR] | mysqlnd est maintenant incluse par défaut |
MySQL n'est plus activé par défaut, ainsi, la bibliothèque php_mysql.dll doit être activée dans le php.ini. De plus, PHP doit avoir accès à la bibliothèque cliente MySQL. Un fichier nommé libmysql.dll est inclus dans la distribution de PHP pour Windows et pour que PHP puisse discuter avec MySQL, ce fichier doit être disponible dans le PATH du système Windows. Consulter la FAQ intitulée "Où dois-je ajouter mon répertoire PHP à la variable PATH sous Windows ?" pour plus d'informations sur la réalisation de cela. Néanmoins, le fait de copier le fichier libmysql.dll dans le répertoire système de Windows fonctionne (car le dossier système est par défaut dans le PATH système), mais cela n'est pas du tout recommandé.
Pour activer n'importe quelle extension PHP (comme
php_mysql.dll), la directive PHP
extension_dir doit être définie
et doit pointer vers le dossier où sont stockées les extensions PHP.
Consulter également le
manuel d'installation sous Windows.
Par exemple, voici une valeur possible pour la directive
extension_dir en PHP 5 :
c:\php\ext
Note: Si lorsqu'on démarre le serveur web une erreur similaire à ceci apparaît :
"Unable to load dynamic library './php_mysql.dll'", c'est parce que php_mysql.dll et/ou libmysql.dll n'ont pû être trouvés par le système.
Le driver MySQL natif est activé par défaut. Incluez php_mysql.dll, mais libmysql.dll n'est plus nécessaire, ni utilisé.
Des crashes et des problèmes de démarrage de PHP peuvent être rencontrés lorsqu'on charge cette fonction en même temps que l'extension recode. Voir l'extension recode pour plus de détails.
Note: Si on a besoin d'autres jeux de caractères que celui par défaut (latin), il faut installer la bibliothèque externe libmysqlclient (non fournie), compilée avec ce jeu de caractères.