Last updated: Fri, 10 Oct 2008

mysql_num_rows

(PHP 4, PHP 5, PECL mysql:1.0)

mysql_num_rows — Get number of rows in result

Description

int mysql_num_rows ( resource $result )

Retrieves the number of rows from a result set. This command is only valid for statements like SELECT or SHOW that return an actual result set. To retrieve the number of rows affected by a INSERT, UPDATE, REPLACE or DELETE query, use mysql_affected_rows().

Parameters

result: The result resource that is being evaluated. This result comes from a call to mysql_query().

Return Values

The number of rows in a result set on success, or FALSE on failure.

Examples

Example #1 mysql_num_rows() example


<?php

$link = mysql_connect("localhost", "mysql_user", "mysql_password");
mysql_select_db("database", $link);

$result = mysql_query("SELECT * FROM table1", $link);
$num_rows = mysql_num_rows($result);

echo "$num_rows Rows\n";

?>

Notes

Note: If you use mysql_unbuffered_query(), mysql_num_rows() will not return the correct value until all the rows in the result set have been retrieved.

Note: For backward compatibility, the following deprecated alias may be used: mysql_numrows()


In preventing the race condition for the SQL_CALC_FOUND_ROWS and FOUND_ROWS() operations, it can become complicated and somewhat kludgy to include the FOUND_ROWS() result in the actual result set, especially for complex queries and/or result ordering. The query gets more complex, you may have trouble isolating/excluding the FOUND_ROWS() result, and mysql_num_rows() will return the number of actual results + 1, all of which makes your code messier and harder to read. However, the race condition is real and must be dealt with.



A alternative and cleaner method is to explicitly lock the table using a WRITE lock (preventing other processes from reading/writing to the table). The downsides I can see are a performance hit, and your mysql user must have lock permissions.



<?php

    // excuse the use of mysqli instead of mysql



    $mysqli->query("LOCK TABLE t WRITE");

    $results = $mysqli->query("SELECT id FROM t LIMIT 0,10");

    $totalNumResults = array_pop($mysqli->query("SELECT FOUND_ROWS()")->fetch_row());

    $mysqli->query("UNLOCK TABLES");

?>



Now you may iterate through the results just like any other result set.

Tom Fejfar
05-Jun-2008 11:56


Improvement to chrisdberry82 at gmail dot com's code:



<?php

$sql = "

SELECT SQL_CALC_FOUND_ROWS 

  '0', z.id

FROM 

  zoom AS z 

LIMIT 

  0,6 

UNION 

  SELECT 

    '1', FOUND_ROWS() 

ORDER BY `0` DESC , RAND()";

?>



You can see, that you can even ORDER the final result anyway you like ;)

Then you can fetch the result like this:

<?php

$res = mysql_query($sql);

$count = mysql_fetch_assoc($res); 

while($row = mysql_fetch_assoc($res)){

 unset($row["0"]); //get rid of the "sorting col"

 print_r($row); //or whatever ;)

}

echo $count["id"]; // the total number of rows

?>



And you got rid of the lousy IFs ;)

qFox
04-Jun-2008 09:08


Please be aware that this bug still applies regarding MYSQL's FOUND_ROWS() and PHP's trace_mode:

http://bugs.php.net/bug.php?id=33021



(It should really be stated as warning...)

timo
27-May-2008 07:03


<?

$strQuery="SELECT * FROM `tabel`";

$strResult = mysql_query($strQuery);

$Aantalvelden = mysql_num_fields($strResult);

$Aantalrijen=mysql_num_rows($strResult);



echo "<table border='1'><tr>";

for($ikolom=0;$ikolom<$Aantalvelden;$ikolom++){

$strVeldnaam = mysql_field_name($strResult,$ikolom);

echo "<td>$strVeldnaam</td>" ;

}

echo "</tr>";



for($ir=0;$irij<$Aantalrijen;$irij++){

echo "<tr>";

for($ikolom=0;$ikolom<$Aantalvelden;$ikolom++){

$strKolomwaarde = mysql_result($strResult,$irij,$ikolom);

echo "<td>$strKolomwaarde</td>";

}

}

echo "</table>";

?>

chrisdberry82 at gmail dot com
25-May-2008 08:46


The following code can wrap it all up in a single query so you don't have to worry about multiple client requests:



