PDO_MYSQL DSN
I had a problem compiling PHP 5.2.5 with mysqli enabled on Mac OS X. Whether this problem was unique to me I do not no, so I am posting this for anybody else that runs into the same problem. Configure would run right to the end, but I had it telling me something had failed and that it was likely messed up. Upon checking debug.log I noticed this:
dyld: Library not loaded: /usr/local/mysql/lib/mysql/libmysqlclient.15.dylib
Referenced from: /Users/daniel/desktop/php -5.2.5/sapi/cli/php
Reason: image not found
/bin/sh: line 1: /Users/daniel/desktop/php -5.2.5/tmp-php.ini: Permission denied
dyld: Library not loaded: /usr/local/mysql/lib/mysql/libmysqlclient.15.dylib
Referenced from: /Users/daniel/desktop/php -5.2.5/sapi/cli/php
Reason: image not found
make: [test] Error 133 (ignored)
After screwing around for an hour and screaming many profanities at my computer I looked back at the error and noticed:
"/usr/local/mysql/lib/<b>mysql/</b>libmysqlclient.15.dylib
Why it was using this path I do not know, but I headslapped when I realised how simple it was! I solved the problem by creating a link called mysql that linked back on itself:
cd /usr/local/mysql/lib
sudo ln -s ./ mysql
Problem solved! I probably should have figured out why it was doing this instead, but this was easier and saved me from allot more frustration.
XCVI. Extension MySQL améliorée
Introduction
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://dev.mysql.com/doc/.
Une partie de cette documentation provient du manuel officiel MySQL avec la permission de MySQL AB.
Pré-requis
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.3 ou plus de MySQL. Pour les versions plus anciennes, voyez la documentation de l'extension MySQL.
Installation
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 bibliothèque embarquée libmysql distribuée avec PHP ne peut être utilisée. Utilisez à la place les bibliothèques clientes installées par MySQL avec des versions inférieures à la 4.1. Cela forcera PHP à utiliser les bibliothèques du client installées par MySQL pour éviter les conflits.
Configuration à l'exécution
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 | Historique |
|---|---|---|---|
| mysqli.max_links | "-1" | PHP_INI_SYSTEM | Disponible depuis PHP 5.0.0. |
| mysqli.default_port | NULL | PHP_INI_ALL | Disponible depuis PHP 5.0.0. |
| mysqli.default_socket | NULL | PHP_INI_ALL | Disponible depuis PHP 5.0.0. |
| mysqli.default_host | NULL | PHP_INI_ALL | Disponible depuis PHP 5.0.0. |
| mysqli.default_user | NULL | PHP_INI_ALL | Disponible depuis PHP 5.0.0. |
| mysqli.default_pw | NULL | PHP_INI_ALL | Disponible depuis PHP 5.0.0. |
Voici un éclaircissement sur l'utilisation des directives de configuration.
- mysqli.max_links entier
Le nombre maximal de connexions MySQL par processus, incluant les connexions persistantes.
- mysqli.default_port string
Le numéro par défaut de port TCP à utiliser lors de la connexion au serveur si aucun autre port n'est fourni. S'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.
- mysqli.default_socket string
Le nom par défaut de la socket à utiliser lors des connexions locales au serveur si aucun autre nom n'est fourni.
- mysqli.default_host string
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.
- mysqli.default_user string
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.
- mysqli.default_pw string
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.
Classes pré-définies
mysqli
Représente la connexion entre PHP et le serveur MySQL.
Constructeur
mysqli - construit un nouvel objet mysqli
Méthodes
autocommit - Active ou désactive l'auto-commit
change_user - Change l'utilisateur de la connexion
character_set_name - Retourne le jeu de caractères par défaut de la connexion
close - Ferme une connexion ouverte
commit - Valide la transaction courante
connect - Ouvre une nouvelle connexion au serveur MySQL
debug - Effectue des opérations de débogage
dump_debug_info - Affiche les informations de débogage
get_client_info - Retourne la version du client
get_host_info - Retourne le type de connexion utilisé
get_server_info - Retourne la version du serveur MySQL
get_server_version - Retourne la version du serveur MySQL
init - Initialise un objet mysqli
info - Lit les informations concernant la dernière requête
kill - Tente de terminer un thread serveur
multi_query - Exécute une requête multiple
more_results - Vérifie si d'autres résultats existent après une commande multiple
next_result - Lit le prochain résultat d'une commande multiple
options - Modifie des options
ping - Pinge la connexion au serveur ou se reconnecte si elle est morte
prepare - Prépare une requête SQL
query - Exécute une requête SQL
real_connect - Tente de se connecter au serveur MySQL
escape_string - Protège les caractères spéciaux dans une chaîne
rollback - Annule la transaction courante
select_db - Sélectionne la base de données par défaut
set_charset - Définit le jeu de caractères par défaut du client
ssl_set - Configure les paramètres SSL
stat - Lit le statut courant du système
stmt_init - Initialise une commande pour utilisation avec mysqli_stmt_prepare
store_result - Lit le jeu de résultat de la dernière requête
thread_safe - Indique si la sécurité du thread est activée
use_result - Transfère un résultat non-bufferisé
Propriétés
affected_rows - Lit le nombre de lignes affectées par la dernière opération
client_info - Retourne la version cliente de MySQL en tant que chaîne de caractères
client_version - Retourne la version cliente de MySQL en tant qu'entier
errno - Retourne le code d'erreur du dernier appel de fonction
error - Retourne le message d'erreur du dernier appel de fonction
field_count - Retourne le nombre de colonnes de la dernière commande
host_info - Retourne une chaîne décrivant le type de connexion utilisé
info - Lit les informations sur la dernière commande exécutée
insert_id - Retourne le dernier identifiant généré
protocol_version - Retourne la version du protocole MySQL utilisé
server_info - Retourne une chaîne de caractères qui représente le numéro de version du serveur
server_version - Retourne le numéro de version du serveur en tant qu'entier
sqlstate - Retourne une chaîne contenant le code d'erreur SQLSTATE
thread_id - Retourne l'identifiant de thread de la connexion courante
warning_count - Retourne le nombre d'alertes générées durant l'exécution de la dernière commande SQL
mysqli_stmt
Représente une commande préparée.
Méthodes
bind_param - Associe des variables à une commande préparée
bind_result - Associe des variables à un résultat
close - Termine une commande préparée
data_seek - Place le curseur à une ligne arbitraire dans un jeu de résultat
execute - Exécute une commande préparée
fetch - Lit une ligne de résultat dans des variables associées
free_result - Libère le résultat de la mémoire
prepare - Prépare une commande SQL
reset - annule une commande SQL
result_metadata - Lit un résultat d'une commande préparée
send_long_data - Envoie les données par bloc
store_result - Bufferise complètement le résultat d'une commande préparée
Propriétés
affected_rows - Retourne le nombre de lignes affectées par la dernière commande SQL
errno - Retourne le code d'erreur de la dernière commande
error - Retourne le message d'erreur de la dernière commande
field_count - Retourne le nombre de colonnes dans un jeu de résultats
id - Retourne l'identifiant de la requête
insert_id - Retourne la valeur générée pour une colonne AUTO_INCREMENT par la requête préparée
num_rows - Retourne le nombre de lignes dans le jeu de résultats
param_count - Retourne le nombre de paramètres nécessaires pour une commande préparée
sqlstate - Retourne une chaîne contenant le code d'erreur SQLSTATE de la dernière commande
mysqli_result
Représente le résultat retourné par le serveur.
Méthodes
close - Termine le jeu de résultat MySQL
data_seek - Déplace le pointeur de lignes de résultat
fetch_array - Lit une ligne de résultat dans un tableau associatif ou numérique
fetch_assoc - Lit une ligne de résultat dans un tableau associatif
fetch_field - Lit les informations de colonnes dans un résultat
fetch_fields - Lit les informations de toutes les colonnes d'un résultat
fetch_field_direct - Lit les informations de colonne
fetch_object - Lit une ligne de résultat dans un objet
fetch_row - Lit une ligne de résultat dans un tableau numérique
field_seek - Place le pointeur de résultat à un offset valide
free_result - Libère le résultat de la mémoire
Propriétés
current_field - Retourne la position du pointeur de résultat
field_count - Retourne le nombre de champs du résultat
lengths - Retourne un tableau avec les tailles de colonnes
num_rows - Retourne le nombre de lignes du résultat
type - Retourne MYSQLI_STORE_RESULT ou MYSQLI_USE_RESULT
Constantes pré-définies
Tableau 2. Constantes MySQLi
| Nom | Description |
|---|---|
| MYSQLI_READ_DEFAULT_GROUP (entier) | Lit les options dans le groupe `my.cnf' ou dans le fichier spécifié par MYSQLI_READ_DEFAULT_FILE |
| MYSQLI_READ_DEFAULT_FILE (entier) | Lit les options dans le fichier spécifié, plutôt que dans my.cnf |
| MYSQLI_OPT_CONNECT_TIMEOUT (entier) | Durée d'expiration de la connexion, en secondes |
| MYSQLI_OPT_LOCAL_INFILE (entier) | Active la commande LOAD LOCAL INFILE |
| MYSQLI_INIT_COMMAND (entier) | Commande à exécuter lors de la connexion au serveur MySQL. Cette commande sera exécutée automatiquement lors de la reconnexion au serveur. |
| MYSQLI_CLIENT_SSL (entier) | Utilise le protocole SSL (chiffrement). Cette option ne doit pas être activée par un programme : elle doit être activée en interne, par la bibliothèque MySQL. |
| MYSQLI_CLIENT_COMPRESS (entier) | Utilise le protocole compressé. |
| MYSQLI_CLIENT_INTERACTIVE (entier) | Permet interactive_timeout secondes (au lieu de wait_timeout secondes) d'inactivité avant de fermer la connexion. La valeur de la variable wait_timeout du client prendra la valeur de interactive_timeout. |
| MYSQLI_CLIENT_IGNORE_SPACE (entier) | Permet les espaces après un nom de fonction. Cela fait de tous les noms de fonctions, des mots réservés. |
| MYSQLI_CLIENT_NO_SCHEMA (entier) | Interdit la syntaxe db_name.tbl_name.col_name. |
| MYSQLI_CLIENT_MULTI_QUERIES (entier) | |
| MYSQLI_STORE_RESULT (entier) | Pour les résultats mis en tampon. |
| MYSQLI_USE_RESULT (entier) | Pour les résultats non-mis en tampon. |
| MYSQLI_ASSOC (entier) | Les colonnes sont retournées dans le tableau, avec leurs noms comme index. |
| MYSQLI_NUM (entier) | Les colonnes sont retournées dans le tableau, avec leurs numéros comme index. |
| MYSQLI_BOTH (entier) | Les colonnes sont retournées dans le tableau, avec leurs noms et leurs numéros comme index. |
| MYSQLI_NOT_NULL_FLAG (entier) | Indique qu'un champ est défini comme NOT NULL |
| MYSQLI_PRI_KEY_FLAG (entier) | Le champ est une clé primaire. |
| MYSQLI_UNIQUE_KEY_FLAG (entier) | Le champ est un index unique. |
| MYSQLI_MULTIPLE_KEY_FLAG (entier) | Le champ fait partie d'un index. |
| MYSQLI_BLOB_FLAG (entier) | Le champ est de type BLOB |
| MYSQLI_UNSIGNED_FLAG (entier) | Le champ est de type UNSIGNED |
| MYSQLI_ZEROFILL_FLAG (entier) | Le champ est de type ZEROFILL |
| MYSQLI_AUTO_INCREMENT_FLAG (entier) | Le champ est de type AUTO_INCREMENT |
| MYSQLI_TIMESTAMP_FLAG (entier) | Le champ est de type TIMESTAMP |
| MYSQLI_SET_FLAG (entier) | Le champ est de type SET |
| MYSQLI_NUM_FLAG (entier) | Le champ est de type NUMERIC |
| MYSQLI_PART_KEY_FLAG (entier) | Le champ fait partie d'un index multiple |
| MYSQLI_GROUP_FLAG (entier) | Le champ fait partie de la clause GROUP BY |
| MYSQLI_TYPE_DECIMAL (entier) | Le champ est de type DECIMAL |
| MYSQLI_TYPE_NEWDECIMAL (entier) | Le champ est de type DECIMAL ou NUMERIC (MySQL 5.0.3 et supérieur) |
| MYSQLI_TYPE_BIT (entier) | Le champ est de type BIT (MySQL 5.0.3 et supérieur) |
| MYSQLI_TYPE_TINY (entier) | Le champ est de type TINYINT |
| MYSQLI_TYPE_SHORT (entier) | Le champ est de type INT |
| MYSQLI_TYPE_LONG (entier) | Le champ est de type INT |
| MYSQLI_TYPE_FLOAT (entier) | Le champ est de type FLOAT |
| MYSQLI_TYPE_DOUBLE (entier) | Le champ est de type DOUBLE |
| MYSQLI_TYPE_NULL (entier) | Le champ est de type DEFAULT NULL |
| MYSQLI_TYPE_TIMESTAMP (entier) | Le champ est de type TIMESTAMP |
| MYSQLI_TYPE_LONGLONG (entier) | Le champ est de type BIGINT |
| MYSQLI_TYPE_INT24 (entier) | Le champ est de type MEDIUMINT |
| MYSQLI_TYPE_DATE (entier) | Le champ est de type DATE |
| MYSQLI_TYPE_TIME (entier) | Le champ est de type TIME |
| MYSQLI_TYPE_DATETIME (entier) | Le champ est de type DATETIME |
| MYSQLI_TYPE_YEAR (entier) | Le champ est de type YEAR |
| MYSQLI_TYPE_NEWDATE (entier) | Le champ est de type DATE |
| MYSQLI_TYPE_ENUM (entier) | Le champ est de type ENUM |
| MYSQLI_TYPE_SET (entier) | Le champ est de type SET |
| MYSQLI_TYPE_TINY_BLOB (entier) | Le champ est de type TINYBLOB |
| MYSQLI_TYPE_MEDIUM_BLOB (entier) | Le champ est de type MEDIUMBLOB |
| MYSQLI_TYPE_LONG_BLOB (entier) | Le champ est de type LONGBLOB |
| MYSQLI_TYPE_BLOB (entier) | Le champ est de type BLOB |
| MYSQLI_TYPE_VAR_STRING (entier) | Le champ est de type VARCHAR |
| MYSQLI_TYPE_STRING (entier) | Le champ est de type CHAR |
| MYSQLI_TYPE_GEOMETRY (entier) | Le champ est de type GEOMETRY |
| MYSQLI_NEED_DATA (entier) | Il reste des variables à relier |
| MYSQLI_NO_DATA (entier) | Il n'y a plus de variables à relier |
| MYSQLI_DATA_TRUNCATED (integer) | Les données ont été tronquées. Disponible depuis PHP 5.1.0 et MySQL 5.0.5. |
Exemples
Tous les exemples dans la documentation MySQLI utilisent la base de données "world" provenant de MySQL AB. La base de données "world" peut être trouvée ici : http://dev.mysql.com/get/Downloads/Manual/world.sql.gz/from/pick
- Table des matières
- mysqli_affected_rows -- Retourne le nombre de lignes affectées par la dernière opération MySQL
- mysqli_autocommit -- Active ou désactive le mode auto-commit
- mysqli_bind_param -- Alias de mysqli_stmt_bind_param()
- mysqli_bind_result -- Alias de mysqli_stmt_bind_result()
- mysqli_change_user -- Change l'utilisateur de la connexion spécifiée
- mysqli_character_set_name -- Retourne le jeu de caractères courant pour la connexion
- mysqli_client_encoding -- Alias de mysqli_character_set_name()
- mysqli_close -- Ferme une connexion
- mysqli_commit -- Valide la transaction courante
- mysqli_connect_errno -- Retourne le code d'erreur de la connexion MySQL
- mysqli_connect_error -- Retourne le message d'erreur de connexion MySQL
- mysqli_connect -- Ouvre une connexion à un serveur MySQL
- mysqli_data_seek -- Déplace le pointeur interne de résultat
- mysqli_debug -- Effectue des actions de débogage
- mysqli_disable_reads_from_master -- Désactive la lecture depuis le maître
- mysqli_disable_rpl_parse -- Désactive le parseur RPL
- mysqli_dump_debug_info -- Ecrit les informations de débogage dans le log
- mysqli_embedded_connect -- Ouvre une connexion avec un serveur MySQL intégré
- mysqli_enable_reads_from_master -- Active la lecture depuis le maître
- mysqli_enable_rpl_parse -- Active le parseur RPL
- mysqli_errno -- Retourne un code d'erreur pour la dernière commande MySQL
- mysqli_error -- Retourne une chaîne décrivant la dernière erreur
- mysqli_escape_string -- Alias de mysqli_real_escape_string()
- mysqli_execute -- Alias de mysqli_stmt_execute()
- mysqli_fetch_array -- Retourne une ligne de résultat sous la forme d'un tableau associatif, d'un tableau indexé, ou les deux
- mysqli_fetch_assoc -- Récupère une ligne de résultat sous forme de tableau associatif
- mysqli_fetch_field_direct -- Récupère les données métas d'un champ unique
- mysqli_fetch_field -- Retourne le prochain champ dans le jeu de résultats
- mysqli_fetch_fields -- Retourne un tableau d'objets représentant les champs dans le résultat
- mysqli_fetch_lengths -- Retourne la longueur des colonnes de la ligne courante du jeu de résultats
- mysqli_fetch_object -- Retourne la ligne courante d'un jeu de résultat sous forme d'objet
- mysqli_fetch_row -- Récupère une ligne de résultat sous forme de tableau indexé
- mysqli_fetch -- Alias de mysqli_stmt_fetch()
- mysqli_field_count -- Retourne le nombre de colonnes pour la dernière requête
- mysqli_field_seek -- Déplace le pointeur de résultat sur le champ spécifié
- mysqli_field_tell -- Retourne la position du champ courant dans un pointeur de résultat
- mysqli_free_result -- Libère la mémoire associée à un résultat
- mysqli_get_client_info -- Retourne une chaîne contenant la version du client MySQL
- mysqli_get_client_version -- Lit les informations du client MySQL
- mysqli_get_host_info -- Retourne une chaîne contenant le type de connexion utilisée
- mysqli_get_metadata -- Alias de mysqli_stmt_result_metadata()
- mysqli_get_proto_info -- Retourne la version du protocole MySQL utilisé
- mysqli_get_server_info -- Retourne la version du serveur MySQL
- mysqli_get_server_version -- Retourne un entier représentant la version du serveur MySQL
- mysqli_info -- Retourne des informations à propos de la dernière requête exécutée
- mysqli_init -- Initialise MySQLi et retourne une ressource à utiliser avec mysqli_real_connect()
- mysqli_insert_id -- Retourne l'identifiant automatiquement généré par la dernière requête
- mysqli_kill -- Demande au serveur de terminer un thread MySQL
- mysqli_master_query -- Force l'exécution d'une requête sur le maître dans une configuration maître/esclave (master/slave)
- mysqli_more_results -- Vérifie s'il y a d'autres jeux de résultats MySQL disponibles
- mysqli_multi_query -- Exécute une requête MySQL multiple
- mysqli_next_result -- Prépare le prochain résultat d'une requête multiple
- mysqli_num_fields -- Retourne le nombre de champs dans un résultat
- mysqli_num_rows -- Retourne le nombre de lignes dans un résultat
- mysqli_options -- Définit les options
- mysqli_param_count -- Alias de mysqli_stmt_param_count()
- mysqli_ping -- Ping la connexion au serveur et reconnecte si elle n'existe plus
- mysqli_prepare -- Prépare une requête SQL pour l'exécution
- mysqli_query -- Exécute une requête sur la base de données
- mysqli_real_connect -- Ouvre une connexion à un serveur MySQL
- mysqli_real_escape_string -- Protège les caractères spéciaux d'une chaîne pour l'utiliser dans une requête SQL, en prenant en compte le jeu de caractères courant de la connexion
- mysqli_real_query -- Exécute une requête SQL
- mysqli_report -- Active ou désactive les fonctions de rapport interne
- mysqli_rollback -- Annule la transaction courante
- mysqli_rpl_parse_enabled -- Vérifie si le parseur RPL est activé
- mysqli_rpl_probe -- Sonde le RPL
- mysqli_rpl_query_type -- Retourne le type de requête RPL
- mysqli_select_db -- Sélectionne une base de données par défaut pour les requêtes
- mysqli_send_long_data -- Alias de mysqli_stmt_send_long_data()
- mysqli_send_query -- Envoie la requête et retourne
- mysqli_server_end -- Eteint le serveur embarqué
- mysqli_server_init -- Initialise le serveur MySQL intégré
- mysqli_set_charset -- Définit le jeu de caractères par défaut du client
- mysqli_set_opt -- Alias de mysqli_options()
- mysqli_sqlstate -- Retourne l'erreur SQLSTATE de la dernière opération MySQL
- mysqli_ssl_set -- Utilisée pour établir une connexion sécurisée avec SSL
- mysqli_stat -- Obtient le statut courant du système
- mysqli_stmt_affected_rows -- Retourne le nombre total de lignes modifiées, effacées ou insérées par la dernière requête
- mysqli_stmt_bind_param -- Lie des variables à une requête MySQL
- mysqli_stmt_bind_result -- Lie des variables à un jeu de résultats
- mysqli_stmt_close -- Ferme une requête préparée
- mysqli_stmt_data_seek -- Déplace le pointeur de résultat MySQL
- mysqli_stmt_errno -- Retourne un code erreur pour la dernière requête
- mysqli_stmt_error -- Retourne une description de la dernière erreur de traitement
- mysqli_stmt_execute -- Exécute une requête préparée
- mysqli_stmt_fetch -- Lit des résultats depuis une requête MySQL préparée dans des variables liées
- mysqli_stmt_free_result -- Libère le résultat MySQL de la mémoire
- mysqli_stmt_init -- Initialise une commande MySQL
- mysqli_stmt_num_rows -- Retourne le nombre de lignes d'un résultat MySQL
- mysqli_stmt_param_count -- Retourne le nombre de paramètres d'une commande MySQL
- mysqli_stmt_prepare -- Prépare une requête SQL pour l'exécution
- mysqli_stmt_reset -- Annule une requête préparée
- mysqli_stmt_result_metadata -- Retourne les méta-données de préparation de requête MySQL
- mysqli_stmt_send_long_data -- Envoie des données MySQL par paquets
- mysqli_stmt_sqlstate -- Retourne le code SQLSTATE de la dernière opération MySQL
- mysqli_stmt_store_result -- Récupère un jeu de résultats depuis une requête préparée
- mysqli_store_result -- Transfère un jeu de résultats à partir de la dernière requête
- mysqli_thread_id -- Retourne l'identifiant du thread pour la connexion courante
- mysqli_thread_safe -- Indique si le thread safety est donné ou non
- mysqli_use_result -- Initialise la récupération d'un jeu de résultats
- mysqli_warning_count -- Retourne le nombre d'avertissements générés par la dernière requête
add a note
User Contributed Notes
Extension MySQL améliorée
Daniel Sowden
08-Apr-2008 03:56
jeff at coderforlife dot com
12-Mar-2008 11:37
It looks as though mysqli persistent connections will be available by default in PHP 6.
The source code for the mysqli PHP 6 module is here in the mysql SVN:
http://svn.mysql.com/svnpublic/
php-mysqlnd/trunk/php6/ext/mysqli/mysqli.c
It has a ton a of references to persistence, and the ini setting for enabling persistence is true by default.
To bad this isn't be integrated into the latest PHP 5 builds.
swong
10-Nov-2007 07:48
If you want to extend mysqli and establish an connection with SSL authentication, the followings may be useful.
(note: not all php-mysqli supports mysqli_ssl_set())
class DataAccess extends mysqli
{
function __construct(
$hostname, $username, $passwd=null, $dbname=null,
$port=null, $socket=null, $flags=null,
$privatekey=null, $certificate=null, $caCertificate=null)
{
$link = parent::init();
if ($privatekey!=null && $certificate!=null && $caCertificate!=null)
$link->ssl_set($privatekey, $certificate, $caCertificate,
dirname($caCertificate),NULL);
parent::__construct($hostname, $username,
$passwd, $dbname, $port, $socket);
}
.....
}
marcus at synchromedia dot co dot uk
03-Oct-2007 09:27
For those having trouble getting MySQLi to work, there is another way that is set to become much more common:
http://dev.mysql.com/downloads/connector/php-mysqlnd/
This is the new MySQL native driver which has been backported from PHP6 and replaces MySQLi with a version that doesn't require any local MySQL client libraries or binaries.
smurf at smurf dot noris dot de
03-Jul-2007 05:45
Yay. No more persistent connections. I am NOT happy about that.
As soon as you get more than 250 requests per second (ever been slashdotted?) there will not be any more free TCP ports for talking to the database server, because each TCP port will be kept in TIME_WAIT for two minutes and there are only 30000 ports in the local range.
And that's not the only problem. There's also more than twice the packet rate on the network link to the database. Frankly I'd like my CPUs to spend their cycles on something producive. :-/
dan+php dot net-note-about-mysqli at obluda dot cz
27-Sep-2006 02:15
Hints for upgrading PHP code from MySQL to MySQLi:
Note - MySQLi doesn't support persistent connection. If you need it, you must implement it by self. This case is not covered in this note.
First - change all occurences of MYSQL_ to MYSQLI_ and mysql_ to mysqli_
Most of changes is required because mysqli* functions has no implicit link argument, so it need to be added explicitly if not present already. Even if it is present, most mysqli_ functions require 'link' argument as first (and mandatory) argument instead of last (and optional) as required by mysql_ functions. So, we need to change order of arguments at least.
So, you need to found names of all mysql_ functions used in your code, check if it need reoder of parameters or add the link parameter. Only *_connect() functions need review, but most scripts contain only few connect call.
If you use functions deprecated in mysql, then may not be impemented in mysqli. Those need to be reimplemented if required. In most case, it's very simple. In advance, PHP script written by carefull programer should not contain deprecated calls, so it's not problem in most cases at all.
Most of scripts I ported from mysql_ to mysqli_ can be converted by simple sed script followed by *_connect() function call review only. Especially when when programmer doesn't used the link as implicit argument and doesn't use deprecated functions the conversion of PHP source is trivial task and converted script work with no problem.
Special handling of some functions:
mysql_connect(),mysql_pconnect()
-----------------------------------------
Call with 3 or less parameters need not to be modified.
4-parameters call - delete 4th parameter as mysqli is always non-persistent
5-parameters - replace it by sequence of mysqli_init();mysqli_options();mysqli_real_connect()
mysql_create_db(), mysql_drop_db(), mysql_list_dbs(), mysql_db_name(),mysql_list_fields(), mysql_list_processes(), mysql_list_tables(), mysql_db_query(),mysql_table_name()
------------------------------------------
mysqli variant doesn't exist (those functions has been deprecated even in mysql_) but it's easy to reimplement each of it. Use apropropriate SQL command followed by standard loop for processing query results where applicable. If no connection to server yet you need to use explicit mysqli_connect call.
mysql_result()
-----------------
mysqli variant doesn't exist. Use one of mysqli_fetch_* variant (depending of type of mysql_result() third argument)
mysql_unbuffered_query()
-----------------
mysqli variant doesn't exist. Use mysqli_real_query()
chris <at> gerlt.net
07-Jul-2006 11:47
For installing mysqli extension after PHP is installed on a Linux ubuntu ( or other linux distro with apt-get such as debian, etc...):
# apt-get install php5-mysqli
NOTE: after install, you need to reboot apache
# apache2ctl graceful
Docey
08-Jun-2006 11:11
It should be noticed that mysqli does not support persistent
connections, so do not bother about implementing them
unless you got a million hits an hour on your website.
also about using both mysql and mysqli, i want to note
that under windows the best approach is to load either
mysql or mysqli at runtime not both.
i know that under php5 this is deprecated but it seems
to work fine. i used the same appoach under debian-linux
and seems to work aswell. just don't know for the
speed cost. maybe someone can benchmark this out.
just my 2 eurocents.
kronicade@yahoo
09-Mar-2006 11:42
Same problem, no solution. I'm running Solaris sparc with mysql 4.1.12. I've tried every config command I can think of and have modified my PATH as follows:
setenv PATH /usr/ccs/bin:
/usr/local/bin:
/usr/local/ipw/bin:
/usr/local/ipw/contrib/bin:
/sbin:/usr/sbin:
/usr/bin:
/usr/bin/X11:
/usr/ucb:
/usr/openwin/bin
./configure '--prefix=/usr/local/php' '--localstatedir=/usr/local' '--mandir=/usr/share/man' '--with-mysqli=/usr/local/mysql/bin/mysql_config' '--includedir=/usr/lib' '--enable-shared=max' '--enable-module=most' '--with-imap=/usr/local/imap' '--with-imap-ssl=/usr/local/ssl' '--with-apxs2=/usr/local/apache2/bin/apxs' '--enable-fastcgi' '--enable-mbstring=all' '--with-zlib-dir=/usr' '--with-openssl=/usr/local/ssl'
I think it's a compatibility issue with the version of mysql running 64-bit.
-Andrew
Michael <mstclaire at myprintflow dot com>
12-Jan-2006 07:10
I was running into some random issues using the myqli extension with MySQL 5 on Mac OS X.
I discovered that when I compiled php 5 with the --with-mysqli flag, it was building php with the pre-installed MySQL 4 client libraries.
Heres how it fixed it to build php with the correct MySQL client libraries.
----------------
I had installed the binary version of MySQL 5 from MySQL AB. It installs everything in the default location /usr/local/mysql, which is fine. The MySQL version that comes with OS X ( v.4.x, depends on your OS X version ) installs the mysql_config help utility at /usr/bin/mysql_config. When php configs, it uses that one by default, inheritently using the wrong MySQL client libs.
No problem I thought, I just changed the --with-mysqli flag to --with-mysqli=/usr/local/mysql/bin/mysql_config ( or sudo find / -name mysql_config to find yours ). Nope, php throws a build error because it can't find the matching libraries. Hmmm...
So i tested /usr/local/mysql/bin/mysql_config --version, and I am shown my most current MySQL install. The problem is that the binary editions for OS X DO NOT include the shared libs ( libmysqlclient.dylib ). Oh no, I did not want to compile MySQL myself, not because I don't know how, but because MySQL AB does not recommend it, and for good reasons. Trust me, I've found out the hard way.
So what do you do? Download the source version of MySQL 5 that matches my binary version.
Configure MySQL:
./configure --enable-shared ( it's listed as ON as default, but I want to be sure )
Build MySQL:
make ( requires Developer Tools, but you knew that )
DO NOT make install !!! I repeat, DO NOT make install unless you really wish to overwrite your binary verions, which is not a good idea. ( You can configure MySQL with the --without-server flag, but I want to be certain I don't mess up )
Ok, almost done. Go to the lib directory in your MySQL build location and go to the invisible directory, .libs . There you will find your shared libraries, namely libmysqlclient.15.0.0.dylib.
Copy this to your /usr/local/mysql/lib directory. Now do the following from the lib directory:
ln -s libmysqlclient.15.0.0.dylib libmysqlclient.15.dylib
ln -s libmysqlclient.15.0.0.dylib libmysqlclient.dylib
mkdir mysql
cd mysql
ln -s ../libmysqlclient.15.0.0.dylib libmysqlclient.15.0.0.dylib
ln -s ../libmysqlclient.15.0.0.dylib libmysqlclient.15.dylib
ln -s ../libmysqlclient.15.0.0.dylib libmysqlclient.dylib
Now you can build your php with the correct library. After you build, check your phpinfo(); to validate the client version under the mysqli section. When I restarted Apache, it originally couldn't find my libraries, thus the /usr/local/mysql/lib/mysql directory.
Hope this helped.
Brad Marsh
09-Nov-2005 07:54
Notes for FreeBSD 6.0-RELEASE
MySQL 5.0.15 (source), Apache 2.0.55 (port), PHP 5.0.15 (source) - I used sources for MySQL and PHP because I could not get it all to work together using only ports.
First MySQL:
==================================
cd /usr/local/src
tar zxvf /path/to/mysql-5.0.15.tar.gz
./configure --prefix=/usr/local/mysql --localstatedir=/usr/local/mysql/data --enable-assembler --with-mysqld-ldflags=-all-static CFLAGS="-O3" CXX=gcc CXXFLAGS="-O3 -felide-constructors -fno-exceptions -fno-rtti"
make
make install
Apache:
==================================
MAKE SURE YOUR PORTS ARE UP-TO-DATE - use cvsup
cd /usr/ports/www/apache2
make
make install
make clean
PHP:
==================================
cd /usr/local/src
tar zxvf /path/to/php-5.0.5.tar.gz
./configure --with-xml --with-zlib --with-mysql=/usr/local/mysql --with-mysqli=/usr/local/mysql/bin/mysql_config --with-apxs2=/usr/local/sbin/apxs
EXTRA STEP for mysql and mysqli extensions at the same time:
See this forum thread: http://www.kofler.cc/forum/forumthread.php?rootID=3571
In the PHP Makefile, I changed the line (note all the duplicates)
EXTRA_LIBS = -lcrypt -lcrypt -lmysqlclient -lz -lm -lxml2 -lz -liconv -lm -lxml2 -lz -liconv -lm -lmysqlclient -lz -lcrypt -lm -lxml2 -lz -liconv -lm -lcrypt -lxml2 -lz -liconv -lm -lcrypt
to
EXTRA_LIBS = -lcrypt -lmysqlclient -lz -lm -lxml2 -liconv
make
make install
Hope this helps somebody...
arjen at mysql dot com
04-Aug-2005 01:26
John Coggeshall wrote a PHP5 ext/mysqli compatibility script for applications that still use the old ext/mysql functions. This prevents the hassle of trying to have both the mysql and mysqli extensions loaded in PHP5, which can be tricky.
The script is at:
http://www.coggeshall.org/oss/mysql2i/
Andrei Nazarenko
22-Feb-2005 11:21
If you are having trouble compiling PHP5 with MySQLi support on Linux and getting a message:
"configure: error: wrong mysql library version or lib not found"
and the config.log shows an error about -lnss_files being not found, here is the solution:
edit your mysql_config file and *REMOVE* all "-lnss_files" AND "-lnss_dns" entries from it.
After that PHP should not complain anymore.
neil
10-Feb-2005 02:15
I have spent far too much time finding this answer:
Since PHP5 many many people are having installation problems. I found many apps were broken when I upgraded to version 5. I tried to install mysql and mysqli and had problems.
Here's the solution:
After doing:
./configure --with-mysql=/path/to/mysql_config --with-mysqli=/path/to/mysql_config
do this:
"
if you want to use both the old mysql and the new mysqli interface, load the Makefile into your editor and search for the line beginning with EXTRA_LIBS; it includes -lmysqlclient twice; remove the second instance
"
then you can:
make
make install
......
Please note: the mysql-dev must be installed or you won't have a mysql_config anywhere. I installed the mysql-dev rpm
Further note: the information about the Makefile's duplicate instances of "-libmysqlclient" came from Michael Kofler. Thanks should be directed to him. He gives more details at the following link:
http://www.kofler.cc/forum/forumthread.php?rootID=3571
php at arwin dot net
02-Feb-2005 03:32
For those having trouble compiling with both --with-mysql AND --with-mysqli, I found a solution at this URL:
http://bugs.php.net/bug.php?id=29860&edit=1
rjanson at msn dot com writes:
OK, finally an answer!
I checked Makefile and found the following line:
EXTRA_LIBS = -lcrypt -lcrypt -lmysqlclient -lpng -lz -lz -lresolv -lm
-ldl -lnsl -lxml2 -
lz -lm -lxml2 -lz -lm -lmysqlclient -lcrypt -lnsl -lm -lz -lnss_files
-lnss_dns -lresolv -lnss_files
-lnss_dns -lresolv -lxml2 -lz -lm -lcrypt -lxml2 -lz -lm -lcrypt
By removing one of the -lmysqlclient entries on this line I was able to
successfully make and make install with both mysql and mysqli. As
confirmed by phpInfo().
I'm not sure why the other libs have multiple entries and don't cause
make to crash.
Yair Lapin
10-Nov-2004 07:28
I successed to install php support for a mysql 4.1.7 database after several attempts because the instructions are not clear.
I have a server with linux SuSe 9 enterprise with apache 1.3.31. I installed mysql from rpm files, i installed php 4.3.9 as dynamic library. this version database needs its own client library else the mysql functions in php will not work.
configuration must be as following:
./configure --with-msqli=/usr/bin/mysql_config --with-mysql=/usr --with-apxs=/usr/local/apache/bin/apxs
Must be installed in your machine the correct mysql librery:
MySQL-devel-4.1.7-0
MySQL-shared-4.1.7-0
nathansquires at pacbell dot net
13-Sep-2004 10:44
If you want to build php with both the Mysql and mysqli extensions, make sure your mysql distribution comes with shared libraries or build mysql yourself with shared libraries. With only static mysql libraries the compile process will fail.
severin dot kacianka at aon dot at
12-Aug-2004 03:55
I tryed Marco Kaiser's way of getting both mysql_* and mysqli_*, but it failed for me. However I could get it working this way:
First of all I installed the MySQL 4.1.3 binary disribution acourding to the manual. Then I simply passed these ./configure arguments:
--with-mysql=/path/to/mysql4.1.3
--with-mysqli=/path/to/mysql4.1.3/bin/mysql_config
This enabled both, the mysql_* and mysqli_* functions.
Severin Kacianka
philip
17-Jun-2004 03:51
A couple tutorials on the subject of mysqli:
* http://www.zend.com/php5/articles/php5-mysqli.php
* http://www.zend.com/php5/articles/php5-mysqli2.php
phoeniks[at]nm[dot]ru
08-Apr-2004 03:21
Here is a little sample to do fast hierarchical queries using new prepared statements
<?php
// Root - lowest start element
// Top - most top element
// stack - array for storing info
function tree_rise($root, &$stack, $top = 0) {
$mysqli = mysqli_connect('localhost', 'root');
$top = (int)$top;
$stmt = mysqli_prepare($mysqli, "SELECT id, pid, title FROM news.strg WHERE id = ? LIMIT 1");
mysqli_stmt_bind_param($stmt, "i", $root);
mysqli_stmt_execute($stmt);
mysqli_stmt_store_result($stmt);
mysqli_bind_result($stmt, $id, $root, $title);
while (mysqli_fetch($stmt)) {
$stack[$id] = $title;
if ($root != $top && !is_null($root)) {
mysqli_stmt_execute($stmt);
mysqli_stmt_store_result($stmt);
}
}
return count($stack);
}
?>