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 без авто-обробки результату та його буферизації