hirokawa Tue Dec 18 11:01:15 2001 EDT
Modified files:
/phpdoc/ja/functions pgsql.xml
Log:
translation updated.
Index: phpdoc/ja/functions/pgsql.xml
diff -u phpdoc/ja/functions/pgsql.xml:1.28 phpdoc/ja/functions/pgsql.xml:1.29
--- phpdoc/ja/functions/pgsql.xml:1.28 Wed Dec 12 15:53:34 2001
+++ phpdoc/ja/functions/pgsql.xml Tue Dec 18 11:01:15 2001
@@ -1,22 +1,67 @@
<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision: 1.29 $ -->
<reference id="ref.pgsql">
<title>PostgreSQL 関数</title>
<titleabbrev>PostgreSQL</titleabbrev>
<partintro>
+ <warning>
+ <para>
+ PHP 4.0.6の通知メッセージ処理にはバグがあるため、PHP 4.0.6で
+ PostgreSQLモジュールを使用することは推奨されません。
+ </para>
+ </warning>
+ <warning>
+ <para>
+
+PostgreSQLの関数名は、現在のコード規約に沿うようにバージョン4.2.0
+
+で変更されます。新しい名前の多くにはアンダースコアが追加されます。
+
+例えば、pg_exec()からpg_query()のようにいくつかの関数は、統一性を
+
+持たせるために異なる名前に変更されます。以前の名前は、4.2.0以降の
+
+何回かのリリースでも使用可能ですが、将来的に削除される可能性があ
+
+ります。CVSバージョンには、新しい関数名が付けられています。
+ </para>
+ <para>
+ 従来のpg_connect()/pg_pconnect()
+は、将来的に同期接続機能をサポー
+ トするために過去のものとなる可能性があります。
+ </para>
+ </warning>
<para>
Postgresは元々UCB(カリフォルニア大学バークレイ校)コンピュータ・サ
- イエンス学部で開発されたものです。このPostgresは、
-
いくつかの商用データベースにおいてサポートされつつあるオブジェクト
- リレーショナルデータベース的概念の多くの先駆けでした。
- PostgreSQLは、SQL92/SQL3言語サポート、トランザクション機能、
- 拡張可能な型を提供しています。
+
+イエンス学部で開発されたものです。このPostgresは、いくつかの商用デー
+
+タベースにおいてサポートされつつあるオブジェクトリレーショナルデー
+
+タベース的概念の多くの先駆けでした。PostgreSQLは、SQL92/SQL3言語サ
+
+ポート、トランザクション機能、拡張可能な型を提供しています。
PostgreSQLは、パブリック・ドメイン、オープンソースで、オリジナルの
バークレイ・コードから発展してきた子孫にあたります。
</para>
<para>
- PostgreSQLは無料で利用できます。現在のバージョン
- は<ulink url="&url.pgsql;">www.PostgreSQL.org</ulink>で入手可能です。
+
+PostgreSQLデータベースはオープンソースのプロダクツであり、無料で使
+ 用可能できます。PostgreSQLサポートを使用するには、PostgreSQL
+6.5以
+ 降が必要です。PostgreSQL
+7.0以降ではPostgreSQLモジュールの全ての機
+
+能が使用可能です。PostgreSQLは、マルチバイト文字エンコーディングを
+
+含む多くの文字エンコーディングをサポートしています。現在のバージョ
+ ン及びPostgreSQLに関するより詳細な情報は、<ulink
+ url="&url.pgsql;">www.postgresqlL.org</ulink>で入手可能です。
+ </para>
+ <para>
+ PostgreSQLサポートを利用可能とするには、PHPコンパイル時に
+ "--enable-pgsql[=DIR]" を指定することが必要です。共有オ
+ ブジェクトモジュールが利用可能な場合、PostgreSQLはphp.iniの
+ <link linkend="ini.extension">extension</link>または
+
+<function>dl</function>関数を使用してロードすることが可能です。
+
+サポートされるini命令は、配布ソースに付属するphp.ini-distファイル
+ に記述されています。
+ </para>
+ <para>
+
+全ての関数が全ての構築環境でサポートされるわけではありません。サポー
+
+トされる関数は、使用するlibpq(PostgreSQLのCクライアントインターフェ
+
+イス)のバージョンとlibpqのコンパイル方法に依存します。足りない関数
+
+がある場合、libpqはその関数を必要とする機能をサポートしません。
+ </para>
+ <para>
+
+接続するPostgreSQLサーバーよりも新しいlibpqを使用することも重要で
+
+す。使用するlibpqのバージョンがPostgreSQLサーバが期待するよりも古
+ い場合、問題を生じる可能性があります。
</para>
<para>
バージョン6.3(1998/3/2)以降、PostgreSQLはUNIXドメインソケットを
@@ -26,11 +71,11 @@
指定することで有効となります。これは
"Unixドメインソケット以外のTCP/IP
ソケットもlisten する"という意味です。
<table>
- <title>PostmasterとPHP</title>
+ <title>postmasterとPHP</title>
<tgroup cols="3">
<thead>
<row>
- <entry>Postmaster</entry>
+ <entry>postmaster</entry>
<entry>PHP</entry>
<entry>ステータス</entry>
</row>
@@ -74,95 +119,113 @@
</para>
<para>
以前の構文:
- <command>$conn = pg_connect ("host", "port", "options", "tty",
- "dbname")
+ <command>
+ $conn = pg_connect ("host", "port", "options", "tty", "dbname")
</command>
は推奨されません。
</para>
<para>
+
+環境変数は、PostgreSQLサーバ/クライアントの動作に影響を与えます。
+
+例えば、PostgreSQLモジュールは、ホスト名が接続文字列で省略された場
+
+合、環境変数PGHOSTを探します。サポートされる環境変数は、バージョン
+
+毎に異なります。詳細は、PostgreSQLプログラマ用マニュアル(libpq
+-
+ 環境変数)を参照下さい。
+ </para>
+ <para>
+ PostgreSQL
+7.1.0から、textデータ型の最大サイズは1GBとなっています。
+
+古いPostgreSQLのtextデータ型はブロックサイズ(デフォルトは8KB、最大
+ 32KBをコンパイル時に定義可能)の制限を受けていました。
+ </para>
+ <para>
ラージオブジェクト(lo)インターフェースを使用するには、そのクエリーを
トランザクション・ブロックの中に入れてやる必要があります。
トランザクション・ブロックは<command>begin</command>で始まり、
そのトランザクションが有効な場合は<command>commit</command>または
<command>end</command>で終わります。トランザクションが失敗した場合、
- そのトランザクションは<command>abort</command>または
- <command>rollback</command>により閉じる必要があります。
+ そのトランザクションは<command>rollback</command>または
+ <command>abort</command>により閉じる必要があります。
<example>
<title>ラージオブジェクトの使用例</title>
<programlisting role="php">
-<?php
- $database = pg_Connect ("", "", "", "", "jacarta");
+<![CDATA[
+<?php
+ $database = pg_connect ("dbname=jacarta");
pg_exec ($database, "begin");
$oid = pg_locreate ($database);
echo ("$oid\n");
$handle = pg_loopen ($database, $oid, "w");
echo ("$handle\n");
- pg_lowrite ($handle, "gaga");
+ pg_lowrite ($handle, "large object data");
pg_loclose ($handle);
- pg_exec ($database, "commit")
+ pg_exec ($database, "commit");
?>
+]]>
</programlisting>
</example>
+
+ラージオブジェクトリソースを閉じる前に接続リソースを閉じないように
+ して下さい。
</para>
</partintro>
<refentry id="function.pg-close">
<refnamediv>
<refname>pg_close</refname>
- <refpurpose>PostgreSQLコネクションを閉じる</refpurpose>
+ <refpurpose>PostgreSQL接続を閉じる</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>pg_close</function></funcdef>
- <paramdef>int <parameter>connection</parameter></paramdef>
+ <paramdef>resource <parameter>connection</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
-
connectionが有効なコネクションでない場合は&false;を返し、そうでなければ
-
&true;を返します。この関数は、指定した接続IDに関連するPostgreSQL
- データベースへのコネクションを閉じます。
+ <function>pg_close</function> は、
+ <parameter>connection</parameter>リソースで指定したPostgreSQLデー
+ タベースへの持続的でない接続を閉じます。
+ <parameter>connection</parameter>が有効な接続リソースの場合、この
+ 関数は、&true;を返し、そうでない場合は &false;を返します。
</para>
<note>
<para>
持続的でない接続はスクリプトの実行終了時に時動的にクローズされる
- ため、この関数は通常は必要ありません。
+ ため、<function>pg_close</function>は通常は必要ありません。
+ <function>pg_close</function> は、
+ <function>pg_pconnect</function>で生成された持続的なリンクは閉じ
+ ません。
</para>
</note>
- <para>
- <function>pg_close</function> は、
- <function>pg_pconnect</function>で生成された持続的なリンクは閉じ
- ません。
- </para>
</refsect1>
</refentry>
<refentry id="function.pg-cmdtuples">
<refnamediv>
<refname>pg_cmdtuples</refname>
- <refpurpose>影響を受けたタプルの数を返す</refpurpose>
+ <refpurpose>影響を受けたタプル(レコード)数を返す</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_cmdtuples</function></funcdef>
- <paramdef>int <parameter>result_id</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>pg_cmdtuples</function>は、INSERT, UPDATE,DELETEクエリー
-
により影響を受けたタプル(インスタンス)の数を返します。影響を
- 受けたタプルがない場合は0を返します。
+
+により影響を受けたタプル(インスタンス/レコード/行)の数を返します。
+ 影響を受けたタプルがない場合は0を返します。
<example>
<title>pg_cmdtuples</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
$result = pg_exec ($conn, "INSERT INTO verlag VALUES ('Autor')");
$cmdtuples = pg_cmdtuples ($result);
-echo $cmdtuples . " <- cmdtuples affected.";
+echo $cmdtuples . " <- タプルが影響を受けました。";
?>
+]]>
</programlisting>
</example>
</para>
@@ -176,76 +239,73 @@
<refentry id="function.pg-connect">
<refnamediv>
<refname>pg_connect</refname>
- <refpurpose>PostgreSQLコネクションを開く</refpurpose>
+ <refpurpose>PostgreSQL接続を開く</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
- <funcdef>int <function>pg_connect</function></funcdef>
- <paramdef>string <parameter>host</parameter></paramdef>
- <paramdef>string <parameter>port</parameter></paramdef>
- <paramdef>string <parameter>dbname</parameter></paramdef>
- </funcprototype>
- <funcprototype>
- <funcdef>int <function>pg_connect</function></funcdef>
- <paramdef>string <parameter>host</parameter></paramdef>
- <paramdef>string <parameter>port</parameter></paramdef>
- <paramdef>string <parameter>options</parameter></paramdef>
- <paramdef>string <parameter>dbname</parameter></paramdef>
- </funcprototype>
- <funcprototype>
- <funcdef>int <function>pg_connect</function></funcdef>
- <paramdef>string <parameter>host</parameter></paramdef>
- <paramdef>string <parameter>port</parameter></paramdef>
- <paramdef>string <parameter>options</parameter></paramdef>
- <paramdef>string <parameter>tty</parameter></paramdef>
- <paramdef>string <parameter>dbname</parameter></paramdef>
- </funcprototype>
- <funcprototype>
- <funcdef>int <function>pg_connect</function></funcdef>
- <paramdef>string <parameter>conn_string</parameter></paramdef>
+ <funcdef>resource <function>pg_connect</function></funcdef>
+ <paramdef>string <parameter>connection_string</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
-
成功すると接続インデックスを返し、コネクションが生成できなかった場合は
- &false;を返します。この関数は
PostgreSQLデータベースへのコネクションを
-
オープンします。引数は引用符で括った文字列とする必要があります。
+ <function>pg_connect</function> は、他のPostgreSQL関数で必要とさ
+ れる接続リソースを返します。
+ </para>
+ <para>
+ <function>pg_connect</function>は、
+ <parameter>connection_string</parameter>で指定したPostgreSQLデー
+
+タベースへの接続をオープンします。この関数は、成功時に接続リソー
+
+スを返します。接続できなかった場合には、&false;が返されます。
+ <parameter>connection_string</parameter>は、引用符で括った文字列
+ とする必要があります。
<example>
- <title><function>pg_connect</function>の引数の使用法</title>
+ <title><function>pg_connect</function>の使用法</title>
<programlisting role="php">
-<?php
-$dbconn = pg_Connect ("dbname=mary");
+<![CDATA[
+<?php
+$dbconn = pg_connect ("dbname=mary");
// "mary"という名前のデータベースに接続
-$dbconn2 = pg_Connect ("host=localhost port=5432 dbname=mary");
+$dbconn2 = pg_connect ("host=localhost port=5432 dbname=mary");
//
"localhost"のポート"5432"にて"mary"という名前のデータベースに接続
-$dbconn3 = pg_Connect ("host=sheep port=5432 dbname=mary user=lamb password=baaaa");
-// ユーザ名とパスワードを指定して "mary"
という名前のデータベースに接続
-// ホストで"sheep" でユーザ名とパスワードを入れて接続し、
-// "mary" という名前のデータベースに接続。
-
+$dbconn3 = pg_connect ("host=sheep port=5432 dbname=mary user=lamb password=baaaa");
+//
+ユーザ名とパスワードを指定してホスト"sheep"上の"mary"という名前のデー
+// タベースに接続
+$conn_string = "host=sheep port=5432 dbname=test user=lamb password=bar";
+$dbconn4 = pg_connect ($conn_string);
+//
+ユーザ名とパスワードを指定してホスト"sheep"上の"test"という名前のデー
+// タベースへ接続
?>
- </programlisting>
+]]>
+ </programlisting>
</example>
- 利用可能な引数には、<parameter>dbname</parameter>
- <parameter>port</parameter>, <parameter>host</parameter>,
- <parameter>tty</parameter>, <parameter>options</parameter>,
- <parameter>user</parameter>, <parameter>password</parameter>があ
- ります。
- </para>
- <para>
-
この関数は、他のPostgreSQL関数を発行する際に必要な接続IDを返しま
-
す。一度に複数のコネクションをオープンすることができます。
+ <parameter>connection_string</parameter>で利用可能な引数には、
+ <parameter>dbname</parameter>, <parameter>port</parameter>,
+ <parameter>host</parameter>, <parameter>tty</parameter>,
+ <parameter>options</parameter>, <parameter>user</parameter>,
+ <parameter>password</parameter>が含まれます。
+ </para>
+ <para>
+ 同じ<parameter>connection_string</parameter>引数で2回
+
+<function>pg_connect</function>関数がコールされた場合、新規の接続
+
+はオープンされません。代わりに既にオープンされている接続リソース
+
+が返されます。異なる接続パラメータ(すなわち別のユーザ名)を使用す
+
+る場合には、同じデータベースに対して複数の接続をオープンすること
+ が可能です。
</para>
<para>
- 以前の構文:
- <command>$conn = pg_connect ("host", "port", "options", "tty",
- "dbname")
+ 複数のパラメータをサポートする構文:
+ <command>$conn = pg_connect ("host", "port", "options", "tty", "dbname")
</command>
- は推奨されません。
+ は過去のものであり、推奨されません。
</para>
<para>
- <function>pg_pconnect</function>も参照下さい。
+ <function>pg_pconnect</function>,
+ <function>pg_close</function>, <function>pg_host</function>,
+ <function>pg_port</function>, <function>pg_tty</function>,
+ <function>pg_options</function>, <function>pg_dbname</function>
+ も参照下さい。
</para>
</refsect1>
</refentry>
@@ -260,7 +320,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>string <function>pg_dbname</function></funcdef>
- <paramdef>int <parameter>connection</parameter></paramdef>
+ <paramdef>resource <parameter>connection</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -281,9 +341,7 @@
<funcprototype>
<funcdef>bool <function>pg_end_copy</function></funcdef>
<paramdef>resource
- <parameter>
- <replaceable><optional>connection</optional></replaceable>
- </parameter>
+ <parameter><optional>connection</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
@@ -304,14 +362,14 @@
<refentry id="function.pg-errormessage">
<refnamediv>
<refname>pg_errormessage</refname>
- <refpurpose>エラーメッセージの取得</refpurpose>
+ <refpurpose>直近のエラーメッセージ文字列を取得する</refpurpose>
</refnamediv>
<refsect1>
<title>説明</title>
<funcsynopsis>
<funcprototype>
<funcdef>string <function>pg_errormessage</function></funcdef>
- <paramdef>int <parameter>connection</parameter></paramdef>
+ <paramdef>resource <parameter>connection</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -334,8 +392,8 @@
<title>説明</title>
<funcsynopsis>
<funcprototype>
- <funcdef>int <function>pg_exec</function></funcdef>
- <paramdef>int <parameter>connection</parameter></paramdef>
+ <funcdef>resource <function>pg_exec</function></funcdef>
+ <paramdef>resource <parameter>connection</parameter></paramdef>
<paramdef>string <parameter>query</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -369,12 +427,10 @@
<funcsynopsis>
<funcprototype>
<funcdef>array <function>pg_fetch_array</function></funcdef>
- <paramdef>int <parameter>result</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
<paramdef>int <parameter>row</parameter></paramdef>
<paramdef>int
- <parameter>
- <replaceable><optional>result_type</optional></replaceable>
- </parameter>
+ <parameter><optional>result_type</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
@@ -409,25 +465,27 @@
<example>
<title>PostgreSQLによる配列の取得</title>
<programlisting role="php">
-<?php
-$conn = pg_pconnect ("","","","","publisher");
+ <![CDATA[
+<?php
+$conn = pg_pconnect ("dbname=publisher");
if (!$conn) {
- echo "An error occured.\n";
+ echo "エラーが発生しました。\n";
exit;
}
$result = pg_exec ($conn, "SELECT * FROM authors");
if (!$result) {
- echo "An error occured.\n";
+ echo "エラーが発生しました。\n";
exit;
}
-$arr = pg_fetch_array ($result, 0);
-echo $arr[0] . " <- array\n";
+$arr = pg_fetch_array ($result, 0, PGSQL_NUM);
+echo $arr[0] . " <- array\n";
-$arr = pg_fetch_array ($result, 1);
-echo $arr["author"] . " <- array\n";
+$arr = pg_fetch_array ($result, 1, PGSQL_ASSOC);
+echo $arr["author"] . " <- array\n";
?>
+]]>
</programlisting>
</example>
</refsect1>
@@ -443,12 +501,10 @@
<funcsynopsis>
<funcprototype>
<funcdef>object <function>pg_fetch_object</function></funcdef>
- <paramdef>int <parameter>result</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
<paramdef>int <parameter>row</parameter></paramdef>
<paramdef>int
- <parameter>
- <replaceable><optional>result_type</optional></replaceable>
- </parameter>
+ <parameter><optional>result_type</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
@@ -484,43 +540,47 @@
<example>
<title>Postgres によりオブジェクトを取得する</title>
<programlisting role="php">
-<?php
+<![CDATA[
+<?php
$database = "verlag";
-$db_conn = pg_connect ("localhost", "5432", "", "", $database);
+$db_conn = pg_connect ("host=localhost port=5432 dbname=$database");
if (!$db_conn): ?>
- <H1>Failed connecting to postgres database <? echo $database ?></H1>
<?php
+ <H1>Failed connecting to postgres database <? echo $database ?></H1> <?php
exit;
endif;
$qu = pg_exec ($db_conn, "SELECT * FROM verlag ORDER BY autor");
$row = 0; //
Postgresでは他のデータベースと異なり、行カウンタが必要
-while ($data = pg_fetch_object ($qu, $row)):
+while ($data = pg_fetch_object ($qu, $row)) {
echo $data->autor." (";
echo $data->jahr ."): ";
- echo $data->titel."<BR>";
+ echo $data->titel."<BR>";
$row++;
-endwhile; ?>
-
-<PRE><?php
+}
+?>
+<PRE>
+<?php
$fields[] = Array ("autor", "Author");
$fields[] = Array ("jahr", " Year");
$fields[] = Array ("titel", " Title");
$row= 0; //
Postgresでは他のデータベースと異なり、行カウンタが必要
-while ($data = pg_fetch_object ($qu, $row)):
+while ($data = pg_fetch_object ($qu, $row)) {
echo "----------\n";
reset ($fields);
while (list (,$item) = each ($fields)):
echo $item[1].": ".$data->$item[0]."\n";
endwhile;
$row++;
-endwhile;
+}
echo "----------\n"; ?>
-</PRE> <?php
-pg_freeResult ($qu);
+</PRE>
+<?php
+pg_freeresult ($qu);
pg_close ($db_conn);
?>
+]]>
</programlisting>
</example>
</para>
@@ -537,7 +597,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>array <function>pg_fetch_row</function></funcdef>
- <paramdef>int <parameter>result</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
<paramdef>int <parameter>row</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -556,8 +616,9 @@
<example>
<title>Postgresにより行を取得する</title>
<programlisting role="php">
-<?php
-$conn = pg_pconnect("","","","","publisher");
+<![CDATA[
+<?php
+$conn = pg_pconnect ("dbname=publisher");
if (!$conn) {
echo "An error occured.\n";
exit;
@@ -571,18 +632,19 @@
$num = pg_numrows($result);
-for ($i=0; $i<$num; $i++) {
+for ($i=0; $i < $num; $i++) {
$r = pg_fetch_row($result, $i);
- for ($j=0; $j<count($r); $j++) {
- echo "$r[$j]&nbsp;";
+ for ($j=0; $j < count($r); $j++) {
+ echo "$r[$j] ";
}
- echo "<BR>";
+ echo "<BR>";
}
?>
+]]>
</programlisting>
</example>
</para>
@@ -599,7 +661,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_fieldisnull</function></funcdef>
- <paramdef>int <parameter>result_id</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
<paramdef>int <parameter>row</parameter></paramdef>
<paramdef>mixed <parameter>field</parameter></paramdef>
</funcprototype>
@@ -622,7 +684,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>string <function>pg_fieldname</function></funcdef>
- <paramdef>int <parameter>result_id</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
<paramdef>int <parameter>field_number</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -644,7 +706,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_fieldnum</function></funcdef>
- <paramdef>int <parameter>result_id</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
<paramdef>string <parameter>field_name</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -666,7 +728,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_fieldprtlen</function></funcdef>
- <paramdef>int <parameter>result_id</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
<paramdef>int <parameter>row_number</parameter></paramdef>
<paramdef>string <parameter>field_name</parameter></paramdef>
</funcprototype>
@@ -692,7 +754,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_fieldsize</function></funcdef>
- <paramdef>int <parameter>result_id</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
<paramdef>int <parameter>field_number</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -718,7 +780,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>string <function>pg_fieldtype</function></funcdef>
- <paramdef>int <parameter>result_id</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
<paramdef>int <parameter>field_number</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -740,7 +802,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_freeresult</function></funcdef>
- <paramdef>int <parameter>result_id</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -765,7 +827,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_getlastoid</function></funcdef>
- <paramdef>int <parameter>result_id</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -789,7 +851,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>string <function>pg_host</function></funcdef>
- <paramdef>int <parameter>connection_id</parameter></paramdef>
+ <paramdef>resource <parameter>connection</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -799,6 +861,49 @@
</refsect1>
</refentry>
+
+ <refentry id="function.pg-last-notice">
+ <refnamediv>
+ <refname>pg_last_notice</refname>
+ <refpurpose>
+ PostgreSQLサーバからの直近の通知メッセージを返す
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>説明</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>pg_last_notice</function></funcdef>
+ <paramdef>resource <parameter>connection</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ <function>pg_last_notice</function> returns the last notice
+ message from PostgreSQL server specified by
+ <parameter>connection</parameter>. PostgreSQL server set notice
+ message when transaction cannot be continued. There one can avoid
+ issuing useless SQL using <function>pg_exec</function> using
+ <function>pg_last_notice</function>. There are other cases that
+ PostgreSQL server sets notice message. Programmer must check
+ contents of notice message if it is related to transaction or
+ not.
+ </para>
+ <warning>
+ <para>
+ This function is EXPERIMENTAL and it is not fully implemented
+ yet. <function>pg_last_notice</function> is added form PHP
+ 4.0.6. However, PHP 4.0.6 has problem with notice message
+ handling. Use of PostgreSQL module with PHP 4.0.6 is not
+ recommended even if you are not using
+ <function>pg_last_notice</function>.
+ </para>
+ </warning>
+ <para>
+ See also <function>pg_exec</function> and <function>pg_errormessage</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
<refentry id="function.pg-loclose">
<refnamediv>
<refname>pg_loclose</refname>
@@ -808,14 +913,15 @@
<title>説明</title>
<funcsynopsis>
<funcprototype>
- <funcdef>void <function>pg_loclose</function></funcdef>
- <paramdef>int <parameter>fd</parameter></paramdef>
+ <funcdef>bool <function>pg_loclose</function></funcdef>
+ <paramdef>resource <parameter>large_object</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
<function>pg_loclose</function>は転置ラージオブジェクトをクローズします。
- <parameter>fd</parameter>は、<function>pg_loopen</function>でオープン
- されたラージオブジェクトのファイル識別子です。
+ <parameter>large_object</parameter>は、
+ <function>pg_loopen</function>でオープンされたラージオブジェクト
+ のリソースです。
</para>
</refsect1>
</refentry>
@@ -830,7 +936,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_locreate</function></funcdef>
- <paramdef>int <parameter>conn</parameter></paramdef>
+ <paramdef>resource <parameter>connection</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -856,11 +962,9 @@
<funcprototype>
<funcdef>bool <function>pg_loexport</function></funcdef>
<paramdef>int <parameter>oid</parameter></paramdef>
- <paramdef>int <parameter>file</parameter></paramdef>
- <paramdef>int
- <parameter>
- <replaceable><optional>connection_id</optional></replaceable>
- </parameter>
+ <paramdef>string <parameter>pathname</parameter></paramdef>
+ <paramdef>resource
+ <parameter><optional>connection</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
@@ -884,13 +988,9 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_loimport</function></funcdef>
- <paramdef>int
- <parameter>file</parameter>
- </paramdef>
- <paramdef>int
- <parameter>
- <replaceable><optional>connection_id</optional></replaceable>
- </parameter>
+ <paramdef>string <parameter>pathname</parameter></paramdef>
+ <paramdef>resource
+ <parameter><optional>connection</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
@@ -914,9 +1014,9 @@
<title>説明</title>
<funcsynopsis>
<funcprototype>
- <funcdef>int <function>pg_loopen</function></funcdef>
- <paramdef>int <parameter>conn</parameter></paramdef>
- <paramdef>int <parameter>objoid</parameter></paramdef>
+ <funcdef>resource <function>pg_loopen</function></funcdef>
+ <paramdef>resource <parameter>connection</parameter></paramdef>
+ <paramdef>int <parameter>oid</parameter></paramdef>
<paramdef>string <parameter>mode</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -943,7 +1043,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>string <function>pg_loread</function></funcdef>
- <paramdef>int <parameter>fd</parameter></paramdef>
+ <paramdef>resource <parameter>large_object</parameter></paramdef>
<paramdef>int <parameter>len</parameter></paramdef>
</funcprototype>
</funcsynopsis>
@@ -966,8 +1066,8 @@
<title>説明</title>
<funcsynopsis>
<funcprototype>
- <funcdef>void <function>pg_loreadall</function></funcdef>
- <paramdef>int <parameter>fd</parameter></paramdef>
+ <funcdef>int <function>pg_loreadall</function></funcdef>
+ <paramdef>resource <parameter>large_object</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -988,9 +1088,9 @@
<title>説明</title>
<funcsynopsis>
<funcprototype>
- <funcdef>void <function>pg_lounlink</function></funcdef>
- <paramdef>int <parameter>conn</parameter></paramdef>
- <paramdef>int <parameter>lobjid</parameter></paramdef>
+ <funcdef>bool <function>pg_lounlink</function></funcdef>
+ <paramdef>resource <parameter>connection</parameter></paramdef>
+ <paramdef>int <parameter>oid</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -1011,8 +1111,8 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_lowrite</function></funcdef>
- <paramdef>int <parameter>fd</parameter></paramdef>
- <paramdef>string <parameter>buf</parameter></paramdef>
+ <paramdef>resource <parameter>large_object</parameter></paramdef>
+ <paramdef>string <parameter>data</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -1035,7 +1135,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_numfields</function></funcdef>
- <paramdef>int <parameter>result_id</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -1060,7 +1160,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_numrows</function></funcdef>
- <paramdef>int <parameter>result_id</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -1085,7 +1185,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>string <function>pg_options</function></funcdef>
- <paramdef>int <parameter>connection_id</parameter></paramdef>
+ <paramdef>resource <parameter>connection</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -1105,8 +1205,8 @@
<title>説明</title>
<funcsynopsis>
<funcprototype>
- <funcdef>int <function>pg_pconnect</function></funcdef>
- <paramdef>string <parameter>conn_string</parameter></paramdef>
+ <funcdef>resource <function>pg_pconnect</function></funcdef>
+ <paramdef>string <parameter>connection_string</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -1146,7 +1246,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_port</function></funcdef>
- <paramdef>int <parameter>connection_id</parameter></paramdef>
+ <paramdef>resource <parameter>connection</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -1169,9 +1269,7 @@
<funcprototype>
<funcdef>bool <function>pg_put_line</function></funcdef>
<paramdef>resource
- <parameter>
- <replaceable><optional>connection_id</optional></replaceable>
- </parameter>
+ <parameter><optional>connection</optional></parameter>
</paramdef>
<paramdef>string <parameter>data</parameter></paramdef>
</funcprototype>
@@ -1220,9 +1318,9 @@
<funcsynopsis>
<funcprototype>
<funcdef>mixed <function>pg_result</function></funcdef>
- <paramdef>int <parameter>result_id</parameter></paramdef>
+ <paramdef>resource <parameter>result</parameter></paramdef>
<paramdef>int <parameter>row_number</parameter></paramdef>
- <paramdef>mixed <parameter>fieldname</parameter></paramdef>
+ <paramdef>mixed <parameter>field</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -1257,10 +1355,8 @@
<funcsynopsis>
<funcprototype>
<funcdef>int <function>pg_set_client_encoding</function></funcdef>
- <paramdef>int
- <parameter>
- <replaceable><optional>connection</optional></replaceable>
- </parameter>
+ <paramdef>resource
+ <parameter><optional>connection</optional></parameter>
</paramdef>
<paramdef>string <parameter>encoding</parameter></paramdef>
</funcprototype>
@@ -1304,10 +1400,8 @@
<funcsynopsis>
<funcprototype>
<funcdef>string <function>pg_client_encoding</function></funcdef>
- <paramdef>int
- <parameter>
- <replaceable><optional>connection</optional></replaceable>
- </parameter>
+ <paramdef>resource
+ <parameter><optional>connection</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
@@ -1352,10 +1446,8 @@
<replaceable><optional>mode</optional></replaceable>
</parameter>
</paramdef>
- <paramdef>int
- <parameter>
- <replaceable><optional>connection</optional></replaceable>
- </parameter>
+ <paramdef>resource
+ <parameter><optional>connection</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
@@ -1396,7 +1488,7 @@
<funcsynopsis>
<funcprototype>
<funcdef>string <function>pg_tty</function></funcdef>
- <paramdef>int <parameter>connection_id</parameter></paramdef>
+ <paramdef>resource <parameter>connection</parameter></paramdef>
</funcprototype>
</funcsynopsis>
<para>
@@ -1418,10 +1510,8 @@
<funcsynopsis>
<funcprototype>
<funcdef>bool <function>pg_untrace</function></funcdef>
- <paramdef>int
- <parameter>
- <replaceable><optional>connection</optional></replaceable>
- </parameter>
+ <paramdef>resource
+ <parameter><optional>connection</optional></parameter>
</paramdef>
</funcprototype>
</funcsynopsis>
