Manual do PHP
Anterior |  | Próxima

# maxdb_change_user

(PECL)

maxdb_change_user

(no version information, might be only in CVS)

maxdb->change_user -- Changes the user of the specified database connection

## Description

Procedural style:

bool maxdb_change_user ( resource link, string user, string password, string database )

Object oriented style (method):

class maxdb {
bool change_user ( string user, string password, string database )
}

maxdb_change_user() 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 permissions to access the desired database. If for any reason authorization fails, the current user authentication will remain.

> Nota: 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

Retorna `TRUE` em caso de sucesso ou `FALSE` em falhas.

## See also:

maxdb_connect() maxdb_select_db()

## Example

Exemplo 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\n", maxdb_connect_error()); exit(); } if ($result = $maxdb->query("SELECT * FROM dual")) { $row = $result->fetch_row(); printf("Result: %s\n", $row[0]); $result->free(); } /* reset all and select a new database */ if (!$maxdb->change_user("DBADMIN", "SECRET", "DEMODB")) { printf("Database not running\n"); } else { printf("Database running\n"); } /* close connection */ $maxdb->close(); ?>`

Exemplo 2. Procedural style
`<?php $link = maxdb_connect("localhost", "MONA", "RED", "DEMODB"); /* check connection */ if (!$link) { printf("Connect failed: %s\n", maxdb_connect_error()); exit(); } if ($result = maxdb_query($link, "SELECT * FROM dual")) { $row = maxdb_fetch_row($result); printf("Result: %s\n", $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\n"); } else { printf("Database running\n"); } /* close connection */ maxdb_close($link); ?>`

The above examples would produce the following output:

    Result: a
    Database running

Anterior | Principal | Próxima
maxdb_bind_result | Acima | maxdb_character_set_name