Documentación offline PHP master

oci_define_by_name

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

oci_define_by_name

Asocia una variable PHP con una columna para una consulta de recuperación de datos

Descripción#

oci_define_by_name(resource $statement, string $column, mixed $var, [int $type]): bool
```php

Asocia una variable PHP con una columna para una consulta de recuperación de datos utilizando la función `oci_fetch`.

La llamada a la función `oci_define_by_name` debe realizarse antes de la ejecución de la función `oci_execute`.

## Parámetros

`statement`  
Un identificador de consulta OCI8 creado por la función `oci_parse` y ejecutado por la función `oci_execute`, o un identificador de consulta `REF CURSOR`.

`column`  
El nombre de la columna utilizado en la consulta.

Utilice un nombre en mayúsculas para los nombres de columna no sensibles a la casilla (por omisión bajo Oracle). Utilice la casilla exacta del nombre de la columna para los nombres de columna sensibles a la casilla.

`var`  
La variable PHP que contendrá el valor devuelto por la columna.

`type`  
El tipo de datos a devolver. En general, este argumento no es necesario. Tenga en cuenta que el estilo Oracle de conversión de datos no se aplica aquí. Por ejemplo, `SQLT_INT` será ignorado y el tipo de datos devuelto será `SQLT_CHR`.

Puede utilizar, opcionalmente, la función `oci_new_descriptor` para asignar descriptores LOB/ROWID/BFILE.

## Valores devueltos

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

## Ejemplos

Ejemplo con `oci_define_by_name`
\n"; } // Muestra: // Location id 1000 is Roma // Location id 1100 is Venice oci_free_statement($stid); oci_close($conn); ?>
Ejemplo con `oci_define_by_name` y nombres de columna sensibles a la casilla
\n"; } // Muestra: // id 1 is Iced Coffee oci_free_statement($stid); oci_close($conn); ?>
Ejemplo con `oci_define_by_name` y columnas de tipo LOB
load(100) . "
\n"; } // Muestra: // 1 is apple // 2 is orange $fruit->free(); oci_free_statement($stid); oci_close($conn); ?>
Ejemplo con `oci_define_by_name` y un tipo explícito
load(100) . "
\n"; } // Muestra: // 1 is apple // 2 is orange $fruit->free(); oci_free_statement($stid); oci_close($conn); ?>

```php

Véase también#

oci_fetch, oci_new_descriptor