# maxdb_real_connect

# maxdb::real_connect

(PECL maxdb >= 1.0)

maxdb_real_connect -- maxdb::real_connect — Opens a connection to a MaxDB server

### 说明

过程化风格

maxdb_real_connect ( resource `$link` [, string `$hostname` [, string `$username` [, string `$passwd` [, string `$dbname` [, int `$port` = 0 [, string `$socket` ]]]]]] ) : bool

面向对象风格

maxdb::real_connect ([ string `$hostname` [, string `$username` [, string `$passwd` [, string `$dbname` [, int `$port` = 0 [, string `$socket` ]]]]]] ) : bool

maxdb_real_connect() attempts to establish a connection to a MaxDB database engine running on `hostname`.

This function differs from maxdb_connect():

- maxdb_real_connect() needs a valid resource which has to be created by function maxdb_init()

- With function maxdb_options() you can set various options for connection.

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 范例

Example #1 面向对象风格

    <?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\n", maxdb_connect_error());
       exit();
    }

    printf ("Connection: %s\n.", $maxdb->host_info);

    $maxdb->close();
    ?>

Example #2 过程化风格

    <?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\n", maxdb_connect_error());
       exit();
    }

    printf ("Connection: %s\n.", maxdb_get_host_info($link));

    maxdb_close($link);
    ?>

以上例程的输出类似于：

    Connection: localhost <...>

### 参见

- maxdb_connect() - Open a new connection to the MaxDB server
- maxdb_init() - Initializes MaxDB and returns an resource for use with maxdb_real_connect
- maxdb_options() - Set options
- maxdb_ssl_set() - Used for establishing secure connections using SSL
- maxdb_close() - Closes a previously opened database connection