(PHP 4, PHP 5)

mysql_num_rowsВозвращает количество рядов результата запроса


Данное расширение устарело, начиная с версии PHP 5.5.0, и будет удалено в будущем. Используйте вместо него MySQLi или PDO_MySQL. Смотрите также инструкцию MySQL: выбор API и соответствующий FAQ для получения более подробной информации. Альтернативы для данной функции:


int mysql_num_rows ( resource $result )

Возвращает количество рядов результата запроса. Эта команда работает только с запросами SELECT или SHOW, возвращающих актуальный результат запроса. Чтобы получить количество рядов, обработанных функциями INSERT, UPDATE, REPLACE и DELETE, используйте функцию mysql_affected_rows().

Список параметров


Обрабатываемый результат запроса. Этот результат может быть получен с помощью функции mysql_query().

Возвращаемые значения

Количество рядов в результате запроса в случае успеха или FALSE в случае возникновения ошибки.


Пример #1 Пример использования mysql_num_rows()



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

"Получено $num_rows рядов\n";




При использовании mysql_unbuffered_query() функция mysql_num_rows() не вернёт корректного значения до тех пор, пока все ряды не будут получены.


Для обратной совместимости может быть использован следующий устаревший псевдоним: mysql_numrows()

Смотрите также

  • mysql_affected_rows() - Возвращает число затронутых прошлой операцией рядов
  • mysql_connect() - Открывает соединение с сервером MySQL
  • mysql_data_seek() - Перемещает внутренний указатель в результате запроса
  • mysql_select_db() - Выбирает базу данных MySQL
  • mysql_query() - Посылает запрос MySQL


Regarding SQL count(), see this faq :
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.
2001-05-06 14:37:35
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.
2002-01-14 01:58:30
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. 


*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.
2003-02-21 19:40:44
Some user comments on this page, and some resources including the FAQ at : 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.

2004-11-04 07:40:36
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

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";

= 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.

$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
2004-11-18 16:24:24
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)


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
2004-11-18 17:38:40
For me 


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

2004-12-15 11:06:38
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 :)
2005-01-29 19:18:54
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().
2005-02-20 07:00:10
To use SQL COUNT function, without select the source...

see an example:


$my_table mysql_query("SELECT COUNT(*) as TOTALFOUND from table"$link); //EXECUTE SQL CODE
Notewill 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.
2005-05-31 22:53:10
Object oriented version of wil1488 at gmail dot com's comment for counting table rows:
$mysqli->query("SELECT COUNT(*) as TOTALFOUND from table");
2005-11-12 09:36:00
A small tip concerning SQL_CALC_FOUND_ROWS and FOUND_ROWS()

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

        FOUND_ROWS() AS `found_rows`;
$result = mysql_query($sql);
$myrow = mysql_fetch_assoc($result);
$row_count = $myrow['found_rows'];

echo $row_count;
2005-12-08 15:55:06
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:


'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.
2007-07-17 02:44:22
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():

class Object {
$doesExist false;

load() {
$result mysql_query('...');
$this->doesExist = ($res mysql_fetch_array($result))
2007-08-20 08:42:10
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: 

class Object {
$doesExist false;

load() {
$result mysql_query('...');
$this->doesExist = (bool) ($res mysql_fetch_array($result))

2007-08-20 15:45:27
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;
2008-05-25 13:46:57
="SELECT * FROM `tabel`";
$strResult mysql_query($strQuery);
$Aantalvelden mysql_num_fields($strResult);

"<table border='1'><tr>";
$strVeldnaam mysql_field_name($strResult,$ikolom);
"<td>$strVeldnaam</td>" ;

$strKolomwaarde mysql_result($strResult,$irij,$ikolom);
2008-05-27 12:03:50
Improvement to chrisdberry82 at gmail dot com's code:

  zoom AS z 
    '1', FOUND_ROWS() 

You can see, that you can even ORDER the final result anyway you like ;)
Then you can fetch the result like this:
$count mysql_fetch_assoc($res); 
$row mysql_fetch_assoc($res)){
$row["0"]); //get rid of the "sorting col"
print_r($row); //or whatever ;)
$count["id"]; // the total number of rows

And you got rid of the lousy IFs ;)
2008-06-05 16:56:07
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.

// 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.
2008-09-10 15:18:42
Actually I am a little ashamed to be saying this, but I stand corrected about a rather old note I posted on 17-Jul-2007 06:44.

Using SQL_CALC_FOUND_ROWS and FOUND_ROWS( ) will NOT trigger a race condition on MySQL, as that would pretty much defy their entire purpose.

The results for their usage is actually unique per connection session as it is impossible for processes to share anything in PHP. As far as PHP is concerned, each request represents a new connection to MySQL as each request is isolated to its own process.

To simulate this, create the following script:


mysql_connect"localhost" "root" "" );
mysql_select_db"lls" );

if( isset( 
$_GET'Sleep' ] ) ) {
mysql_query"SELECT SQL_CALC_FOUND_ROWS `bid` From `blocks` Limit 1" );
} else {
mysql_query"SELECT SQL_CALC_FOUND_ROWS `aid` From `access` Limit 1" );

if( isset( 
$_GET'Sleep' ] ) ) {
sleep10 ); // Simulate another HTTP request coming in.
$Result mysql_query"SELECT FOUND_ROWS( )" );
print_rmysql_fetch_array$Result ) );

mysql_close( );


Set the connection and query information for something that matches your environment.

Run the script once with the Sleep query string and once again without it. Its important to run them both at the same time. Use Apache ab or something similar, or even easier, just open two browser tabs. For example:


If a race condition existed, the results of the first instance of the script would equal the results of the second instance of the script.

For example, the second instance of the script will execute the following SQL query:


"SELECT SQL_CALC_FOUND_ROWS `aid` From `access` Limit 1" );


This happens while the first instance of the script is sleeping. If a race condition existed, when the first instance of the script wakes up, the result of the FOUND_ROWS( ) it executes should be the number of rows in the SQL query the second instance of the script executed.

But when you run them, this is not the case. The first instance of the script returns the number of rows of its OWN query, which is:


"SELECT SQL_CALC_FOUND_ROWS `bid` From `blocks` Limit 1" );


So it turns out NO race condition exists, and every solution presented to combat this "issue" are pretty much not needed.

Good Luck,
2010-03-18 13:20:07
When mysql.trace_mode = On, SELECT FOUND_ROWS() allway returns 0.  It looks like a bug.

In detail:

If you have a table with 5 rows and issue:


mysql_num_rows() returns 1 as expected.

If you issue "SELECT FOUND_ROWS()" just in sequence, in the same connection resource, it allways returns 0 rather than expected 5.

Just switch mysql.trace_mode to Off and things will work.
2011-03-21 14:43:49
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: 

class Object {
$doesExist false;

load() {
$result mysql_query('...');
$this->doesExist = (bool) ($res mysql_fetch_array($result))
2015-09-23 01:51:35

    Поддержать сайт на родительском проекте КГБ