PHP Manual
Prev |  | Next

# XLV. Ingres II functions

# Introduction

These functions allow you to access Ingres II database servers.

> Note: If you already used PHP extensions to access other database servers, note that Ingres doesn't allow concurrent queries and/or transaction over one connection, thus you won't find any result or transaction handle in this extension. The result of a query must be treated before sending another query, and a transaction must be commited or rolled back before opening another transaction (which is automaticaly done when sending the first query).

Warning
This extension is EXPERIMENTAL. The behaviour of this extension -- including the names of its functions and anything else documented about this extension -- may change without notice in a future release of PHP. Use this extension at your own risk.

# Requirements

To compile PHP with Ingres support, you need the Open API library and header files included with Ingres II.

# Installation

In order to have these functions available, you must compile php with Ingres support by using the --with-ingres option. If the II_SYSTEM environment variable isn't correctly set you may have to use --with-ingres=DIR to specify your Ingres installation directory.

When using this extension with Apache, if Apache does not start and complains with "PHP Fatal error: Unable to start ingres_ii module in Unknown on line 0" then make sure the environement variable II_SYSTEM is correctly set. Adding "export II_SYSTEM="/home/ingres/II" in the script that starts Apache, just before launching httpd, should be fine.

# Runtime Configuration

The behaviour of these functions is affected by settings in `php.ini`.

Table 1. Ingres II configuration options

Name | Default | Changeable
--- | --- | ---
ingres.allow_persistent | "1" | PHP_INI_SYSTEM
ingres.max_persistent | "-1" | PHP_INI_SYSTEM
ingres.max_links | "-1" | PHP_INI_SYSTEM
ingres.default_database | NULL | PHP_INI_ALL
ingres.default_user | NULL | PHP_INI_ALL
ingres.default_password | NULL | PHP_INI_ALL

For further details and definition of the PHP_INI_* constants see ini_set().

# Resource Types

This extension has no resource types defined.

# Predefined Constants

The constants below are defined by this extension, and will only be available when the extension has either been compiled into PHP or dynamically loaded at runtime.

`INGRES_ASSOC` (integer)

`INGRES_NUM` (integer)

`INGRES_BOTH` (integer)

Prev | Home | Next
ibase_trans | Up | ingres_autocommit