Last updated: Fri, 20 Nov 2009

mysqli_result::fetch_object

mysqli_fetch_object

(PHP 5)

mysqli_result::fetch_object -- mysqli_fetch_object — Returns the current row of a result set as an object

Description

Object oriented style (method):

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

Procedural style:

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

The mysqli_fetch_object() will return the current row result set as an object where the attributes of the object represent the names of the fields found within the result set.

Parameters

result: Procedural style only: A result set identifier returned by mysqli_query(), mysqli_store_result() or mysqli_use_result().
class_name: The name of the class to instantiate, set the properties of and return. If not specified, a stdClass object is returned.
params: An optional array of parameters to pass to the constructor for class_name objects.

Return Values

Returns an object with string properties that corresponds to the fetched row or NULL if there are no more rows in resultset.

Note: Field names returned by this function are case-sensitive.

Note: This function sets NULL fields to the PHP NULL value.

Changelog

Version	Description
5.0.0	Added the ability to return as a different object.

Examples

Example #1 Object oriented style


<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* check connection */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}
 
$query = "SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5";

if ($result = $mysqli->query($query)) {

    /* fetch object array */
    while ($obj = $result->fetch_object()) {
        printf ("%s (%s)\n", $obj->Name, $obj->CountryCode);
    }

    /* free result set */
    $result->close();
}

/* close connection */
$mysqli->close();
?>

Example #2 Procedural style


<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

/* check connection */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

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

if ($result = mysqli_query($link, $query)) {

    /* fetch associative array */
    while ($obj = mysqli_fetch_object($result)) {
        printf ("%s (%s)\n", $obj->Name, $obj->CountryCode);
    }

    /* free result set */
    mysqli_free_result($result);
}

/* close connection */
mysqli_close($link);
?>

The above example will output:

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

mysqli_fetch_array() - Fetch a result row as an associative, a numeric array, or both
mysqli_fetch_assoc() - Fetch a result row as an associative array
mysqli_fetch_row() - Get a result row as an enumerated array
mysqli_query() - Performs a query on the database
mysqli_data_seek() - Adjusts the result pointer to an arbitary row in the result

add a note User Contributed Notes
mysqli_result::fetch_object

benpptung at tacol dot biz
09-Aug-2009 03:04


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

peterbelm at g[oogle]mail dot com
18-Aug-2008 02:10


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.

add a note

mysqli_result::fetch_row

mysqli_result::fetch_fields