php-doc-en/reference/pdo/reference.xml

<?xml version='1.0' encoding='iso-8859-1'?>
<!-- $Revision: 1.9 $ -->
<!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. -->
 <reference id="ref.pdo">
  <title>PDO Functions</title>
  <titleabbrev>pdo</titleabbrev>

  <partintro>
   <section id="pdo.intro">
   &reftitle.intro;
    <para>
     &warn.experimental;
     The PDO extension defines a lightweight, consistent interface
     for accessing databases in PHP. Each database driver that
     implements the PDO interface can expose database-specific
     features as regular extension functions. Note that you cannot
     perform any database functions using the PDO extension by
     itself; you must use a <link linkend="pdo.drivers">database-specific
     PDO driver</link> to access a database server.
    </para>
   </section>
   <section id="pdo.installation">
   &reftitle.install;
    <para>
     PDO is currently available as a PECL extension from
     <ulink url='&url.pecl.package;pdo'>&url.pecl.package;pdo</ulink>.
     Ensure you have installed the CGI version of PHP and that the
     <command>pear</command> and <command>phpize</command> scripts are
     available in your current path.
    </para>
    <para>
     Run the following command to download, build, and install the
     latest stable version of PDO:
     <screen>
<![CDATA[
pear install pdo
]]>
     </screen>
    </para>
    <para>
     Windows users can download the extension DLL <filename>php_pdo.dll</filename>
     as part of the PECL collection binaries from
     <ulink url='&url.php.downloads;'>&url.php.downloads;</ulink>.
    </para>
    <para>
     The <command>pear</command> command automatically installs the
     PDO module into your PHP extensions directory. To enable the
     PDO extension on Linux or UNIX operating systems, you must add
     the following line to &php.ini;:
     <screen>
<![CDATA[
extension=pdo.so
]]>
     </screen>
     To enable the PDO extension on Windows operating systems, you must
     add the following line to &php.ini;:
     <screen>
<![CDATA[
extension=php_pdo.dll
]]>
     </screen>
    </para>
   </section>
   <section id="pdo.drivers">
    <title>PDO Drivers</title>
    <para>
     The following drivers currently implement the PDO interface:
     <itemizedlist>
      <listitem>
       <para>
       PDO_FIREBIRD - Firebird/Interbase 6
       </para>
      </listitem>
      <listitem>
       <para>
        PDO_MYSQL - MySQL 3.x/4.0
       </para>
      </listitem>
      <listitem>
       <para>
        PDO_OCI - Oracle Call Interface
       </para>
      </listitem>
      <listitem>
       <para>
        PDO_ODBC - ODBC v3 (IBM DB2 and unixODBC)
       </para>
      </listitem>
      <listitem>
       <para>
        PDO_PGSQL - PostgreSQL
       </para>
      </listitem>
      <listitem>
       <para>
        PDO_SQLITE - SQLite 3.x
       </para>
      </listitem>
     </itemizedlist>
    </para>
   </section>

   <section id='pdo.classes'>
    &reftitle.classes;
    <section id='pdo.class.PDO'>
     <title><classname>PDO</classname></title>
     <para>
      Represents a connection between PHP and a database server.
     </para>
     <section id='pdo.class.PDO.constructor'>
      &reftitle.constructor;
      <itemizedlist>
       <listitem>
        <para><link linkend='function.PDO-construct'>PDO</link> - constructs a new PDO
         object</para>
       </listitem>
      </itemizedlist>
     </section>
     <section id='pdo.class.PDO.methods'>
      &reftitle.methods;
      <itemizedlist>
       <listitem>
        <para><link linkend='function.PDO-beginTransaction'>beginTransaction
        </link> - begins a transaction</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDO-commit'>commit</link> - commits a
         transaction</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDO-exec'>exec</link> - issues an SQL
        statement</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDO-errorCode'>errorCode</link> -
         retrieves an error code, if any, from the database</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDO-errorInfo'>errorInfo</link> -
         retrieves an array of error information, if any, from the
         database</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDO-lastInsertId'>lastInsertId</link> -
         retrieves the value of the last row that was inserted into a
         table</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDO-prepare'>prepare</link> - prepares
         an SQL statement for execution</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDO-rollBack'>rollBack</link> - roll
         back a transaction</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDO-setAttribute'>setAttribute</link> -
         sets a database connection attribute</para>
       </listitem>
      </itemizedlist>
     </section>
    </section>
    <section id='pdo.class.PDOStatement'>
     <title><classname>PDOStatement</classname></title>
     <para>Represents a prepared statement and, after the statement is
      executed, an associated result set.</para>
     <section id='pdo.class.Statement.methods'>
      &reftitle.methods;
      <itemizedlist>
       <listitem>
        <para><link linkend='function.PDOStatement-bindColumn'>bindColumn</link> - binds a
         PHP variable to an output column in a result set</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDOStatement-bindParam'>bindParam</link> - binds a
         PHP variable to a parameter in the prepared statement</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDOStatement-errorCode'>errorCode</link> -
         retrieves an error code, if any, from the statement</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDOStatement-errorInfo'>errorInfo</link> -
         retrieves an array of error information, if any, from the statement</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDOStatement-execute'>execute</link> - executes a
         prepared statement</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDOStatement-fetch'>fetch</link> - fetches a
         row from a result set</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDOStatement-fetchAll'>fetchAll</link> - fetches an
         array containing all of the rows from a result set</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDOStatement-fetchSingle'>fetchSingle</link> - returns
         the data from the first column in a result set</para>
       </listitem>
       <listitem>
        <para><link linkend='function.PDOStatement-rowCount'>rowCount</link> - returns the
         number of rows that were affected by the execution of an SQL statement</para>
       </listitem>
      </itemizedlist>
     </section>
    </section>
   </section>
  &reference.pdo.constants;
  </partintro>
 &reference.pdo.functions;
 </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:"../../../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
-->