$stmtMain = $mysqli->prepare("SELECT SQL_CALC_FOUND_ROWS jobid,title FROM tbljobs 

    LIMIT ?, ? UNION SELECT FOUND_ROWS(),'!!IgnoreCount!!';")



Then iterate through the results with something like:



while ($stmtMain->fetch() && $strResultTitle !="!!IgnoreCount!!") {  

//do stuff

}

($strResultSector == '!!IgnoreCount!!')? $intTotal = $intResultCount : 1;

deaggi at deaggi dot net
20-Aug-2007 10:45


In Reply to the last post: This may not always work correctly, as $object->doesExist would contain a result, not a boolean value. A better way (using the same method) would be using a cast: 



<?php

class Object {

  var $doesExist = false;



  [...]

  function load() {

    $result = mysql_query('...');

    $this->doesExist = (bool) ($res = mysql_fetch_array($result))

    [...]

  }

}

?>



johannes

webmaster dasourcerer net
20-Aug-2007 03:42


In one of my applications, I had to let an object know wether it exists in the database or not. I found a cheap solution w/o the usage of mysql_num_rows():



<?php

class Object {

  var $doesExist = false;



  [...]

  function load() {

    $result = mysql_query('...');

    $this->doesExist = ($res = mysql_fetch_array($result))

    [...]

  }

}

?>

Typer85 at gmail dot com
17-Jul-2007 09:44


A note on the following usage; that suggest to use several MySQL Functions to get the number of Table Records.



You may be familiar with following:



<?php



$sqlQuery = 'Select SQL_CALC_FOUND_ROWS `MyField` From `MyTable` Limit 1;'; 



$sqlQuery_1 = 'Select FOUND_ROWS( );';



?>



I omitted the actual connection to MySQL and the execution of the query, but you get the idea.



I did some tests and on a fairly high traffic web site, one that executes several queries quite often and found that using this combination of MySQL Functions can actually result in wrong results.



For example, assume I have two queries to get the number of Table Records in two different Tables. So in essence, we are executing 4 queries ( 2 queries for each Table ).



If two different requests come in through PHP, your going to run into problems. Note than when I mean request, I mean two different clients requesting your PHP page.



---------------

Request 1:

---------------



Execute: SQL_CALC_FOUND_ROWS On Table 1



---------------

Request 2:

---------------



Execute: SQL_CALC_FOUND_ROWS On Table 2



---------------

Request 1:

---------------



Execute: Select FOUND_ROWS( )



At this point, you see the race condition that occurred. While Request 1 was being executed, Request 2 came in.



At this point Request 1 will return the number of Table Records in Table 2 and not Table 1 as expected!



Why? Because MySQL does not differ between requests. Each query is in a queue waiting its turn. As soon as its turn comes in it will be executed my MySQL.



The MySQL Function Select FOUND_ROWS( ) will return the result of the last SQL_CALC_FOUND_ROWS!



Keep in mind.

eriline dot mees at mail dot ee
27-Dec-2005 06:28


If you have a problem using:

    $res1=mysql_query("select SQL_CALC_FOUND_ROWS * from minutabel LIMIT 20");

    $res2=mysql_query("select FOUND_ROWS()");

($res2 got always "0")

then be sure the php.ini config option "mysql.trace_mode" is "Off".



You can use 

    $vana=ini_set('mysql.trace_mode','Off');

    // do your $res1 and $res2 queries.

    ini_set('mysql.trace_mode',$vana);

for temporary disabling.

Jonas
08-Dec-2005 11:55


A small tip concerning SQL_CALC_FOUND_ROWS and FOUND_ROWS()



Remember that you can us "AS" when working with mysql_fetch_assoc.



$sql="

    SELECT

        FOUND_ROWS() AS `found_rows`;

";

$result = mysql_query($sql);

$myrow = mysql_fetch_assoc($result);

$row_count = $myrow['found_rows'];



echo $row_count;

mancini at nextcode dot org
14-Nov-2005 11:24


here is a really fast mysql_num_rows alternative that makes use of the SELECT FOUND_ROWS() MySQL function , it only reads a single row and it is really helpfull if you are counting multiple tables with thousands of rows



<?php

function get_rows ($table) {

        $temp = mysql_query("SELECT SQL_CALC_FOUND_ROWS * FROM $table LIMIT 1");

        $result = mysql_query("SELECT FOUND_ROWS()");

        $total = mysql_fetch_row($result);

        return $total[0];

}

?>

simon_nuttall at hotmail dot com
12-Nov-2005 05:36


Object oriented version of wil1488 at gmail dot com's comment for counting table rows:

<?php

$result = $mysqli->query("SELECT COUNT(*) as TOTALFOUND from table");

$row_array=$result->fetch_array(MYSQLI_ASSOC);

print($row_array['TOTALFOUND']); 

?>

jonbendi @t stud o ntnu o no
07-Nov-2005 04:16


I find that mysql_num_rows() overlook LIMIT clauses.

For instance:



//table has 700 rows

$command = "SELECT * FROM table LIMIT 500";

$q = mysql_query($command);

$rows = mysql_num_rows($q);



//$rows is 700

wil1488 at gmail dot com
01-Jun-2005 05:53


To use SQL COUNT function, without select the source...



see an example:



<?

//MAKE THE CONNECTION WITH DATABASE



$my_table = mysql_query("SELECT COUNT(*) as TOTALFOUND from table", $link); //EXECUTE SQL CODE

Note: will return the total on TOTALFOUND



print (mysql_result($my_table,0,"TOTALFOUND")); //use the field camp to get the total from your SQL query!

?>



Thanks, good luck.

jsirovic AT g male dot com
19-May-2005 06:34


The reason it's just as slow is that to count that way as it is to fetch, minus the data transfer.



Even when executing a limit query, when you ask it to fetch the number of total rows, it must scan the whole table every time to calculate the count.

alex dot feinberg 4t gm41l
29-Apr-2005 01:56


Re dzver at abv dot bg's note...



I just ran some tests using MySQL Super Smack. Surprisingly, a SELECT * followed by a SELECT COUNT(*) actually was close in speed to a SELECT SQL_CALC_FOUND_ROWS * followed by a SELECT FOUND_ROWS(), but the SQL_CALC_FOUND_ROWS solution was still a bit faster.



Perhaps it varies by table structure? Either way, it might be worth checking which is faster for your application.

liamvictor at gmail dot com
13-Apr-2005 03:22


// this works properly

$query = "SELECT first_name FROM users_tbl WHERE user_id='$user_id' AND password = '$p0' ";

$result = mysql_query($query, $connection) or die ("<p class=err>Error - Query failed: ".mysql_error()."</p>");

$num_rows = mysql_num_rows($result);

if ($num_rows){

    while ($myrow = mysql_fetch_row($result)){

        $first_name = $myrow[0];

        print ("<p>Line:".__LINE__." num_rows:$num_rows first_name:$first_name <br> $query</p>");

    }

}else{

    print ("<p>Password error.</p>");

}



// Here 1 row is returned with a value of 0 when the password is wrong rather than reporting the password error.

$query = "SELECT COUNT(first_name) FROM users_tbl WHERE user_id='$user_id' AND password = '$p0' ";

$result = mysql_query($query, $connection) or die ("<p class=err>Error - Query failed: ".mysql_error()."</p>");

$num_rows = mysql_num_rows($result);

if ($num_rows){

    while ($myrow = mysql_fetch_row($result)){

        $count_first_name = $myrow[0];

        print ("<p>Line:".__LINE__." num_rows:$num_rows count:$count_first_name <br> $query</p>");

    }

}else{

    print ("<p>Password error.</p>");

}

dzver at abv dot bg
20-Feb-2005 03:00


It is faster to run second query "select count(...) from ... ", than adding SQL_CALC_FOUND_ROWS to your first query, and then using select FOUND_ROWS() + mysql_num_rows().

30-Jan-2005 03:18


In response to oran at trifeed dot com:



You are only experiencing this behaviour because you have not given your FOUND_ROWS() result an alias:



$qry = mysql_query ( 'SELECT FOUND_ROWS() AS total' );

$rst = mysql_fetch_array ( $qry, MYSQL_ASSOC );

echo $rst['total'];



Sean :)

