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

<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1634a886415d0ab4df195fe49d18a1c150b70758 Maintainer: shimooka Status: ready -->

 <reference xml:id="ref.pdo-sqlite" xmlns="http://docbook.org/ns/docbook">
  <?phpdoc extension-membership="bundledexternal" ?>
  <title>SQLite 関数 (PDO_SQLITE)</title>
  <titleabbrev>SQLite (PDO)</titleabbrev>
  <partintro>

   <section xml:id="pdo-sqlite.intro">
   &reftitle.intro;
    <para>
     PDO_SQLITE は、PHP から SQLite 2 や SQLite 3
     データベースへのアクセスを可能にするための <link linkend="intro.pdo">PHP
     Data Objects (PDO) インターフェイス</link> を実装したドライバです。
    </para>
    <para>
     PHP 5.1 では、<link linkend="ref.sqlite">SQLite</link>
     拡張モジュールも SQLite 2 データベースに対するドライバを提供しています。
     これは厳密には PDO_SQLITE ドライバの一部ではありませんが、
     同じような動きをするので一緒に説明します。PDO 用 SQLite 2 ドライバは主に
     レガシーな SQLite 2 データベースファイルをより高速でより効果的な
     SQLite 3 ドライバを使用するアプリケーションへ
     簡単にインポートするために提供されています。
     結果として、SQLite 2 ドライバは SQLite 3
     ドライバよりも機能豊富ではありません。
    </para>
    <note>
     <para>
      PDO_SQLITE は、文字列と
      <constant>PDO::PARAM_LOB</constant> のストリームを区別して使うことができます。
     </para>
    </note>
   </section>

   &reference.pdo-sqlite.configure;

  </partintro>

  <refentry xml:id="ref.pdo-sqlite.connection">
   <refnamediv>
    <refname>PDO_SQLITE DSN</refname>
    <refpurpose>SQLite データベースに接続する</refpurpose>
   </refnamediv>

   <refsect1 role="description">
    &reftitle.description;
    <para>
     PDO_SQLITE データソース名 (DSN) は以下の要素で構成されます:
     <variablelist>
      <varlistentry>
       <term>DSN 接頭辞 (SQLite 3)</term>
       <listitem>
        <para>
         DSN 接頭辞は <userinput>sqlite:</userinput> です。
         <itemizedlist>
          <listitem>
           <para>
            ディスク上のデータベースにアクセスするには、
            DSN 接頭辞に絶対パスを付加してください。
           </para>
          </listitem>
          <listitem>
           <para>
            メモリ内にデータベースを生成するには、
            DSN 接頭辞に <literal>:memory:</literal> を付加してください。
           </para>
          </listitem>
         </itemizedlist>
        </para>
       </listitem>
      </varlistentry>
      <varlistentry>
       <term>DSN 接頭辞 (SQLite 2)</term>
       <listitem>
        <para>
         PHP 5.1 における <link linkend="ref.sqlite">SQLite</link>
         拡張モジュールは SQLite 2 データベースへのアクセスと生成機能を
         サポートする PDO ドライバを提供しています。
         これにより、PHP
         の以前のバージョンにおける <link linkend="ref.sqlite">SQLite</link>
         拡張を用いて生成したデータベースにアクセスすることが可能です。
        </para>
        <note>
         <para>
          SQLite 2 ドライバは PDO と ext/sqlite を有効にした場合、
          PHP 5.1.x でのみ利用可能です。現時点では PECL
          経由では利用できません。
         </para>
        </note>
        <para>
         SQLite 2 データベースに接続するための DSN 接頭辞は
         <userinput>sqlite2:</userinput> です。
         <itemizedlist>
          <listitem>
           <para>
            ディスク上のデータベースにアクセスするには、
            DSN 接頭辞に絶対パスを付加してください。
           </para>
          </listitem>
          <listitem>
           <para>
            メモリ内にデータベースを生成するには、
            DSN 接頭辞に <literal>memory:</literal> を付加してください。
           </para>
          </listitem>
         </itemizedlist>
        </para>
       </listitem>
      </varlistentry>

     </variablelist>
    </para>
   </refsect1>
   <refsect1 role="examples">
    &reftitle.examples;
    <para>
     <example>
      <title>PDO_SQLITE DSN の例</title>
      <para>
       以下の例は、SQLite データベースへの接続するための PDO_SQLITE DSN
       を表します:
       <programlisting>
<![CDATA[
sqlite:/opt/databases/mydb.sq3
sqlite::memory:
sqlite2:/opt/databases/mydb.sq2
sqlite2::memory:
]]>
       </programlisting>
      </para>
     </example>
    </para>
   </refsect1>
  </refentry>

 &reference.pdo-sqlite.entities.PDO;

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