MAXDB_OPTIONS(3) 1 MAXDB_OPTIONS(3)maxdb_options - Set options
Procedural style
SYNOPSIS
bool maxdb_options (resource $link, int $option, mixed $value)
DESCRIPTION
Object oriented style
bool maxdb::options (int $option, mixed $value)
maxdb_options(3) 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(3) should be called after maxdb_init(3) and before maxdb_real_connect(3).
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://maxdb.sap.com/documentation/ The parameter $option can be one of the following values:
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.
EXAMPLES
See maxdb_real_connect(3).
SEE ALSO maxdb_init(3), maxdb_real_connect(3).
PHP Documentation Group MAXDB_OPTIONS(3)
Check Out this Related Man Page
MAXDB_CHANGE_USER(3) 1 MAXDB_CHANGE_USER(3)maxdb_change_user - Changes the user of the specified database connection
Procedural style
SYNOPSIS
bool maxdb_change_user (resource $link, string $user, string $password, string $database)
DESCRIPTION
Object oriented style
bool maxdb::change_user (string $user, string $password, string $database)
maxdb_change_user(3) is used to change the user of the specified database connection as given by the $link parameter and to set the current
database to that specified by the $database parameter.
In order to successfully change users a valid $username and $password parameters must be provided and that user must have sufficient per-
missions to access the desired database. If for any reason authorization fails, the current user authentication will remain.
Note
Using this command will always cause the current database connection to behave as if was a completely new database connection,
regardless of if the operation was completed successfully. This reset includes performing a rollback on any active transactions,
closing all temporary tables, and unlocking all locked tables.
RETURN VALUES
Returns TRUE on success or FALSE on failure.
EXAMPLES
Example #1
Object oriented style
<?php
/* connect database test */
$maxdb = new maxdb("localhost", "MONA", "RED", "DEMODB");
/* check connection */
if (maxdb_connect_errno()) {
printf("Connect failed: %s
", maxdb_connect_error());
exit();
}
if ($result = $maxdb->query("SELECT * FROM dual")) {
$row = $result->fetch_row();
printf("Result: %s
", $row[0]);
$result->free();
}
/* reset all and select a new database */
if (!$maxdb->change_user("DBADMIN", "SECRET", "DEMODB")) {
printf("Database not running
");
} else {
printf("Database running
");
}
/* close connection */
$maxdb->close();
?>
Example #2
Procedural style
<?php
$link = maxdb_connect("localhost", "MONA", "RED", "DEMODB");
/* check connection */
if (!$link) {
printf("Connect failed: %s
", maxdb_connect_error());
exit();
}
if ($result = maxdb_query($link, "SELECT * FROM dual")) {
$row = maxdb_fetch_row($result);
printf("Result: %s
", $row[0]);
maxdb_free_result($result);
}
/* reset all and select a new database */
if (!maxdb_change_user($link, "DBADMIN", "SECRET", "DEMODB")) {
printf("Database not running
");
} else {
printf("Database running
");
}
/* close connection */
maxdb_close($link);
?>
The above example will output something similar to:
Result: a
Database running
SEE ALSO maxdb_connect(3), maxdb_select_db(3).
PHP Documentation Group MAXDB_CHANGE_USER(3)