Forum und email
ingres_connect

ingres_connect

(PHP 4 >= 4.0.2, PHP 5 <= 5.0.4)

ingres_connect --  Open a connection to an Ingres database

Description

resource ingres_connect ( [string database [, string username [, string password [, array options]]]] )

Returns a Ingres link resource on success, or FALSE on failure.

ingres_connect() opens a connection with the Ingres database designated by database, which follows the syntax [node_id::]dbname[/svr_class].

If some parameters are missing, ingres_connect() uses the values in php.ini for ingres.default_database, ingres.default_user and ingres.default_password.

The connection is closed when the script ends or when ingres_close() is called on this link.

All the other ingres functions use the last opened link as a default, so you need to store the returned value only if you use more than one link at a time.

ingres_connect() options

Option nameDescription
date_century_boundaryThe threshold by which a 2 digit year is determined to be in the current century or in the next century. Equivalent to II_DATE_CENTURY_BOUNDARY.
groupSpeficfies the group ID of the user, equivalent to the '-G' flag
roleThe role ID of the application. If a role password is required, the parameter value should be specified as "role/password"
effective_userThe ingres user account being impersonated, equivalent to the '-u' flag
dbms_passwordThe internal database password for the user connecting to Ingres
table_structureThe default structure for new tables. Valid values for table_structure are:

  • INGRES_STRUCTURE_BTREE

  • INGRES_STRUCTURE_HASH

  • INGRES_STRUCTURE_HEAP

  • INGRES_STRUCTURE_ISAM

  • INGRES_STRUCTURE_CBTREE

  • INGRES_STRUCTURE_CISAM

  • INGRES_STRUCTURE_CHASH

  • INGRES_STRUCTURE_CHEAP

index_structureThe default structure for new secondary indexes. Valid values for index_structure are:

  • INGRES_STRUCTURE_CBTREE

  • INGRES_STRUCTURE_CISAM

  • INGRES_STRUCTURE_CHASH

  • INGRES_STRUCTURE_BTREE

  • INGRES_STRUCTURE_HASH

  • INGRES_STRUCTURE_ISAM

login_localDetermines how the connection user ID and password are used when a VNODE is included in the target database string. If set to TRUE, the user ID and password are used to locally access the VNODE and the VNODE login information is used to establish the DBMS connection. If set to FALSE, the process user ID is used to access the VNODE and the connection user ID and password are used in place of the VNODE login information to establish the DBMS connection. This parameter is ignored if no VNODE is included in the target database string. The default is FALSE.
timezoneControls the timezone of the session. If not set it will default the the value defined by II_TIMEZONE_NAME. If II_TIMEZONE_NAME is not defined the NA-PACIFIC (GMT-8 with Daylight Savings) is used.
date_formatSets the allowable input and output format for Ingres dates. Defaults to the value defined by II_DATE_FORMAT. If II_DATE_FORMAT is not set the default date format is US, e.g. mm/dd/yy. Valid values for date_format are:

  • 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

decimal_separatorThe character identifier for decimal data
money_lortLeading or trailing currency sign. Valid values for money_lort are:

  • INGRES_MONEY_LEADING

  • INGRES_MONEY_TRAILING

money_signThe currency symbol to be used with the MONEY datatype
money_precisionThe precision of the MONEY datatype
float4_precisionPrecision of the FLOAT4 datatype
float8_precisionPrecision of the FLOAT8 data
blob_segment_lengthThe amount of data in bytes to fetch at a time when retrieving BLOB/CLOB data, defaults to 4096 bytes when not explicitly set.

Příklad 1. ingres_connect() example

<?php
    $link
= ingres_connect("mydb", "user", "pass")
        or die(
"Could not connect");
    echo
"Connected successfully";
    
ingres_close($link);
?>

Příklad 2. ingres_connect() example using default link

<?php
    ingres_connect
("mydb", "user", "pass")
        or die(
"Could not connect");
    echo
"Connected successfully";
    
ingres_close();
?>

See also ingres_pconnect() and ingres_close().