maxdb_connect

maxdb::__construct

Open a new connection to the MaxDB server

&reftitle.description;

&style.procedural;

`resource` `maxdb_connect` `string` `host` `string` `username` `string` `passwd` `string` `dbname` `int` `port` 0 `string` `socket`

&style.oop;

`maxdb::__construct` `string` `host` `string` `username` `string` `passwd` `string` `dbname` `int` `port` 0 `string` `socket`

The `maxdb_connect` function attempts to open a connection to the MaxDB Server running on `host` which can be either a host name or an IP address. Passing the string "localhost" to this parameter, the local host is assumed. If successful, the `maxdb_connect` will return an resource representing the connection to the database&return.falseforfailure;.

The `username` and `password` parameters specify the username and password under which to connect to the MaxDB server. If the password is not provided (the &null; value is passed), the MaxDB server will attempt to authenticate the user against the `maxdb.default_pw` in &php.ini;.

The `dbname` parameter if provided will specify the default database to be used when performing queries. If not provied, the entry `maxdb.default_db` in &php.ini; is used.

The `port` and `socket` parameters are ignored for the MaxDB server.

&reftitle.returnvalues;

Returns a resource which represents the connection to a MaxDB Server or &false; if the connection failed.

&reftitle.examples;

### &style.oop;

    <?php
    $maxdb = new maxdb("localhost", "MONA", "RED", "DEMODB");

    /* check connection */
    if (maxdb_connect_errno()) {
       printf("Connect failed: %s\n", maxdb_connect_error());
       exit();
    }

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

    /* close connection */
    $maxdb->close();
    ?>

### &style.procedural;

    <?php
    $link = maxdb_connect("localhost", "MONA", "RED", "DEMODB");

    /* check connection */
    if (!$link) {
       printf("Connect failed: %s\n", maxdb_connect_error());
       exit();
    }

    printf("Host information: %s\n", maxdb_get_host_info($link));

    /* close connection */
    maxdb_close($link);
    ?>

&example.outputs.similar;

    Host information: localhost