<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.pdo-firebird.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ja',
  ),
  'this' => 
  array (
    0 => 'ref.pdo-firebird.connection.php',
    1 => 'PDO_FIREBIRD DSN',
    2 => 'Firebird データベースに接続する',
  ),
  'up' => 
  array (
    0 => 'ref.pdo-firebird.php',
    1 => 'Firebird PDO ドライバ',
  ),
  'prev' => 
  array (
    0 => 'ref.pdo-firebird.php',
    1 => 'Firebird PDO ドライバ',
  ),
  'next' => 
  array (
    0 => 'class.pdo-firebird.php',
    1 => 'Pdo\\Firebird',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ja',
    'path' => 'reference/pdo_firebird/reference.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="ref.pdo-firebird.connection" class="refentry">
   <div class="refnamediv">
    <h1 class="refname">PDO_FIREBIRD DSN</h1>
    <p class="verinfo">(PECL PDO_FIREBIRD &gt;= 0.1.0)</p><p class="refpurpose"><span class="refname">PDO_FIREBIRD DSN</span> &mdash; <span class="dc-title">Firebird データベースに接続する</span></p>

   </div>

   <div class="refsect1 description" id="refsect1-ref.pdo-firebird.connection-description">
    <h3 class="title">説明</h3>
    <p class="para">
     PDO_FIREBIRD データソース名 (DSN) は以下の要素で構成されます。
     <dl>
      
       <dt>DSN 接頭辞</dt>
       <dd>
        <p class="para">
        DSN 接頭辞は <strong class="userinput"><code>firebird:</code></strong> です。
        </p>
       </dd>
      
      
       <dt><code class="literal">dbname</code></dt>
       <dd>
        <p class="para">
         データベース名を指定します。
        </p>
       </dd>
      
      
       <dt><code class="literal">charset</code></dt>
       <dd>
        <p class="para">
         文字セット。
        </p>
       </dd>
      
      
       <dt><code class="literal">role</code></dt>
       <dd>
        <p class="para">
         SQL のロール名。
        </p>
       </dd>
      
      
       <dt><code class="literal">dialect</code></dt>
       <dd>
        <p class="para">
         データベースの方言。<code class="literal">1</code> または <code class="literal">3</code> の値を取ります。
         指定されなかった場合は、デフォルトの <code class="literal">3</code> が使われます。
         PHP 7.4.0 以降で利用可能です。
        </p>
       </dd>
      
     </dl>
    </p>
   </div>

   <div class="refsect1 examples" id="refsect1-ref.pdo-firebird.connection-examples">
    <h3 class="title">例</h3>
    <p class="para">
     <div class="example" id="example-1">
      <p><strong>例1 PDO_FIREBIRD DSN でのパス指定の例</strong></p>
      <div class="example-contents"><p>
       以下の例は、Firebird データベースに接続するための
       PDO_FIREBIRD DSN を表します。
       <div class="example-contents"><div class="cdata"><pre>
firebird:dbname=/path/to/DATABASE.FDB
</pre></div>
       </div>

      </p></div>
     </div>
     <div class="example" id="example-2">
      <p><strong>例2 PDO_FIREBIRD DSN でのポートとパス指定の例</strong></p>
      <div class="example-contents"><p>
       以下の例は、ポートとパスを指定して Firebird データベースに接続するための
       PDO_FIREBIRD DSN を表します。
       <div class="example-contents"><div class="cdata"><pre>
firebird:dbname=hostname/port:/path/to/DATABASE.FDB
</pre></div>
       </div>

      </p></div>
     </div>
     <div class="example" id="example-3">
      <p><strong>例3 PDO_FIREBIRD DSN で Debian システムのローカルホストと employee.fdb へのパスを使う例</strong></p>
      <div class="example-contents"><p>
       以下の例は、ローカルホストの Firebird データベース employee.fdb に接続するための
       PDO_FIREBIRD DSN を表します。
       <div class="example-contents"><div class="cdata"><pre>
firebird:dbname=localhost:/var/lib/firebird/2.5/data/employee.fdb
</pre></div>
       </div>

      </p></div>
     </div>
     <div class="example" id="example-4">
      <p><strong>例4 方言が 1 のデータベースに接続するための PDO_FIREBIRD の DSN</strong></p>
      <div class="example-contents"><p>
       次の例は、方言 1 を使って作られた Firebird データベース test.fdb に対して
       接続するための PDO_FIREBIRD DSN を示しています。
       これは、PHP 7.4.0 以降でのみ利用可能です。
      </p></div>
      <div class="example-contents">
<div class="cdata"><pre>
firebird:dbname=localhost:/var/lib/firebird/2.5/data/test.fdb;charset=utf-8;dialect=1
</pre></div>
</div>

     </div>
    </p>
   </div>

  </div><?php manual_footer($setup); ?>