mysql_unbuffered_query
(PHP 4 >= 4.0.6, PHP 5)
mysql_unbuffered_query — Ex�cute une requ�te SQL sans mobiliser les r�sultats MySQL
Description
mysql_unbuffered_query() envoie la requ�te SQL query au serveur MySQL identifi� par link_identifier , sans pr�parer les r�sultats pour la lecture, comme le fait mysql_query(). D'une part, cela r�duit consid�rablement la consommation de m�moire par MySQL, lorsque les requ�tes g�n�rent des r�sultats de grande taille. D'autre part, vous pourrez utiliser les r�sultats d�s que la premi�re ligne aura �t� lue : pas besoin d'attendre que la requ�te ait compl�tement �t� ex�cut�e. Lorsque vous utilisez de multiples connexions � MySQL, vous devez sp�cifier le param�tre optionnel link_identifier .
Liste de param�tres
- query
-
Une requ�te SQL
- link_identifier
-
La connexion MySQL. S'il n'est pas sp�cifi�, la derni�re connexion ouverte avec la fonction mysql_connect() sera utilis�e. Si une telle connexion n'est pas trouv�e, la fonction tentera d'ouvrir une connexion, comme si la fonction mysql_connect() avait �t� appel�e sans argument. Si aucune connexion n'est trouv�e ou �tablie, une alerte E_WARNING est g�n�r�e.
Valeurs de retour
Pour les requ�tes SELECT, SHOW, DESCRIBE ou EXPLAIN, mysql_unbuffered_query() retourne une ressource en cas de succ�s, ou FALSE si une erreur survient.
Pour les autres types de requ�tes, UPDATE, DELETE, DROP, etc, mysql_unbuffered_query() retourne TRUE en cas de succ�s ou FALSE si une erreur survient.
Notes
Note: L'int�r�t de mysql_unbuffered_query() est temp�r� par une limitation : mysql_num_rows() et mysql_data_seek() ne fonctionne pas sur une ressource retourn�e par mysql_unbuffered_query(). Vous devez aussi lire tous les r�sultats d'une premi�re requ�te ex�cut�e avec mysql_unbuffered_query(), avant de pouvoir en ex�cuter une autre.