« pg_copy_to
pg_delete »

pg_dbname

(PHP 4, PHP 5, PHP 7, PHP 8)

pg_dbname — データベース名を取得する

説明

function pg_dbname(?PgSql\Connection $connection = null): string

pg_dbname() は、 PostgreSQL の connection インスタンスで指定した データベースの名前を返します。

パラメータ

connection

PgSql\Connection クラスのインスタンス。 connection が null, の場合、デフォルトの接続を使います。 デフォルトの接続とは、pg_connect() または pg_pconnect() によって確立された直近の接続です。

警告

PHP 8.1.0 以降では、デフォルトの接続を使うことは推奨されなくなりました。

戻り値

connection が指すデータベースの名前を表す 文字列を返します。

変更履歴

バージョン 説明
8.1.0 connection は、PgSql\Connection クラスのインスタンスを期待するようになりました。 これより前のバージョンでは、resource を期待していました。
8.0.0 connection は、nullable になりました。

例

例1 pg_dbname() の例

<?php
  error_reporting(E_ALL);

  pg_connect("host=localhost port=5432 dbname=mary");
  echo pg_dbname(); // mary
?>

関連キーワード:
dbname   connection   データベース   接続   PgSql   Connection   インスタンス   PostgreSQL   connect   期待   mary   copy   delete   pconnect   確立   直近   推奨   履歴   resource   nullable   reporting   host   localhost   port
関連する関数・ページ:
function.pg-connect   function.pg-options   function.pg-ping   function.pg-pconnect   function.pg-host   function.pg-close