PHP 5.4.31 Released

mysqli_result::fetch_object

mysqli_fetch_object

(PHP 5)

mysqli_result::fetch_object -- mysqli_fetch_objectDevuelve la fila actual de un conjunto de resultados como un objeto

Descripción

Estilo orientado a objetos

object mysqli_result::fetch_object ([ string $class_name = "stdClass" [, array $params ]] )

Estilo por procedimientos

object mysqli_fetch_object ( mysqli_result $result [, string $class_name = "stdClass" [, array $params ]] )

mysqli_fetch_object() devolverá la fila actual del conjunto de resultados como un objeto, donde los atributos del objeto representan los nombres de los campos encontrados en el conjunto de resultados.

Observe que mysqli_fetch_object() establece las propiedades del objeto antes de llamar al constructor del objeto.

Parámetros

result

Sólo estilo por procedimientos: Un conjunto de identificadores de resultados devuelto por mysqli_query(), mysqli_store_result() o mysqli_use_result().

class_name

El nombre de la clase a instanciar, establecer 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 de class_name.

Valores devueltos

Devuelve un objeto con las propiedades de cadena que corresponden a la fila obtenida o NULL si no hay más filas en el conjunto de resultados.

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.

Historial de cambios

Versión Descripción
5.0.0 Se añadió la capacidad para devolver como un objeto diferente.

Ejemplos

Ejemplo #1 Estilo orientado a objetos

<?php
$mysqli 
= new mysqli("localhost""mi_usuario""mi_contraseña""world");

/* comprobar la conexión */
if (mysqli_connect_errno()) {
    
printf("Falló la conexión: %s\n"mysqli_connect_error());
    exit();
}
 
$consulta "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5";

if (
$resultado $mysqli->query($consulta)) {

    
/* obtener el array de objetos */
    
while ($obj $resultado->fetch_object()) {
        
printf ("%s (%s)\n"$obj->Name$obj->CountryCode);
    }

    
/* liberar el conjunto de resultados */
    
$resultado->close();
}

/* cerrar la conexión */
$mysqli->close();
?>

Ejemplo #2 Estilo por procedimientos

<?php
$enlace 
mysqli_connect("localhost""mi_usuario""mi_contraseña""world");

/* comprobar la conexión */
if (mysqli_connect_errno()) {
    
printf("Falló la conexión: %s\n"mysqli_connect_error());
    exit();
}

$consulta "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5";

if (
$resultado mysqli_query($enlace$consulta)) {

    
/* obtener el array asociativo */
    
while ($obj mysqli_fetch_object($resultado)) {
        
printf ("%s (%s)\n"$obj->Name$obj->CountryCode);
    }

    
/* liberar el conjunto de resultados */
    
mysqli_free_result($resultado);
}

/* cerrar la conexión */
mysqli_close($enlace);
?>

El resultado de los ejemplos serían:

Pueblo (USA)
Arvada (USA)
Cape Coral (USA)
Green Bay (USA)
Santa Clara (USA)

Ver también

add a note add a note

User Contributed Notes 6 notes

up
12
Driek
2 years ago
As indicated in the user comments of the mysql_fetch_object, it is important to realize that class fields get values assigned to them BEFORE the constructor is called.
For example;
<?php

class Employee
{
  private
$id;

  public function
__construct($id = 0)
  {
   
$this->id = $id;
  }
}

// some code for creating a database connection... i.e. mysqli object
....
$result = $con->query("select id, name from employees");
$anEmployee = $result->fetch_object("Employee");
?>
will result in the ID being 0 because it is overridden by the constructor. Therefore, it is useful to check if the class field is already set.
I.e.
<?php
class Employee
{
  private
$id;

  public function
__construct($id = 0)
  {
    if (!
$this->id)
    {
      
$this->id = $id
   
}
  }
}
?>
Also note that the fields which will be assigned by fetch_object are case sensitive. If your table has the field "ID", it will result in the class field $ID being set. A simple work-around is to use aliases. I.e. "SELECT *, ID as id FROM myTable"
I hope this helps some people.
up
6
benpptung at tacol dot biz
4 years ago
I don't know why no one talk about this.
fetch_object is very powerful since you can instantiate an Object which has the methods you wanna have.

You can try like this..

<?php
class PowerfulVO extends AbstractWhatEver {

    public
$field1;
    private
$field2; // note : private is ok

   
public function method(){
      
// method in this class
   
}
}

    
$sql = "SELECT * FROM table ..."
    
$mysqli = new mysqli(........);
    
$result = $mysqli->query($sql);
    
$vo = $result->fetch_object('PowerfulVO');
?>

Note : if the field is not defined in the class, fetch_object will add this field for you as public.

The method is very powerful, especially if you want to use a VO design pattern or class mapping feature with Flex Remoting Object( Of course, you need to have ZendAMF or AMFPHP ..framework)

Hope this help and open new possibilities for you
up
0
me at philkershaw dot me
3 months ago
As a best practice, if you intend to use a defined class when using fetching_object(). Put the data obtaining code within a static method of the defined class. Otherwise, wherever you include the file (if not using an autoloader) the data connection will occur whether you want it to or not.

For example:

<?php

class User
{
    public
$name;

    public static function
getUser($id)
    {
       
$conn = new mysqli('localhost', 'username', 'password', 'database');
        if (
$result = $conn->query("SELECT * FROM users WHERE id = {$id} LIMIT 1")) {
            return
$result->fetch_object('User');
           
$result->close();
        }
    }
}
?>

Call the static method to obtain an instance of the User class with your data applied to it.

<?php
$user
= User::getUser('31');
echo
$user->name; // echo's 'Phil'
?>
up
0
Alex
2 years ago
Make sure to specify the full namespace for the "string $class_name" parameter and not a partial one, as it won't find it. For example:

<?php

namespace Root(backslash)FirstLevel
{
    public static function
Test($result)
    {
        return
mysqli_fetch_object($result, 'SecondLevel\\MyClass');
    }
}

?>

... will not work but this will:

<?php

namespace Root(backslash)FirstLevel
{
    public static function
Test($result)
    {
        return
mysqli_fetch_object($result, 'Root\\FirstLevel\\SecondLevel\\MyClass');
    }
}

?>
up
-2
luismacayo at gmail dot com
2 months ago
Hola, tengo una duda en la documentacion de fetch_objetc establece que las propiedades del objeto estan definidas antes de llamar al constructor de la clase a instanciar, pero tengo un script que me da error cuando intento usar las propiedades en el constructor, pero si las puedo usar despues del constructor. En que ando mal?
up
-4
peterbelm at g[oogle]mail dot com
5 years ago
If your SQL code selects columns with empty names like so:

SELECT id as ``...

You will get a fatal error "Cannot access empty property", this took me a while to track down!

Obviously your SQL really shouldn't do that, and should be fixed but I'm going to submit a feature request to ask for a better error message for that.
To Top