PHPマニュアル/PEARマニュアル | ユーザフォーラムで議論/質問 | マニュアル検索 | ハイライト | ハイライトオフ | ポータル | php spot

pg_parameter_status - サーバーのパラメータ設定を検索する | JavaScript入門&応用&リファレンスなら「JavaScriptist」

  

pg_parameter_status

(PHP 5, PHP 7)

pg_parameter_statusサーバーのパラメータ設定を検索する

説明

string pg_parameter_status ([ resource $connection ], string $param_name )

サーバーのパラメータ設定を検索します。

いくつかのパラメータについては、接続の確立時や値の変更時にサーバーから 自動的に通知されます。pg_parameter_status() は これらの設定問い合わせるために使用可能です。指定したパラメータが存在する 場合にその値を、存在しない場合に FALSE を返します。

PostgreSQL 8.0 で指定できるパラメータには以下が含まれます。 server_versionserver_encodingclient_encodingis_superusersession_authorizationDateStyleTimeZone および integer_datetimesserver_encodingTimeZone および integer_datetimes は 8.0 より前のバージョンでは指定できません)。 server_versionserver_encoding および integer_datetimes は、PostgreSQL の稼動中には変更できないことに注意しましょう。

PostgreSQL 7.3 以前のサーバーはパラメータ設定を通知する機能を持っていません。 しかし、pg_parameter_status() には server_version および client_encoding を取得する機能を組み込んでいます。これらの値を取得するためにアプリケーションで アドホックなコードを書くのではなく、pg_parameter_status() を使用することを推奨します。

警告

7.4 より前の PostgreSQL サーバーでは、接続の確立後に SET を用いて client_encoding を変更しても pg_parameter_status() には反映されません。

パラメータ

connection

PostgreSQL データベース接続リソース。connection が指定されていない場合はデフォルトの接続が使用されます。 デフォルトの接続は、直近の pg_connect() あるいは pg_pconnect() によって作成されたものです。

param_name

指定可能な param_name には以下が含まれます。 server_versionserver_encodingclient_encodingis_superusersession_authorizationDateStyleTimeZone および integer_datetimes

返り値

パラメータの値を文字列で返します。失敗した場合や param_name が間違っている場合には FALSE を返します。

例1 pg_parameter_status() の例

<?php
  $dbconn 
pg_connect("dbname=publisher") or die("Could not connect");

  echo 
"Server encoding: "pg_parameter_status($dbconn"server_encoding");
?>

上の例の出力は以下となります。

Server encoding: SQL_ASCII


忘却曲線を使ってこの関数を確実に記憶に残す

フォーラムで「pg_parameter_status - サーバーのパラメータ設定を検索する」について話す
各種マニュアル: PHPマニュアル | PEARマニュアル | Smarty(英語)マニュアル | PHP-GTKマニュアル | pg_parameter_status - サーバーのパラメータ設定を検索する」をGoogle検索
copyright © 1997-2024 PHP ドキュメント作成グループ(ライセンス). provided by php spot. マニュアル: