<?xml version="1.0" encoding="utf-8"?>

<!-- $Revision$ -->

<!-- EN-Revision: 3c1bec9d700807df36994cf368ba291214cd424d Maintainer: shimooka Status: ready -->

<reference xml:id="ref.pdo-pgsql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<?phpdoc extension-membership="bundledexternal" ?>

<title>PostgreSQL PDO ドライバ (PDO_PGSQL)</title>

<titleabbrev>PostgreSQL PDO ドライバ</titleabbrev>

<partintro>

<section xml:id="ref.pdo-pgsql.intro">

&reftitle.intro;

<para>

PDO_PGSQL は、PHP から PostgreSQL

データベースへのアクセスを可能にするための

<link linkend="intro.pdo">PHP Data

Objects (PDO) インターフェイス</link> を実装したドライバです。

</para>

</section>

<section xml:id="ref.pdo-pgsql.resources">

&reftitle.resources;

<para>

この拡張モジュールでは、ストリームリソースを定義しています。これは

<function>PDO::pgsqlLOBOpen</function> が返すものです。

</para>

</section>

&reference.pdo-pgsql.configure;

&reference.pdo-pgsql.constants;

<section xml:id="ref.pdo-pgsql.general-notes">

<title>General notes</title>

<note>

<para>

<literal>bytea</literal> フィールドはストリームとして返されます。

</para>

</note>

</section>

</partintro>

<refentry xml:id="ref.pdo-pgsql.connection">

<refnamediv>

<refname>PDO_PGSQL DSN</refname>

<refpurpose>PostgreSQL データベースに接続する</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<para>

PDO_PGSQL データソース名 (DSN) は以下の要素で構成され、

スペースあるいはセミコロンで区切られます:

<variablelist>

<varlistentry>

<term>DSN 接頭辞</term>

<listitem>

<para>

DSN 接頭辞は <userinput>pgsql:</userinput> です。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>host</literal></term>

<listitem>

<para>

データベースサーバーが存在するホスト名を指定します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>port</literal></term>

<listitem>

<para>

データベースサーバーが起動しているポートを指定します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>dbname</literal></term>

<listitem>

<para>

データベース名を指定します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>user</literal></term>

<listitem>

<para>

接続するユーザー名を指定します。もし DSN でユーザー名を指定する場合、

PDO は PDO コンストラクタにおけるユーザー名引数の値を無視します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>password</literal></term>

<listitem>

<para>

接続するユーザーのパスワードを指定します。もし DSN

でパスワードを指定する場合、

PDO は PDO コンストラクタにおけるパスワード引数の値を無視します。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>sslmode</literal></term>

<listitem>

<para>

SSLモード。サポートされている値とその意味については、

<link xlink:href="&url.pgsql.manual;">PostgreSQL Documentation</link>

を参照ください。

</para>

</listitem>

</varlistentry>

</variablelist>

<note>

<simpara>

DSN 文字列における全てのセミコロンは、スペースで置き換えられます。

なぜなら、PostgreSQL はそのように置き換えられたフォーマットを期待しているからです。

このことは、DSN におけるあらゆるコンポーネント

(例: <literal>password</literal> や <literal>dbname</literal>)

で、セミコロンはサポートされていないということです。

</simpara>

</note>

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>PDO_PGSQL DSN の例</title>

<para>

以下の例は、PostgreSQL データベースに接続するための PDO_PGSQL DSN

を示します:

<programlisting>

<![CDATA[

pgsql:host=localhost;port=5432;dbname=testdb;user=bruce;password=mypass

]]>

</programlisting>

</para>

<para>

以下の例は、unix ソケット経由で PostgreSQL データベースに接続するための PDO_PGSQL DSN

を示します:

<programlisting>

<![CDATA[

pgsql:host=/tmp;port=5432;dbname=testdb;user=bruce;password=mypass

]]>

</programlisting>

</para>

</example>

</para>

</refsect1>

</refentry>

&reference.pdo-pgsql.entities.pdo-overloaded;

</reference>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:1

sgml-indent-data:t

indent-tabs-mode:nil

sgml-parent-document:nil

sgml-default-dtd-file:"~/.phpdoc/manual.ced"

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

vim600: syn=xml fen fdm=syntax fdl=2 si

vim: et tw=78 syn=sgml

vi: ts=1 sw=1

-->