« mysqli::pollmysqli::query »PHP Manualmysqli

mysqli::prepare

mysqli_prepare

(PHP 5, PHP 7, PHP 8)

mysqli::prepare -- mysqli_prepare — Підготовляє SQL вираз до виконання

Опис

Об'єктно-орієнтований стиль

public mysqli::prepare(string $query): mysqli_stmt|false

Процедурний стиль

mysqli_prepare(mysqli $mysql, string $query): mysqli_stmt|false

Підготовляє SQL-запит і повертає покажчик цього виразу, який можна використовувати подальших операцій із цим виразом. Запит повинен складатися з одного виразу SQL.

Шаблон оператора може містити нуль або кілька знаків запитання (? ), позначок параметрів⁠, також званих заповнювачами. Мітки параметрів повинні бути прив'язані до змінних додатків за допомогою mysqli_stmt_bind_param() перед виконанням виразу.

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

mysql

Тільки для процедурного стилю: об'єкт mysqli, який повернула функція mysqli_connect()или функцияmysqli_init()

query

Текст запиту у вигляді рядка. Має складатися з одного SQL-виразу.

Вираз SQL може містити нуль або більше позначок параметрів, представлених знаками питання (? ) у відповідних позиціях.

Зауваження :

Ці мітки можна вбудовувати лише у певні місця у виразі. Наприклад, вони дозволені у списку VALUES() вирази INSERT (щоб задати значення стовпців для рядка), або в операціях порівняння речення WHERE для завдання порівнюваного значення. Однак вони не дозволені як ідентифікатори (наприклад, імена таблиць або стовпців).

Значення, що повертаються

mysqli_prepare() повертає об'єкт запиту або **false**в случае ошибки.

Помилки

Якщо сповіщення про помилки mysqli включено (MYSQLI_REPORT_ERROR) та запитана операція не вдалася, видається попередження. Якщо, крім того, встановлено режим MYSQLI_REPORT_STRICT, натомість буде викинуто виняток mysqli_sql_exception

Приклади

Приклад #1 Приклад використання mysqli::prepare()****

Об'єктно-орієнтований стиль

Loading...

Процедурний стиль

Loading...

Результат виконання наведених прикладів:

Amersfoort находится в округе Utrecht

Дивіться також

  • mysqli_stmt_execute() - Виконує підготовлене затвердження
  • mysqli_stmt_fetch() - пов'язує результати підготовленого виразу зі змінними
  • mysqli_stmt_bind_param() - Прив'язка змінних до параметрів запиту, що готується.
  • mysqli_stmt_bind_result() - Прив'язка змінних до підготовленого запиту для розміщення результату
  • mysqli_stmt_get_result() - Отримує результат із підготовленого запиту у вигляді об'єкта mysqli_result
  • mysqli_stmt_close() - Закриває підготовлений запит