archived-doc-ja/reference/pdo_odbc/reference.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: c39225b6dd23f358824f44f5b8c733517b11830b Maintainer: takagi Status: ready -->
<!-- Credits: mumumu -->

 <reference xml:id="ref.pdo-odbc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <?phpdoc extension-membership="bundledexternal" ?>
  <title>ODBC and DB2 PDO ドライバ (PDO_ODBC)</title>
  <titleabbrev>ODBC and DB2 PDO ドライバ</titleabbrev>
  <partintro>

   <section xml:id="ref.pdo-odbc.intro">
   &reftitle.intro;
    <para>
     PDO_ODBC は <link linkend="intro.pdo">PHP
     Data Objects (PDO) インターフェイス</link>を実装したドライバで、
     PHP から ODBC ドライバあるいは
     IBM DB2 Call Level Interface (DB2 CLI) ライブラリを使用した
     データベースへのアクセスが可能となります。
     PDO_ODBC は、現在 3 種類のデータベースドライバをサポートしています。
     <variablelist>
      <varlistentry>
       <term>ibm-db2</term>
       <listitem>
        <para>
         フリーの DB2 express-C クライアントを使用した、
         IBM DB2 Universal Database、Cloudscape および Apache
         Derby サーバーへのアクセスをサポートします。
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>unixODBC</term>
       <listitem>
        <para>
         unixODBC ドライバマネージャおよびデータベースごとの ODBC
         ドライバを使用した、データベースサーバーへのアクセスをサポートします。
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>generic</term>
       <listitem>
        <para>
         PDO_ODBC が明示的にサポートしていない ODBC
         ドライバマネージャのためのコンパイルオプションを提供します。
        </para>
       </listitem>
      </varlistentry>
     </variablelist>
    </para>
    <para>
     Windows では、<filename>php_pdo_odbc.dll</filename>
     を拡張モジュールとして &php.ini; で有効にする必要があります。
     これは Windows ODBC ドライバマネージャに対してリンクされており、
     システムの DSN に登録されているあらゆるデータベースに対して
     PHP から接続することができます。
    </para>
   </section>

   <!-- Information found in configure.xml -->
   &reference.pdo-odbc.configure;
   <!-- Information found in constants.xml -->
   &reference.pdo-odbc.constants;
   <!-- Information found in ini.xml -->
   &reference.pdo-odbc.ini;
  </partintro>

  <refentry xml:id="ref.pdo-odbc.connection">
   <refnamediv>
    <refname>PDO_ODBC DSN</refname>
    <refpurpose>ODBC あるいは DB2 データベースに接続する</refpurpose>
   </refnamediv>

   <refsect1 role="description">
    &reftitle.description;
    <para>
     PDO_ODBC データソース名 (DSN) は以下の要素で構成されます。
     <variablelist>
      <varlistentry>
       <term>DSN 接頭辞</term>
       <listitem>
        <para>
        DSN 接頭辞は <userinput>odbc:</userinput> です。
        ODBC ドライバマネージャや DB2 カタログに登録されている
        データベースに接続する際には、登録されている名前を
        DSN に追加することができます。
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>DSN</term>
       <listitem>
        <para>
         ODBC ドライバマネージャあるいは DB2 カタログに登録されている
         データベース名を指定します。それ以外の方法として、
         <link xlink:href="&url.connectionstrings;">&url.connectionstrings;</link>
         で説明されている完全な ODBC 接続文字列を使用して
         データベースに接続することもできます。
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term><literal>UID</literal></term>
       <listitem>
        <para>
         接続に使用するユーザーの名前を指定します。DSN
         にユーザー名を指定した場合は、PDO はコンストラクタの引数で指定された
         ユーザー名を無視します。
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term><literal>PWD</literal></term>
       <listitem>
        <para>
         接続するユーザーのパスワードを指定します。DSN
         にパスワードを指定した場合は、PDO はコンストラクタの引数で指定された
         パスワードを無視します。
        </para>
       </listitem>
      </varlistentry>
     </variablelist>
    </para>
   </refsect1>

   <refsect1 role="changelog">
    &reftitle.changelog;
    <informaltable>
     <tgroup cols="2">
      <thead>
       <row>
        <entry>&Version;</entry>
        <entry>&Description;</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>8.4.0</entry>
        <entry>
         PDO のコンストラクタに対してパスワード引数に空文字列を渡した場合、
         今までは作成される接続文字列に <literal>pwd</literal>
         は含まれませんでした。このバージョンから、<literal>pwd</literal>
         は空文字列として含まれるように挙動が変更されました。
         PDO のコンストラクタのパスワード引数に &null; を渡した場合の挙動は、
         以前と同じです。
        </entry>
       </row>
       <row>
        <entry>8.4.0</entry>
        <entry>
         DSN に <literal>uid</literal> または <literal>pwd</literal>
         が含まれている際には、
         PDO のコンストラクタに name 引数と password 引数を別々に渡した場合に、
         それらが無視されるように挙動が変更されました。
         これより前のバージョンでは、
         DSN に <literal>uid</literal> または <literal>pwd</literal>
         が含まれている場合にだけ、
         PDO のコンストラクタに name 引数と password 引数を両方渡した場合に、
         それらが無視されていました。
        </entry>
       </row>
      </tbody>
     </tgroup>
    </informaltable>
   </refsect1>

   <refsect1 role="examples">
    &reftitle.examples;
    <para>
     <example>
      <title>PDO_ODBC DSN の例 (ODBC ドライバマネージャ)</title>
      <para>
       以下の例は、ODBC ドライバマネージャで testdb
       として登録されている ODBC データベースに接続するための
       PDO_ODBC DSN を表します。
      </para>
      <programlisting><![CDATA[
odbc:testdb
]]>
      </programlisting>
     </example>
     <example>
      <title>PDO_ODBC DSN の例 (IBM DB2 非カタログ接続)</title>
      <para>
       以下の例は、完全な ODBC DSN 構文を使用して
       <userinput>SAMPLE</userinput> という名前の
       IBM DB2 データベースに接続するための
       PDO_ODBC DSN を表します。
      </para>
      <programlisting><![CDATA[
odbc:DRIVER={IBM DB2 ODBC DRIVER};HOSTNAME=localhost;PORT=50000;DATABASE=SAMPLE;PROTOCOL=TCPIP;UID=db2inst1;PWD=ibmdb2;
]]>
      </programlisting>
     </example>
     <example>
      <title>PDO_ODBC DSN の例 (Microsoft Access 非カタログ接続)</title>
      <para>
       以下の例は、完全な ODBC DSN 構文を使用して
       <userinput>C:\db.mdb</userinput> にある
       Microsoft Access データベースに接続するための
       PDO_ODBC DSN を表します。
      </para>
      <programlisting><![CDATA[
odbc:Driver={Microsoft Access Driver (*.mdb)};Dbq=C:\\db.mdb;Uid=Admin
]]>
      </programlisting>
     </example>
     
    </para>
   </refsect1>
  </refentry>

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