(PHP 4 >= 4.0.2, PHP 5 < 5.1.0, PECL ingres >= 1.0.0)
ingres_connect — Abre una conexión a una base de datos de Ingres
$database
[, string $username
[, string $password
[, array $options
]]]] ) : resource
ingres_connect() abre una conexión con la
base de datos de Ingres dada por database
.
La conexión se cierra cuando el script finaliza o cuando ingres_close() se invoca para este enlace.
Si se omiten algunos parámetros, ingres_connect()
utilizará los valores de php.ini para
ingres.default_database
,
ingres.default_user
y
ingres.default_password
.
database
El nombre de la base de datos. Debe serguir la sintaxis:
[vnode::]dbname[/svr_class]
username
El nombre de usuario de Ingres
password
La contraseña asociada con username
options
Opciones de ingres_connect()
Nombre de la opción | Tipo de la opción | Descripción | Ejemplo |
---|---|---|---|
date_century_boundary | integer | El umbral por el cual se determina si un año de dos dígitos está en el siglo actual o en el siglo siguiente. Equivalente a II_DATE_CENTURY_BOUNDARY. | 50 |
group | string | Especifica el ID del grupo del usuario, equivalente a la bandera "-G" | payroll |
role | string | El ID del rol de la aplicación. Si se requiere una contraseña de rol, el valor del parámetro debería especificarse como "rol/contraseña" | |
effective_user | string | La cuenta del usuario de ingres por la que se está haciendo pasar, equivalente a la bandera "-u" | another_user |
dbms_password | string | La contraseña interna de la base de datos del usuario que se está conectando a Ingres | s3cr3t |
table_structure | string | La estructura predeteminada para la nuevas tablas. Los valores válidos para table_structure son:
|
INGRES_STRUCTURE_BTREE |
index_structure | string | La estructura predeterminada para los índeces secundarios nuevos. Los valores válidos para index_structure son:
|
INGRES_STRUCTURE_HASH |
login_local | boolean | Determina cómo se usan el ID del usuario y la contraseña cuando se incluye un VNODE en el string de la base de datos objetivo. Si se establece a TRUE, El ID del usuario y la contraseña se usarán para acceder localmente al VNODE, y la información de identificación del VNODE se usaraá para establecer la conexión al SGBD. Si se establece a FALSE, se usará el ID del usuario del proceso para acceder al VNODE, y el ID del usuario de la conexión y la contraseña se usarán en lugar de la información de identificación del VNODE para establecer la conexión al SGBD. Este parámetro es ignorado si no se incluye ningún VNODE en el string de la base de datos objetivo. Lo predeterminado es FALSE. | TRUE |
timezone | string | Controla la zona horaria de la sesión. Si no se establece, se usará el valor definido por II_TIMEZONE_NAME. Si II_TIMEZONE_NAME no está definido, se usarán NA-PACIFIC (GMT-8 con horara de verano). | |
date_format | integer | Establece el formato de entrada y salida permisible para las fechas de Ingres. El valor predeterminado es el definido por II_DATE_FORMAT. Si II_DATE_FORMAT no está establecido, se usará el formato de fecha US, p.j. mm/dd/aa. Los valores válidos para date_format son:
|
INGRES_DATE_MULTINATIONAL4 |
decimal_separator | string | El identificador del carácter para los datos decimales | "," |
money_lort | integer | El símbolo monetario que va antes o después del valor. Los valores válidos para money_lort son:
|
INGRES_MONEY_TRAILING |
money_sign | string | El símpbolo monetario a usar con el tipo de datos MONEY | € |
money_precision | integer | La precisión del tipo de datos MONEY | 3 |
float4_precision | integer | La precisión del tipo de datos FLOAT4 | 10 |
float8_precision | integer | La precisión del tipo de datos FLOAT8 | 10 |
blob_segment_length | integer | La cantidad de datos en bytes a obtener de una vez cuando se recuperan datos BLOB o CLOB. El valor predeterminado es de 4096 si no se establece explícitamente | 8192 |
Devuelve un recurso de enlace a Ingres en caso de éxito o FALSE
en caso de error
Ejemplo #1 Abrir una conexión a un base de datos de Ingres
<?php
$enlace = ingres_connect("mi_bd", "usuario", "contraseña")
or die("No se pudo conectar");
echo "Conexión realizada con éxito";
ingres_close($enlace);
?>