1
0
mirror of https://github.com/php/doc-ja.git synced 2026-03-24 07:02:08 +01:00
Files
archived-doc-ja/reference/pdo_pgsql/reference.xml
2025-08-30 23:25:12 +09:00

181 lines
5.6 KiB
XML

<?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
-->