ingres-php-configuration-5

  • Installing/Configuring
  • Runtime Configuration

  • Runtime Configuration
  • Runtime Configuration

    Runtime Configuration

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

    Ingres configuration options
    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.

    For further details and definitions of the PHP_INI_* modes, see the
    Where a
    configuration setting may be set
    .

    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 or
    INGRES_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.

    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