class mysqli_result < array fetch_assoc ( void ) >
Returns an associative array that corresponds to the fetched row or NULL if there are no more rows.
The mysqli_fetch_assoc() function is used to return an associative array representing the next row in the result set for the result represented by the result parameter, where each key in the array represents the name of one of the result set’s columns.
If two or more columns of the result have the same field names, the last column will take precedence. To access the other column(s) of the same name, you either need to access the result with numeric indices by using mysqli_fetch_row() or add alias names.
Замечание: Эта функция устанавливает NULL-поля в значение NULL PHP.
Возвращаемые значения
Returns an array that corresponds to the fetched row or NULL if there are no more rows in resultset.
Смотрите также
Примеры
Пример 1. Object oriented style
$query = «SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5» ;
Пример 2. Procedural style
$query = «SELECT Name, CountryCode FROM City ORDER by ID DESC LIMIT 50,5» ;
Результат выполнения данного примера:
Pueblo (USA) Arvada (USA) Cape Coral (USA) Green Bay (USA) Santa Clara (USA)
mysql_fetch_assoc — Возвращает ряд результата запроса в качестве ассоциативного массива
Данное расширение устарело, начиная с версии PHP 5.5.0, и будет удалено в будущем. Используйте вместо него MySQLi или PDO_MySQL. Смотрите также инструкцию MySQL: выбор API и соответствующий FAQ для получения более подробной информации. Альтернативы для данной функции:
Описание
Возвращает ассоциативный массив, соответствующий полученному ряду и сдвигает вперед внутренний указатель результата. Функция mysql_fetch_assoc() аналогична вызову функции mysql_fetch_array() со вторым необязательным параметром, равным MYSQL_ASSOC. Функция возвращает только ассоциативный массив.
Список параметров
Возвращаемые значения
Возвращает ассоциативный массив строк, соответствующий полученному ряду, либо FALSE если рядов больше нет.
Примеры
Пример #1 Расширенный пример использования mysql_fetch_assoc()
$sql = «SELECT id as userid, fullname, userstatus FROM sometable WHERE userstatus = 1″ ;
Примечания
Замечание: Производительность
Замечание: Имена полей, возвращаемые этой функцией являются регистро-зависимыми.
Замечание: Эта функция устанавливает NULL-поля в значение NULL PHP.
mysql_fetch_assoc — Возвращает ряд результата запроса в качестве ассоциативного массива
Данный модуль устарел, начиная с версии PHP 5.5.0, и удалён в PHP 7.0.0. Используйте вместо него MySQLi или PDO_MySQL. Смотрите также инструкцию MySQL: выбор API. Альтернативы для данной функции:
Описание
Возвращает ассоциативный массив, соответствующий полученному ряду и сдвигает вперёд внутренний указатель результата. Функция mysql_fetch_assoc() аналогична вызову функции mysql_fetch_array() со вторым необязательным параметром, равным MYSQL_ASSOC. Функция возвращает только ассоциативный массив.
Список параметров
Возвращаемые значения
Возвращает ассоциативный массив строк, соответствующий полученному ряду, либо false если рядов больше нет.
Примеры
Пример #1 Расширенный пример использования mysql_fetch_assoc()
$sql = «SELECT id as userid, fullname, userstatus FROM sometable WHERE userstatus = 1″ ;
Примечания
Замечание: Производительность
Замечание: Имена полей, возвращаемые этой функцией являются зависимыми от регистра.
Замечание: Эта функция устанавливает NULL-поля в значение null PHP.
Смотрите также
User Contributed Notes 15 notes
Worth pointing out that the internal row pointer is incremented once the data is collected for the current row.
This means that multiple calls will iterate through the row data, so you DONT need to mysql_data_seek(..) between calls.
This is noted in the mysql_fetch_row() docs, but not here!?
It appears that you can’t have table.field names in the resulting array. Just use an alias if your results come up empty and you are using multi-table query’s:
$res=mysql_query(«SELECT user.ID AS uID, order.ID AS oID FROM user, order WHERE ( order.userid=uID )»; while ($row=mysql_fetch_assoc($res)) < echo «
To sum up moverton at northshropshiredc dot gov dot uk and Olivier Fabre:
Examples of non-fieldname «somethings» are: NULL NOW MAX(some_fieldname)
I haven’t tested whether this applies to table.fieldname, but I see no reason why it shouldn’t (I’d suspect a typo in my code if I didn’t get the expected results; I certainly have had my share of them!)
I found it most convenient to check for typos by simply var_dumping the resulting row, like this:
Please be advised that the resource result that you pass to this function can be thought of as being passed by reference because a resource is simply a pointer to a memory location.
Because of this, you can not loop through a resource result twice in the same script before resetting the pointer back to the start position.
—————- // Assume We Already Queried Our Database.
// Loop Through Result Set.
// We looped through the resource result already so the // the pointer is no longer pointing at any rows.
// If we decide to loop through the same resource result // again, the function will always return false because it // will assume there are no more rows.
// So the following code, if executed after the previous code // segment will not work.
The only solution to this is to reset the pointer to make it point at the first row again before the second code segment, so now the complete code will look as follows:
—————- // Assume We Already Queried Our Database.
// Loop Through Result Set.
Of course you would have to do extra checks to make sure that the number of rows in the result is not 0 or else mysql_data_seek itself will return false and an error will be raised.
Also please note that this applies to all functions that fetch result sets, including mysql_fetch_row, mysql_fetch_assos, and mysql_fetch_array.
Thanks to to R. Bradley for the implode idea. The following fixes a few bugs and includes quote_smart functionality (and has been tested)
Замечание: Имена полей, возвращаемые этой функцией являются зависимыми от регистра.
Замечание: Эта функция устанавливает NULL-поля в значение null PHP.
Список параметров
Возвращаемые значения
Если два или более столбца в выборке имеют одинаковое название полей, то приоритет отдаётся последнему столбцу. Для доступа к другому столбцу с таким же именем вам необходимо произвести нумерованную выборку с помощью функцию mysqli_fetch_row() или добавить псевдонимы.
Примеры
Пример #1 Пример использования mysqli_result::fetch_assoc()
$query = «SELECT Name, CountryCode FROM City ORDER BY ID DESC» ;
$query = «SELECT Name, CountryCode FROM City ORDER BY ID DESC» ;
Результатом выполнения данных примеров будет что-то подобное:
Пример #2 Сравнение использования mysqli_result iterator и mysqli_result::fetch_assoc()
mysqli_result можно повторить с помощью foreach. Результирующий набор всегда будет повторяться с первой строки, независимо от текущей позиции.
$query = ‘SELECT Name, CountryCode FROM City ORDER BY ID DESC’ ;
Результатом выполнения данного примера будет что-то подобное:
Смотрите также
User Contributed Notes 5 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).
If you were used to using code like this:
The official example given here breaks a cardinal rule, and should be rectified.
. breaks the rule of «assignment in condition».
. is the correct syntax.
Conditional statements should always check for a boolean
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
and not (as expected)
/*it will exceed the first id&user_name value that you have use in the first fetch*/
Для кого это статья? Первоочередной целью написания статьи было именно «разложить все по полочкам» для тех, кто уже работал с mysqli, но не вникал глубоко, а быстренько написал свои обертки и забыл про оригинальный синтаксис. Я постарался разъяснить нюансы, с которым столкнулся сам, при переносе данных из большой и очень старой БД, спроектированной человеком, не знающим про нормализации, в новую, с сильно изменившейся структурой.
Можно ли читать эту статью людям, которые все еще используют старое расширение mysql и только думающие об перехода на PDO или MySqli? Думаю даже нужно.
MySqli или PDO
Последние годы я писал сайты исключительно на фреймворках, что избавляло меня от работы с БД напрямую. Некоторое время назад начал работу над сайтом на чистом php и задался вопросом, что использовать вместо устаревшего и нерекомендованного к использованию старого расширения PHP MySQL.
Выбирать нужно было между MySqli и PDO. После не очень длительного изучения решил остановиться на MySqli, так как, как мне тогда казалось, он полностью идентичен PDO, за исключением того, что нет возможности отказаться от MySQL в пользу чего-то другого. Как я напишу ниже это не совсем так, минимум одно заметное отличие есть.
MySqli рекомендован к использованию самими разработчиками PHP.[1]
ООП и процедурный интерфейс
MySqli позволяет писать код как в ООП стиле так и в процедурном. Мне ближе ООП как и большинству из хабр сообщества, поэтому в этом статье будет использован именно он.
Три основные класса
Соединение с БД
Способ первый. Если вам нужно просто создать соединение.
Способ второй. Если вам нужно использовать опции соединения.
С помощью $mysqli->connect_errno и $mysqli->connect_error мы получаем описание и код ошибки, возникших при соединении. И new mysqli() и $mysqli->real_connect() при ошибках соединений вызывают ошибку PHP Warning. Поэтому вывод ошибок с помощью выше упомянутых функций имеет смысл, если у вас отключено отображение ошибок PHP, например, на рабочем сервере, либо если вам нужно как-то обработать эти данные. Я упомнил здесь об этом, потому что не все функции MySQLi вызывают PHP Warning в случае ошибки, и для того что бы узнать, что произошла ошибка необходимо обязательно обращаться к специальным функциям, об этом ниже.
Полученный при соединении объект мы присвоили переменной $mysqli, для того чтобы использовать его в дальнейшем. Это очевидно для ООП стиля, но и для процедурного стиля этот объект также необходим, в этом отличие от устаревшего расширения MySQL, где ссылку на соединение необязательно было передавать при каждом использовании mysql функций.
Буферизированные и не буферизированные результаты
Прежде чем рассказывать дальше, хотелось бы объяснить разницу между этими двумя типами результатов.
Рассмотрим небуферизированный результат. В этом случае вы можете начинать читать результаты, не дожидаясь пока mysql сервер получит результат полностью.
Буферизированный результат лишен этих недостатков и соответственно лишен перечисленных преимуществ.
«Классические» запросы
В MySqli оставили возможность «классических» запросов: когда пользователю предлагается самостоятельно заниматься безопасностью передаваемых запросов так, как это было в устаревшем расширении MySQL. Для этого предлагается использовать функцию $mysqli->real_escape_string(), с помощью которой необходимо обрабатывать все данные перед помещением их в запрос.
Так же как и с соединением есть два способа сделать такой запрос короткий и длинный.
Возможные константы: MYSQLI_STORE_RESULT – вернет буферизированный результат, значение по умолчанию MYSQLI_USE_RESULT – небуферизированный
Функции $mysqli->use_result() или $mysqli->store_result() так же используются при мульти запросах (запросах состоящих из нескольких запросов). Мульти запросы в этой статье рассмотрены не будут.
И тот и другой синтаксисы вернут результат в виде объекта mysqli_result, который представляет собой удобный интерфейс для работы с результатом, как с буферизированным так и не с небуферизированным.
Подготовленные запросы
Два способа создания подготовленного запроса.
Различия в том, для какого объекта вызываются функции получения информации об ошибке. Мне второй способ кажется удобнее, потому что проверки на ошибки можно объединить в один блок if c другими функциями mysqli_stmt. Как это сделать будет видно в примерах ниже.
Класс mysqli_result и работа с результатом с помощью него
Как было показано выше, объект mysqli_result вы могли получить как с помощью «классического» запроса с помощью класса mysqli, тогда он может быть как буферизированный так и небуферизированный, так и с помощью класса mysqli_stmt, тогда он буферизированный. От того какой результат вы получили, зависит работа функций этого класса, поэтому нужно хорошо понимать, что если ваш запрос небуферизированный вы не располагаете всем результатом и соответственно не можете знать сколько строк в результате, и читать его можно только по-порядку строка за строкой.
object ( Book ) [ 4 ] private ‘some1’ => int 1 public ‘some2’ => int 2 protected ‘id’ => int 382
