Modifica el comportamiento de una consulta preparada

# mysqli_stmt::attr_set

# mysqli_stmt_attr_set

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::attr_set -- mysqli_stmt_attr_set — Modifica el comportamiento de una consulta preparada

### Descripción

Estilo orientado a objetos

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

Estilo procedimental

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

Modifica el comportamiento de una consulta preparada. Esta función puede ser llamada varias veces para definir múltiples atributos.

### Parámetros

`statement`
  Solo estilo procedimental: Un objeto mysqli_stmt devuelto por mysqli_stmt_init().
`attribute`

  El atributo que se desea definir. Puede tener uno de los siguientes valores:

  Valores de los atributos
  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.

`value`

  El valor a asignar al atributo.

### Valores devueltos

Esta función retorna `true` en caso de éxito o `false` si ocurre un error.

### Errores/Excepciones

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.

### Ver también

- » Conector / MySQL mysql_stmt_attr_set()

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open