mysql_query
(PHP 4, PHP 5)
mysql_query — Надсилає запит MySQL
Увага
Цей модуль застарів, починаючи з версії PHP 5.5.0, і видалений у PHP 7.0.0. Використовуйте замість нього MySQLi або PDO_MySQLСмотрите также инструкциюMySQL: вибір API. Альтернативи для цієї функції:
Опис
mysql_query(string $query, resource $link_identifier = NULL): mixed
mysql_query() посилає один запит (надсилання кількох запитів не підтримується) активній базі даних сервера, на який посилається переданий дескриптор link_identifier
Список параметрів
query
SQL-запит
Запит не повинен закінчуватися крапкою з комою. Дані у запиті мають бути коректно проекрановано
link_identifier
З'єднання MySQL. Якщо ідентифікатор з'єднання не вказано, буде використано останнє з'єднання, відкрите mysql_connect(). Якщо таке з'єднання не було знайдено, функція спробує створити таке, якби mysql_connect() було викликано без параметрів. Якщо з'єднання не було знайдено та не змогло бути створено, генерується помилка рівня E_WARNING
Значення, що повертаються
Для запитів SELECT, SHOW, DESCRIBE, EXPLAIN та інших запитів, що повертають результат з кількох рядів, mysql_query() повертає дескриптор результату запиту (resource), або **false
**в случае возникновения ошибки.
Для інших типів SQL-запитів, INSERT, UPDATE, DELETE, DROP та інших, mysql_query() повертає true
у разі успішного виконання та **false
**в случае возникновения ошибки.
Отриманий дескриптор результату слід передати у функцію mysql_fetch_assoc()или любую другую функцию, работающую с результатами запросов.
Используйтеmysql_num_rows() для з'ясування кількості рядів в результаті SELECT-запиту або mysql_affected_rows() для з'ясування кількості опрацьованих рядів запитами DELETE, INSERT, REPLACE та UPDATE.
mysql_query() також завершиться з помилкою та поверне false
, якщо користувач не має доступу до будь-якої з таблиць, що фігурують у запиті.
Приклади
Приклад #1 Неправильний запит
Следующий запрос составлен неправильно иmysql_query() поверне false
Loading...
Приклад #2 Вірний запит
Наступний запит вірний, тому mysql_query() поверне ресурс.
Loading...
Дивіться також
- mysql_connect() - Відкриває з'єднання із сервером MySQL
- mysql_error() - Повертає текст помилки останньої операції з MySQL
- mysql_real_escape_string() - Екранує спеціальні символи у рядках для використання у виразах SQL
- mysql_result() - Повертає дані результату запиту
- mysql_fetch_assoc() - Повертає ряд результату запиту як асоціативний масив.
- mysql_unbuffered_query() - Надсилає запит MySQL без авто-обробки результату та його буферизації