(PHP 4, PHP 5, PHP 7, PHP 8)
pg_dbname — Get the database name
pg_dbname() returns the name of the database
that the given PostgreSQL connection
instance.
connection
An PgSql\Connection instance.
When connection
is null
, the default connection is used.
The default connection is the last connection made by pg_connect()
or pg_pconnect() .
As of PHP 8.1.0, using the default connection is deprecated.
A string containing the name of the database the
connection
is to.
Version | Description |
---|---|
8.1.0 |
The connection parameter expects an PgSql\Connection
instance now; previously, a resource was expected.
|
8.0.0 |
connection is now nullable.
|
Example #1 pg_dbname() example
<?php
error_reporting(E_ALL);
pg_connect("host=localhost port=5432 dbname=mary");
echo pg_dbname(); // mary
?>
This function is as simple as it sounds, it returns the name of the database your are currently connected to on the handle retrieved from a pg_connect() call.
<?php
$pgsql_conn = pg_connect("dbname=mark host=localhost");
if ($pgsql_conn) {
print "Successfully connected to database: " . pg_dbname($pgsql_conn) .
" on " . pg_host($pgsql_conn) . "<br/>\n";
} else {
print pg_last_error($pgsql_conn);
exit;
}
?>
[mark@prodigy][*][~/public_html/php]>>>php pg_dbname.php
Content-type: text/html
X-Powered-By: PHP/4.3.1
Successfully connected to database: mark on localhost<br/>
Again this function is much more useful when you are changing which database you are connected to in your program.
Regards, --mark