mysqli_stmt::attr_set

mysqli_stmt_attr_set

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::attr_set -- mysqli_stmt_attr_set — Змінює поведінку підготовленого запиту

Опис

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

public mysqli_stmt::attr_set(int $attribute, int $value): bool

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

mysqli_stmt_attr_set(mysqli_stmt $statement, int $attribute, int $value): bool

Використовується для зміни поведінки підготовленого запиту. Ця функція може бути викликана кілька разів для встановлення кількох атрибутів.

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

stmt

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

attribute

Атрибут, що встановлюється. Він може приймати такі значення:

Значення атрибуту

Символ	Опис
MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH	Якщо дорівнює true, тоmysqli_stmt_store_result() оновлює метадані значенням MYSQL_FIELD->max_length
MYSQLI_STMT_ATTR_CURSOR_TYPE	Тип вказівника, який потрібно відкрити для запиту під час виклику mysqli_stmt_execute(). . value може бути MYSQLI_CURSOR_TYPE_NO_CURSOR(по умолчанию) илиMYSQLI_CURSOR_TYPE_READ_ONLY
MYSQLI_STMT_ATTR_PREFETCH_ROWS	Кількість рядків, які потрібно вибрати із сервера під час використання покажчика. . value може бути в діапазоні від 1 максимального значення типу unsigned long. За замовчуванням 1.

Якщо використовується опція MYSQLI_STMT_ATTR_CURSOR_TYPEвместе сMYSQLI_CURSOR_TYPE_READ_ONLY, то покажчик буде відкритий для запиту, коли буде запущена mysqli_stmt_execute(). Якщо вже є відкритий покажчик від попереднього запуску mysqli_stmt_execute(), то покажчик буде закрито перед відкриттям нового . mysqli_stmt_reset() також закриває будь-який відкритий покажчик перед підготовкою запиту перед перезапуском . mysqli_stmt_free_result() закриває будь-який відкритий покажчик.

Якщо ви відкриваєте вказівник для підготовленого запиту, у використанні mysqli_stmt_store_result() немає необхідності.

value

Значення, що присвоюється атрибуту.

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

Повертає true у разі успішного виконання або **false**в случае возникновения ошибки.

Помилки

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

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

• » Connector/MySQL mysql_stmt_attr_set()