ingres_connect

(PHP 4 >= 4.0.2, PHP 5 < 5.1.0, PECL ingres >= 1.0.0)

ingres_connectAbre una conexión a una base de datos de Ingres

Descripción

ingres_connect ([ string $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.

Parámetros

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
  • INGRES_STRUCTURE_HASH
  • INGRES_STRUCTURE_HEAP
  • INGRES_STRUCTURE_ISAM
  • INGRES_STRUCTURE_CBTREE
  • INGRES_STRUCTURE_CISAM
  • INGRES_STRUCTURE_CHASH
  • INGRES_STRUCTURE_CHEAP

INGRES_STRUCTURE_BTREE
index_structure string

La estructura predeterminada para los índeces secundarios nuevos. Los valores válidos para index_structure son:

  • INGRES_STRUCTURE_CBTREE
  • INGRES_STRUCTURE_CISAM
  • INGRES_STRUCTURE_CHASH
  • INGRES_STRUCTURE_BTREE
  • INGRES_STRUCTURE_HASH
  • INGRES_STRUCTURE_ISAM

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_DMY
  • INGRES_DATE_FINISH
  • INGRES_DATE_GERMAN
  • INGRES_DATE_ISO
  • INGRES_DATE_ISO4
  • INGRES_DATE_MDY
  • INGRES_DATE_MULTINATIONAL
  • INGRES_DATE_MULTINATIONAL4
  • INGRES_DATE_YMD
  • INGRES_DATE_US

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_LEADING
  • INGRES_MONEY_TRAILING

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

Valores devueltos

Devuelve un recurso de enlace a Ingres en caso de éxito o FALSE en caso de error

Ejemplos

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);
?>

Ver también