MAXDB_REAL_CONNECT(3) 1 MAXDB_REAL_CONNECT(3)
maxdb_real_connect - Opens a connection to a MaxDB server
Procedural style
SYNOPSIS
bool maxdb_real_connect (resource $link, [string $hostname], [string $username], [string $passwd], [string $dbname], [int $port],
[string $socket])
DESCRIPTION
Object oriented style
bool maxdb::real_connect ([string $hostname], [string $username], [string $passwd], [string $dbname], [int $port], [string $socket])
maxdb_real_connect(3) attempts to establish a connection to a MaxDB database engine running on $hostname.
This function differs from maxdb_connect(3):
omaxdb_real_connect(3) needs a valid resource which has to be created by function maxdb_init(3)
o With function maxdb_options(3) you can set various options for connection.
RETURN VALUES
Returns TRUE on success or FALSE on failure.
EXAMPLES
Example #1
Object oriented style
<?php
/* create a connection object which is not connected */
$maxdb = maxdb_init();
/* set connection options */
$maxdb->options(MAXDB_UNICODE, "FALSE");
$maxdb->options(MAXDB_TIMEOUT, 5);
/* connect to server */
$maxdb->real_connect('localhost', 'MONA', 'RED', 'DEMODB');
/* check connection */
if (maxdb_connect_errno()) {
printf("Connect failed: %s
", maxdb_connect_error());
exit();
}
printf ("Connection: %s
.", $maxdb->host_info);
$maxdb->close();
?>
Example #2
Procedural style
<?php
/* create a connection object which is not connected */
$link = maxdb_init();
/* set connection options */
maxdb_options($link, MAXDB_UNICODE, "FALSE");
maxdb_options($link, MAXDB_TIMEOUT, 5);
/* connect to server */
maxdb_real_connect($link, 'localhost', 'MONA', 'RED', 'DEMODB');
/* check connection */
if (maxdb_connect_errno()) {
printf("Connect failed: %s
", maxdb_connect_error());
exit();
}
printf ("Connection: %s
.", maxdb_get_host_info($link));
maxdb_close($link);
?>
The above example will output something similar to:
Connection: localhost <...>
SEE ALSO
maxdb_connect(3), maxdb_init(3), maxdb_options(3), maxdb_ssl_set(3), maxdb_close(3).
PHP Documentation Group MAXDB_REAL_CONNECT(3)