(PHP 4, PHP 5)
mysql_fetch_object — Retourne une ligne de résultat MySQL sous la forme d'un objet
Avertissement
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 :
- mysqli_fetch_object()
- PDOStatement::fetch(PDO::FETCH_OBJ)
Description
mysql_fetch_object(resource
$result, string
$class_name = ?, array
$params = ?): object
Liste de paramètres
-
result
-
La ressource de résultat qui vient d'être évaluée.
Ce résultat vient de l'appel à la fonction mysql_query().
-
class_name
-
Le nom de la classe à instancier, définit les propriétés et retourne.
SI ce paramètre n'est pas spécifié, un objet stdClass
sera retourné.
-
params
-
Un tableau de paramètres à passer au constructeur pour les objets
class_name.
Valeurs de retour
Retourne un objet avec les propriétés qui correspondent à la ligne
récupérée, ou false s'il n'y a plus de lignes.
Exemples
Exemple #1 Exemple avec mysql_fetch_object()
<?php
mysql_connect("hostname", "user", "password");
mysql_select_db("mydb");
$result = mysql_query("select * from mytable");
while ($row = mysql_fetch_object($result)) {
echo $row->user_id;
echo $row->fullname;
}
mysql_free_result($result);
?>
Exemple #2 Exemple avec mysql_fetch_object()
<?php
class foo {
public $name;
}
mysql_connect("hostname", "user", "password");
mysql_select_db("mydb");
$result = mysql_query("select name from mytable limit 1");
$obj = mysql_fetch_object($result, 'foo');
var_dump($obj);
?>
Notes
Note:
Performance
Concernant la vitesse, mysql_fetch_object() est
aussi rapide que mysql_fetch_array() et presque
aussi rapide que mysql_fetch_row() (la
différence est insignifiante).
Note:
mysql_fetch_object() est identique à
mysql_fetch_array(), à la
différence qu'elle retourne un objet à la place
d'un tableau. Vous pourrez ainsi accéder aux valeurs
des champs par leur nom, mais plus par leur offset (les
nombres ne sont pas des noms MySQL).
Note: Les noms des champs retournés par
cette fonction sont sensibles à la casse.
Note: Cette fonction définit les champs NULL à la
valeur PHP null.
Voir aussi
- mysql_fetch_array() - Retourne une ligne de résultat MySQL sous la forme d'un tableau
associatif, d'un tableau indexé, ou les deux
- mysql_fetch_assoc() - Lit une ligne de résultat MySQL dans un tableau associatif
- mysql_fetch_row() - Retourne une ligne de résultat MySQL sous la forme d'un tableau
- mysql_data_seek() - Déplace le pointeur interne de résultat MySQL
- mysql_query() - Envoie une requête à un serveur MySQL