oran at trifeed dot com
15-Dec-2004 07:06


For me 



SELECT SQL_CALC_FOUND_ROWS together with

SELECT FOUND_ROWS()



Only worked with the following syntax:

$result = @mysql_query($query);

$resultTotal = @mysql_query("SELECT FOUND_ROWS()");

$res=    mysql_fetch_array($resultTotal);

echo $res['FOUND_ROWS()'];



hope it helped



oran

http://www.trifeed.com

pjoe444 at yahoo dot com
19-Nov-2004 01:38


Re my last entry:



This seems the best workaround to get an 'ordinary' loop going, with possibility of altering output according to row number

(eg laying out a schedule)



$rowno=mysql_num_rows($result);



for ($i=0; $i<mysql_num_rows($result); $i++) {

$row = mysql_fetch_assoc($result);



print "<div class=\"showing\">";

print "<b>".$row['timeon']."-".$row['timeoff']."</b> ".$row['event']."<br />;

if ($i!=$rowno-1) {

    print "other-html-within-sched-here</div>"; 

    }  

else print "end-last-entry-html-here</div>"; 

}  //close loop

pjoe444 at yahoo dot com
19-Nov-2004 12:24


A pity there seems no way of getting the CURRENT  row number that's under iteration in a typical loop, 

such as:

