# mysql_fetch_object

(PHP 4, PHP 5)

mysql_fetch_object — Recupera una fila de resultados como un objeto

Advertencia

Esta extensión fue declarada obsoleta en PHP 5.5.0 y eliminada en PHP 7.0.0. En su lugar debería utilzarse las extensiones MySQLi o PDO_MySQL. Véase también la guía MySQL: elegir una API. Las alternativas a esta función son:

- mysqli_fetch_object()
- PDOStatement::fetch() con `mode` como `PDO::FETCH_OBJ`

### Descripción

mysql_fetch_object(resource `$result`, string `$class_name` = ?, array `$params` = ?): object

Devuelve un objeto con propiedades que corresponden a la fila recuperada y mueve el puntero interno hacia delante.

### Parámetros

`result`

  El resultado resource que está siendo evaluado. Este resultado proviene de una llamada a mysql_query().

`class_name`

  El nombre de la clase donde instanciar, configurar las propiedades y devolver. Si no se especifica, se devuelve un objeto stdClass.

`params`

  Un array opcional de parámetros para pasar al constructor de los objetos `class_name`.

### Valores devueltos

Devuelve un object con propiedades de tipo string que se corresponden con la fila recuperada, o `false` si no quedan más filas.

### Ejemplos

Ejemplo #1 Ejemplo de mysql_fetch_object()

`<?php
mysql_connect("nombre_anfitrión", "usuario", "contraseña");
mysql_select_db("mibd");
$resultado = mysql_query("select * from mitabla");
while ($fila = mysql_fetch_object($resultado)) {
echo $fila->id_usuario;
echo $fila->nombre_completo;
}
mysql_free_result($resultado);
?>`

Ejemplo #2 Ejemplo de mysql_fetch_object()

`<?php
class foo {
public $nombre;
}
mysql_connect("nombre_anfitrión", "usuario", "contraseña");
mysql_select_db("mibd");
$resultado = mysql_query("select nombre from mitabla limit 1");
$objeto = mysql_fetch_object($resultado, 'foo');
var_dump($objeto);
?>`

### Notas

> Nota: Rendimiento

> En cuestión de velocidad, la función es idéntica a mysql_fetch_array(), y casi tan rápida como mysql_fetch_row() (la diferencia es insignificante).

> Nota:

> mysql_fetch_object() es similar a mysql_fetch_array(), con una diferencia: se devuelve un objeto, en lugar de un array. Indirectamente, esto significa que se puede acceder a los datos únicamente mediante los nombres de los campos, y no mediante sus índices (los números son ilegales como nombres de propiedades).

> Nota: Los nombres de los campos devueltos por esta función son sensibles a mayúsculas y minúsculas.

> Nota: Esta función define campos NULOS al valor `null` de PHP.

### Ver también

- mysql_fetch_array() - Recupera una fila de resultados como un array asociativo, un array numérico o como ambos
- mysql_fetch_assoc() - Recupera una fila de resultados como un array asociativo
- mysql_fetch_row() - Obtiene una fila de resultados como un array numérico
- mysql_data_seek() - Mueve el puntero de resultados interno
- mysql_query() - Enviar una consulta MySQL