PHP Manual
Prev |  | Next

# maxdb_options

(PECL)

maxdb_options

(no version information, might be only in CVS)

maxdb->options -- Set options

## Description

Procedural style:

bool maxdb_options ( resource link, int option, mixed value )

Object oriented style (method)

class maxdb {
bool options ( int option, mixed value )
}

maxdb_options() can be used to set extra connect options and affect behavior for a connection.

This function may be called multiple times to set several options.

maxdb_options() should be called after maxdb_init() and before maxdb_real_connect().

The parameter option is the option that you want to set, the value is the value for the option. For detailed description of the options see http://dev.mysql.com/doc/maxdb/ The parameter option can be one of the following values:

Table 1. Valid options

Name | Description
--- | ---
`MAXDB_COMPNAME` | The component name used to initialise the SQLDBC runtime environment.
`MAXDB_APPLICATION` | The application to be connected to the database.
`MAXDB_APPVERSION` | The version of the application.
`MAXDB_SQLMODE` | The SQL mode.
`MAXDB_UNICODE` | TRUE, if the connection is an unicode (UCS2) client or FALSE, if not.
`MAXDB_TIMEOUT` | The maximum allowed time of inactivity after which the connection to the database is closed by the system.
`MAXDB_ISOLATIONLEVEL` | Specifies whether and how shared locks and exclusive locks are implicitly requested or released.
`MAXDB_PACKETCOUNT` | The number of different request packets used for the connection.
`MAXDB_STATEMENTCACHESIZE` | The number of prepared statements to be cached for the connection for re-use.
`MAXDB_CURSORPREFIX` | The prefix to use for result tables that are automatically named.

## Return Values

Returns `TRUE` on success or `FALSE` on failure.

## See Also

maxdb_init(), maxdb_real_connect()

## Example

See maxdb_real_connect().

Prev | Home | Next
maxdb_num_rows | Up | maxdb_param_count