(PHP 5, PHP 7, PHP 8)
mysqli_stmt::attr_set -- mysqli_stmt_attr_set — Modifica el comportamiento de una consulta preparada
Estilo orientado a objetos
Estilo procedimental
Modifica el comportamiento de una consulta preparada. Esta función puede ser llamada varias veces para definir múltiples atributos.
statementattributeEl atributo que se desea definir. Puede tener uno de los siguientes valores:
| Caracteres | Descripción |
|---|---|
| MYSQLI_STMT_ATTR_UPDATE_MAX_LENGTH |
Si se define como true, la función mysqli_stmt_store_result()
actualizará el valor de los metadatos
MYSQL_FIELD->max_length.
|
| MYSQLI_STMT_ATTR_CURSOR_TYPE |
Tipo de cursor que permite abrir la consulta cuando se llama a la
función mysqli_stmt_execute(). value puede ser
MYSQLI_CURSOR_TYPE_NO_CURSOR (por omisión) o
MYSQLI_CURSOR_TYPE_READ_ONLY.
|
| MYSQLI_STMT_ATTR_PREFETCH_ROWS |
Número de filas a recuperar desde el servidor de una sola vez al
utilizar un cursor. value puede
estar comprendido entre 1 y el valor máximo de un tipo long sin signo.
Por omisión, vale 1.
Eliminado a partir de PHP 8.4.0.
|
Si se utiliza la opción MYSQLI_STMT_ATTR_CURSOR_TYPE
con MYSQLI_CURSOR_TYPE_READ_ONLY, se abrirá un cursor para la consulta
al llamar a la función mysqli_stmt_execute(). Si ya existe un cursor abierto
desde una llamada previa a la función mysqli_stmt_execute(), se cerrará
antes de abrir uno nuevo. La función mysqli_stmt_reset() cierra
asimismo todos los cursores antes de preparar la consulta para una nueva ejecución.
La función mysqli_stmt_free_result() cierra cualquier cursor abierto.
Si se abre un cursor para una consulta preparada, la función mysqli_stmt_store_result() no es necesaria.
valueEl valor a asignar al atributo.
Si el informe de errores de mysqli está habilitado (MYSQLI_REPORT_ERROR) y la operación solicitada falla,
se genera una advertencia. Si, además, el modo está configurado como MYSQLI_REPORT_STRICT,
se lanza una mysqli_sql_exception en su lugar.