while ($row = mysql_fetch_assoc($result)) { }



After all there is an array of row arrays, as signified by

mysql_num_rows($result):



Say this gives "40 rows" : it would be useful to know when the iteration is on row 39.



The nearest seems to be "data seek":but it connects directly to a

row number eg (from mysql_data_seek page)



for ($i = mysql_num_rows($result) - 1; $i >= 0; $i--) {

   if (!mysql_data_seek($result, $i)) {

       echo "Cannot seek to row $i: " . mysql_error() . "\n";

       continue;

   }



= it still wouldn't solve knowing what row number you're on in an ordinary loop.



One reason for this situation is the php fetch (fetch-a-single-row) construction, without any reasonable FOR loop possibility with row numbers.



Suggestion:

$Rows[$i] possibility where

$i would be the row number



$Rows[$row[], $row[], $row[].....]

             0            1            2     etc



-- the excellent retrieval WITHIN a row ( $row[$i] ),

while certainly more important,  is not matched by 

similar possibilities for rows themselves.



and Count($result) doesnt work of course, $result being a 

mere ticket-identifier...



Peter T

They call me .. "Blaqy"
09-Nov-2004 05:30


Just wanted to add my 2 cents in regards to the mysql functions:

SQL_CALC_FOUND_ROWS

SELECT FOUND_ROWS()



It was difficult finding any information on PHP usage.

What wasn't (or currently isn't) mentioned is that:



$query = "SELECT FOUND_ROWS()";



Will return a 'recordset' .. that holds the 'number of rows', not the actual value.  So the correct usage is:



$result = mysql_query($query);

$total_records = mysql_result($result, 0);



Not:

$total_records = mysql_query($query);



As some of the literature .. may suggest to you.

sam at liddicott dot com
04-Nov-2004 03:40


Some user comments on this page, and some resources including the FAQ at :



http://www.faqts.com/knowledge_base/view.phtml/aid/114/fid/12 suggest using count(*) to count the number of rows



This is not a particularly universal solution, and those who read these comments on this page should also be aware that 



select count(*) may not give correct results if you are using "group by" or "having" in your query, as count(*) is an agregate function and resets eachtime a group-by column changes.



select sum(..) ... left join .. group by ... having ...



can be an alternative to sub-selects in mysql 3, and such queries cannot have the select fields replaced by count(*) to give good results, it just doesn't work.



Sam

aaronp123 att yahoo dott comm
22-Feb-2003 03:40


I may indeed be the only one ever to encounter this - however if you have a myisam table with one row, and you search with valid table and column name for a result where you might expect 0 rows, you will not get 0, you will get 1, which is the myisam optimised response when a table has 0 or one rows.  Under "5.2.4 How MySQL Optimises WHERE Clauses" it reads:



*Early detection of invalid constant expressions. MySQL quickly detects that some SELECT statements are impossible and returns no rows. 



and



*All constant tables are read first, before any other tables in the query. A constant table is: 

1) An empty table or a table with 1 row. 

2) A table that is used with a WHERE clause on a UNIQUE index, or a PRIMARY KEY, where all index parts are used with constant expressions and the index parts are defined as NOT NULL. 



Hopefully this will keep someone from staying up all night with 1146 errors, unless I am completely mistaken in thinking I have this figured out.

webmaster at _NOSPAM_elite-gaming dot com
11-Oct-2002 05:48


The fastest way to get the number of rows in a table is doing this:



$total = mysql_result(mysql_query("SELECT COUNT(id) FROM yourtable"),0);



As long as there are no NULL ids (shouldnt be), it will return the correct rows extremely fast.  If you already used yourtable though, it is faster to use mysql_num_rows() on the result of it.

tac at smokescreen dot org
14-Jan-2002 09:58


MySQL 4.0 supports a fabulous new feature that allows you to get the number of rows that would have been returned if the query did not have a LIMIT clause.  To use it, you need to add SQL_CALC_FOUND_ROWS to the query, e.g.



$sql = "Select SQL_CALC_FOUND_ROWS * from table where state='CA' limit 50";

$result = mysql_query($sql);



$sql = "Select FOUND_ROWS()";

$count_result = mysql_query($sql);



You now have the total number of rows in table that match the criteria.  This is great for knowing the total number of records when browsing through a list.

philip at cornado dot c()m
06-May-2001 09:37


Regarding SQL count(), see this faq :


* http://www.faqts.com/knowledge_base/view.phtml/aid/114/fid/12


Note: If you already have a $result, use mysql_num_rows() on it otherwise use SQL count().  Don't SELECT data just for a count.

add a note

mysql_pconnect

mysql_num_fields