mysqli_fetch_array
Выбирает одну строку данных из набора результатов и возвращает её в виде массива. Каждый последующий вызов этой функции будет возвращать следующую строку в наборе результатов или null , если строк больше нет.
Помимо хранения данных в числовых индексах массива результатов, функция также может сохранять данные в ассоциативных индексах, используя имена полей набора результатов в качестве ключей.
Если два и более столбца результата имеют одинаковое имя, последний столбец будет иметь приоритет и перезапишет любые предыдущие данные. В таких ситуациях для доступа к данным всех столбцов с одинаковыми именами лучше пользоваться обычными массивами, индексированными номерами столбцов.
Замечание: Имена полей, возвращаемые этой функцией являются зависимыми от регистра.
Замечание: Эта функция устанавливает NULL-поля в значение null PHP.
Список параметров
Этот необязательный параметр принимает значение константы, которая указывает на тип массива, в который требуется поместить данные. Возможные значения параметра: MYSQLI_ASSOC , MYSQLI_NUM или MYSQLI_BOTH .
При использовании константы MYSQLI_ASSOC функция будет вести себя идентично mysqli_fetch_assoc() , а при MYSQLI_NUM идентично функции mysqli_fetch_row() . При задании MYSQLI_BOTH функция создаст один массив, включающий атрибуты обоих вариантов.
Возвращаемые значения
Возвращает массив, представляющий выбранную строку, null , если в наборе результатов больше нет строк или false в случае возникновения ошибки.
Примеры
Пример #1 Пример использования mysqli_result::fetch_array()
mysqli_report ( MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT );
$mysqli = new mysqli ( «localhost» , «my_user» , «my_password» , «world» );
$query = «SELECT Name, CountryCode FROM City ORDER BY ID LIMIT 3» ;
$result = $mysqli -> query ( $query );
/* числовой массив */
$row = $result -> fetch_array ( MYSQLI_NUM );
printf ( «%s (%s)\n» , $row [ 0 ], $row [ 1 ]);
/* ассоциативный массив */
$row = $result -> fetch_array ( MYSQLI_ASSOC );
printf ( «%s (%s)\n» , $row [ «Name» ], $row [ «CountryCode» ]);
/* ассоциативный и числовой массивы */
$row = $result -> fetch_array ( MYSQLI_BOTH );
printf ( «%s (%s)\n» , $row [ 0 ], $row [ «CountryCode» ]);
mysqli_report ( MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT );
$mysqli = mysqli_connect ( «localhost» , «my_user» , «my_password» , «world» );
$query = «SELECT Name, CountryCode FROM City ORDER by ID LIMIT 3» ;
$result = mysqli_query ( $mysqli , $query );
/* числовой массив */
$row = mysqli_fetch_array ( $result , MYSQLI_NUM );
printf ( «%s (%s)\n» , $row [ 0 ], $row [ 1 ]);
/* ассоциативный массив */
$row = mysqli_fetch_array ( $result , MYSQLI_ASSOC );
printf ( «%s (%s)\n» , $row [ «Name» ], $row [ «CountryCode» ]);
/* ассоциативный и числовой массивы */
$row = mysqli_fetch_array ( $result , MYSQLI_BOTH );
printf ( «%s (%s)\n» , $row [ 0 ], $row [ «CountryCode» ]);
Результат выполнения данных примеров:
Kabul (AFG) Qandahar (AFG) Herat (AFG)
Смотрите также
- mysqli_fetch_assoc() — Выбирает следующую строку из набора результатов и помещает её в ассоциативный массив
- mysqli_fetch_column() — Получает один столбец из следующей строки набора результатов
- mysqli_fetch_row() — Выбирает следующую строку из набора результатов и помещает её в обычный массив
- mysqli_fetch_object() — Выбирает следующую строку из набора результатов в виде объекта
- mysqli_query() — Выполняет запрос к базе данных
- mysqli_data_seek() — Перемещает указатель результата на выбранную строку
User Contributed Notes
mysqli_fetch_assoc
Выбирает одну строку данных из набора результатов и возвращает её в виде ассоциативного массива. Каждый последующий вызов этой функции будет возвращать следующую строку в наборе результатов или null , если строк больше нет.
Если у двух и более столбцов в наборе результатов одинаковое имя, последний столбец будет иметь приоритет и перезапишет любые предыдущие данные. Для доступа к нескольким столбцам с одинаковым именем можно использовать функцию mysqli_fetch_row() для выборки массива с числовым индексом или в списке выбора SQL-запроса можно использовать псевдонимы, чтобы задать столбцам разные имена.
Замечание: Имена полей, возвращаемые этой функцией являются зависимыми от регистра.
Замечание: Эта функция устанавливает NULL-поля в значение null PHP.
Список параметров
Возвращаемые значения
Возвращает ассоциативный массив, представляющий выбранную строку, где каждое свойство представляет имя столбца набора результатов, null , если в наборе результатов больше нет строк или false в случае возникновения ошибки.
Примеры
Пример #1 Пример использования mysqli_result::fetch_assoc()
mysqli_report ( MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT );
$mysqli = new mysqli ( «localhost» , «my_user» , «my_password» , «world» );
$query = «SELECT Name, CountryCode FROM City ORDER BY ID DESC» ;
$result = $mysqli -> query ( $query );
/* извлечение ассоциативного массива */
while ( $row = $result -> fetch_assoc ()) printf ( «%s (%s)\n» , $row [ «Name» ], $row [ «CountryCode» ]);
>
mysqli_report ( MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT );
$mysqli = mysqli_connect ( «localhost» , «my_user» , «my_password» , «world» );
$query = «SELECT Name, CountryCode FROM City ORDER BY ID DESC» ;
$result = mysqli_query ( $mysqli , $query );
/* извлечение ассоциативного массива */
while ( $row = mysqli_fetch_assoc ( $result )) printf ( «%s (%s)\n» , $row [ «Name» ], $row [ «CountryCode» ]);
>
Результатом выполнения данных примеров будет что-то подобное:
Pueblo (USA) Arvada (USA) Cape Coral (USA) Green Bay (USA) Santa Clara (USA)
Пример #2 Сравнение использования mysqli_result iterator и mysqli_result::fetch_assoc()
mysqli_result можно повторить с помощью foreach. Результирующий набор всегда будет повторяться с первой строки, независимо от текущей позиции.
mysqli_report ( MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT );
$mysqli = new mysqli ( «localhost» , «my_user» , «my_password» , «world» );
$query = ‘SELECT Name, CountryCode FROM City ORDER BY ID DESC’ ;
// Используем итераторы
$result = $mysqli -> query ( $query );
foreach ( $result as $row ) printf ( «%s (%s)\n» , $row [ «Name» ], $row [ «CountryCode» ]);
>
// Не используем итераторы
$result = $mysqli -> query ( $query );
while ( $row = $result -> fetch_assoc ()) printf ( «%s (%s)\n» , $row [ «Name» ], $row [ «CountryCode» ]);
>
Результатом выполнения данного примера будет что-то подобное:
Pueblo (USA) Arvada (USA) Cape Coral (USA) Green Bay (USA) Santa Clara (USA) ================== Pueblo (USA) Arvada (USA) Cape Coral (USA) Green Bay (USA) Santa Clara (USA)
Смотрите также
- mysqli_fetch_array() — Выбирает следующую строку из набора результатов и помещает её в ассоциативный массив, обычный массив или в оба
- mysqli_fetch_column() — Получает один столбец из следующей строки набора результатов
- mysqli_fetch_row() — Выбирает следующую строку из набора результатов и помещает её в обычный массив
- mysqli_fetch_object() — Выбирает следующую строку из набора результатов в виде объекта
- mysqli_query() — Выполняет запрос к базе данных
- mysqli_data_seek() — Перемещает указатель результата на выбранную строку
User Contributed Notes 6 notes
I often like to have my results sent elsewhere in the format of an array (although keep in mind that if you just plan on traversing through the array in another part of the script, this extra step is just a waste of time).
This is my one-liner for transforming a mysqli_result set into an array.
$sql = new MySQLi ( $host , $username , $password , $database );
$result = $sql -> query ( «SELECT * FROM ` $table `;» );
for ( $set = array (); $row = $result -> fetch_assoc (); $set [] = $row );
print_r ( $set );
?>
Outputs:
Array
(
[0] => Array
(
[id] => 1
[field2] => a
[field3] => b
),
[1] => Array
(
[id] => 2
[field2] => c
[field3] => d
)
)
I use other variations to adapt to the situation, i.e. if I am selecting only one field:
$sql = new MySQLi ( $host , $username , $password , $database );
$result = $sql -> query ( «SELECT `field2` FROM ` $table `;» );
for ( $set = array (); $row = $result -> fetch_assoc (); $set [] = $row [ ‘field2’ ]);
print_r ( $set );
?>
Outputs:
Array
(
[0] => a
[1] => c
)
Or, to make the array associative with the primary index (code assumes primary index is the first field in the table):
$sql = new MySQLi ( $host , $username , $password , $database );
$result = $sql -> query ( «SELECT * FROM ` $table `;» );
for ( $set = array (); $row = $result -> fetch_assoc (); $set [ array_shift ( $row )] = $row );
print_r ( $set );
?>
Outputs:
Array
(
[1] => Array
(
[field2] => a
[field3] => b
),
[2] => Array
(
[field2] => c
[field3] => d
)
)
If you were used to using code like this:
while( false !== ( $row = mysql_fetch_assoc ( $result )))
<
//.
>
?>
You must change it to this for mysqli:
while( null !== ( $row = mysqli_fetch_assoc ( $result )))
<
//.
>
?>
The former will cause your script to run until max_execution_time is reached.
There is a difference between MariaDB and MySQL(>5.4) whether the input parameter (mysqli object) has data or is empty (it comes from a previus query).
-MariaDB: you get an exception:
Fatal error: Uncaught TypeError: mysqli_fetch_assoc(): Argument #1 ($result) must be of type mysqli_result
-MySQL: you can continue, in spite of not having data in the mysqli object.
Be careful when using fetch_assoc instead of fetch_row. If two columns of the result have the same column name, even if they are prefixed with different table names in the query, only one of them will be retained in the result. This is because the prefix is dropped (either by mysql or by this function)
For example if the query is
select p1.name, p2.name
from person p1, friend, person p2
where p1.id = friend.person1 and p2.id = friend.person2
the arrays returned by fetch_assoc will be of the form
when you fetch the data from the query variable
and try to fetch it again in another part of the script
from the same query variable ,
when you try to echo all data you have fetched,
it will not echo the data you have used in the first fetch
(it will exceed the results you have used in the first fetch).
Example :
$connect = new mysqli ( «localhost» , «root» , «root» , «elshamy» )
or die ( mysqli_error ());
$query = $connect -> query ( «SELECT * FROM users ORDER BY id ASC» );
$first_fetch = $query -> fetch_array ( MYSQLI_ASSOC );
echo $first_fetch [ ‘id’ ]. «===>» . $first_fetch [ ‘user_name’ ]. «\n———————\n» ;
while( $row = $query -> fetch_array ( MYSQLI_ASSOC ))
/*it will exceed the first
id&user_name value that
you have use in the first fetch*/
The official example given here breaks a cardinal rule, and should be rectified.
while ($row = $result->fetch_assoc()).
. breaks the rule of «assignment in condition».
while (($x = $y->getZ()) !== false) or
while (($x = $y->getZ()) !== null)
Conditional statements should always check for a boolean