Runtime Configuration
The behaviour of these functions is affected by settings in php.ini.
Name | Default | Changeable | Changelog |
---|---|---|---|
ingres.allow_persistent | "1" | PHP_INI_SYSTEM | Available since ingres 1.0.0 |
ingres.array_index_start | "1" | PHP_INI_ALL | Available since ingres 1.4.0. |
ingres.auto | "1" | PHP_INI_ALL | Available since ingres 2.0.0. |
ingres.blob_segment_length | "4096" | PHP_INI_ALL | Available since ingres 1.2.0. |
ingres.cursor_mode | "0" | PHP_INI_ALL | Available since ingres 1.1.0. |
ingres.default_database | NULL | PHP_INI_ALL | Available since ingres 1.0.0 |
ingres.default_password | NULL | PHP_INI_ALL | Available since ingres 1.0.0 |
ingres.default_user | NULL | PHP_INI_ALL | Available since ingres 1.0.0 |
ingres.describe | 1 | PHP_INI_ALL | Available since ingres 2.1.0 |
ingres.fetch_buffer_size | 100 | PHP_INI_ALL | Available since ingres 2.1.0 |
ingres.max_links | "-1" | PHP_INI_SYSTEM | Available since ingres 1.0.0 |
ingres.max_persistent | "-1" | PHP_INI_SYSTEM | Available since ingres 1.0.0 |
ingres.reuse_connection | "1" | PHP_INI_ALL | Available since ingres 2.0.0 |
ingres.scrollable | "1" | PHP_INI_ALL | Available since ingres 2.0.0. |
ingres.trace | "0" | PHP_INI_ALL | Available since ingres 2.0.0. |
ingres.trace_connect | "0" | PHP_INI_ALL | Available since ingres 1.2.1. |
ingres.utf8 | "1" | PHP_INI_ALL | Available since ingres 2.0.0. |
Here's a short explanation of the configuration directives.
-
ingres.allow_persistent
boolean -
Specifies whether to allow persistent connections to Ingres
-
ingres.array_index_start
integer -
Specifies the start value for an integer key for arrays generated by ingres_fetch_row() or ingres_fetch_array(). By default
ingres.array_index_start
is set to 1. If you wish to make the ingres extension behave like other database extensions set this configuration option to 0. -
ingres.auto
boolean -
Enables or disables autocommit emulation. Ingres cannot have multiple cursors open with autocommit enabled. When enabled, the driver emulates autocommit.
-
ingres.blob_segment_length
integer -
Specifies the amount of memory to use when reading BLOB data, in bytes
-
ingres.cursor_mode
integer -
Specifies the default mode for cursors opened with ingres_prepare(). Valid values are
INGRES_CURSOR_UPDATE
orINGRES_CURSOR_READONLY
. -
ingres.default_database
string -
Specifies the default database name to use when connecting to the database server if no other name is specified. Does not apply in SQL safe mode.
-
ingres.default_password
string -
Specifies the default password to use when connecting to the database server if no other name is specified. Does not apply in SQL safe mode.
-
ingres.default_user
string -
Specifies the default user name to use when connecting to the database server if no other name is specified. Does not apply in SQL safe mode.
-
ingres.describe
boolean -
Enables the use of DESCRIBE INPUT to determine the expected data types for queries that use parameters. Available with Ingres 9.1.0 and later. When disabled, queries that have parameters passed may need to manually describe the types of those parameters using the types parameter in ingres_query().
Note:
Enabling this feature with ingres_query() will cause additional communications traffic between this extension and the server. To minimize this additional traffic, use ingres_prepare() and ingres_execute().
-
ingres.fetch_buffer_size
integer -
Specifies the number of pre-fetch rows that ingres_fetch_array(), ingres_fetch_object() and ingres_fetch_row() will try and fetch in one fetch operation.
-
ingres.max_links
integer -
Specifies the maximum number of Ingres sessions allowed per process or thread. The number of sessions should not exceed the total number of connected sessions configured within Ingres.
-
ingres.max_persistent
integer -
Specifies the maximum number of persistent Ingres sessions allowed per process or thread. The number of sessions should not exceed the total number of connected sessions configured within Ingres.
-
ingres.reuse_connection
boolean -
Reuses an existing active connection if connecting to the same database with the same user name
-
ingres.scrollable
boolean -
Enables support for scrollable cursors. When fetching CLOB or BLOB data, this should be set to
FALSE
. Available with Ingres 9.2.0 or later. -
ingres.trace
boolean -
Enables simple tracing using
E_NOTICE
messages -
ingres.trace_connect
boolean -
Prints
E_NOTICE
messages during ingres_connect() or ingres_pconnect() calls -
ingres.utf8
boolean -
Assumes that strings being passed to National Character column types (NVARCHAR or NCHAR) are using UTF8 encoding and converts them to UTF16 for the server
English translation
You have asked to visit this site in English. For now, only the interface is translated, but not all the content yet.If you want to help me in translations, your contribution is welcome. All you need to do is register on the site, and send me a message asking me to add you to the group of translators, which will give you the opportunity to translate the pages you want. A link at the bottom of each translated page indicates that you are the translator, and has a link to your profile.
Thank you in advance.
Document created the 30/01/2003, last modified the 26/10/2018
Source of the printed document:https://www.gaudry.be/en/php-rf-ingres.configuration.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.