cvs: peardoc /ja/package/database/db intro-connect.xml intro-dsn.xml intro-query.xml intro-sequences.xml

From: Date: Tue, 25 Nov 2003 04:21:31 +0000
Subject: cvs: peardoc /ja/package/database/db intro-connect.xml intro-dsn.xml intro-query.xml intro-sequences.xml
Groups: php.pear.doc 
Request: Send a blank email to pear-doc+get-2005@lists.php.net to get a copy of this message
elf Mon Nov 24 23:21:31 2003 EDT Added files: /peardoc/ja/package/database/db intro-connect.xml intro-dsn.xml intro-query.xml intro-sequences.xml Log: o added japanese manual

Index: peardoc/ja/package/database/db/intro-connect.xml +++ peardoc/ja/package/database/db/intro-connect.xml <!-- $Revision: 1.1 $ --> <!-- Sync: 1.5 --> <refentry id="package.database.db.intro-connect"> <refnamediv> <refname>導入 - Connect</refname> <refpurpose>接続および接続の終了</refpurpose> </refnamediv> <refsect1 id="package.database.db.intro-connect.desc"> <title>説明</title> <simpara> データベースに接続する際には、関数<link linkend="package.database.db.db.connect"> <function>DB::connect</function></link>を使用します。 この関数は、有効な<link linkend="package.database.db.intro-dsn">DSN</link> がパラメータとして指定されることを必要とし、 オプション引数として持続的接続かどうかを定義する論理値をとります。 成功時にデータベースクラスの新規インスタンスを取得出来ます。 <link linkend="package.database.db.db.iserror"><function>DB::isError</function></link> によりこの返り値を確認することを強く推奨します。 データベースクラスのインスタンスから接続を切断するには、関数<link linkend="package.database.db.db-common.disconnect"><function>disconnect</function></link> を使用します。 </simpara> <example> <title>Connect and disconnect</title> <programlisting role="php"> <![CDATA[ <?php require_once 'DB.php'; $user = 'foo'; $pass = 'bar'; $host = 'localhost'; $db_name = 'clients_db'; // Data Source Name: これは接続用パラメータ文字列です $dsn = "mysql://$user:$pass@$host/$db_name"; // DB::connect は、成功時にPEAR DBオブジェクト、 // エラーの場合にPEAR DB Errorオブジェクトを返します $db = DB::connect($dsn); // DB::isError により、エラーと有効な接続を区別することが可能です。 if (DB::isError($db)) { die ($db->getMessage()); } .... // データベースとの接続を切断します $db->disconnect(); ?> ]]> </programlisting> </example> </refsect1> </refentry> <!-- 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 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 --> Index: peardoc/ja/package/database/db/intro-dsn.xml +++ peardoc/ja/package/database/db/intro-dsn.xml <!-- $Revision: 1.1 $ --> <!-- Sync: 1.3 --> <!-- Sync: 1.3 --> <refentry id="package.database.db.intro-dsn"> <refnamediv> <refname>Introduction - DSN</refname> <refpurpose>The Data Source Name</refpurpose> </refnamediv> <refsect1 id="package.database.db.intro-dsn.desc"> <title>Description</title> <simpara> PEAR::DBにより、データベースに接続するには、有効な <acronym>DSN - data source name</acronym> を作成する必要があります。 このDSNは、以下の要素からなります。 </simpara> <para> <simplelist> <member> <parameter>phptype</parameter>: PHPで使用されるデータベースバックエンド。 (すなわち<parameter>mysql</parameter>や<parameter>odbc</parameter>等) </member> <member> <parameter>dbsyntax</parameter>: SQL構文等のデータベース関連構文。 </member> <member> <parameter>protocol</parameter>: 使用する通信プロトコル。 (すなわち、<parameter>tcp</parameter>や<parameter>unix</parameter>等) </member> <member> <parameter>hostspec</parameter>: ホスト指定。 (<parameter>hostname[:port]</parameter>) </member> <member> <parameter>database</parameter>: DBMSサーバ上のデータベース使用方法。 </member> <member> <parameter>username</parameter>: ログイン用ユーザ名。 </member> <member> <parameter>password</parameter>: ログイン用のパスワード。 </member> <member> <parameter>proto_opts</parameter>: <parameter>protocol</parameter>で使用されるオプション。 </member> </simplelist> </para> <para> 以下のように多くのバリエーションが許されています。 <programlisting role="url"> phptype(dbsyntax)://username:password@protocol+hostspec/database </programlisting> Most variations are allowed: <programlisting role="url"> phptype://username:password@protocol+hostspec:110//usr/db_file.db phptype://username:password@hostspec/database_name phptype://username:password@hostspec phptype://username@hostspec phptype://hostspec/database phptype://hostspec phptype(dbsyntax) phptype </programlisting> 現在、サポートされているデータベースバックエンドは、 以下のとおりになります。 <programlisting role="configure"> mysql -> MySQL pgsql -> PostgreSQL ibase -> InterBase msql -> Mini SQL mssql -> Microsoft SQL Server oci8 -> Oracle 7/8/8i odbc -> ODBC (Open Database Connectivity) sybase -> SyBase ifx -> Informix fbsql -> FrontBase </programlisting> </para> <para> 最新版の<classname>DB</classname>では、 第2のDSN形式を使用すること が可能です。 <programlisting role="url"> phptype(syntax)://user:pass@protocol(proto_opts)/database </programlisting> <example> <title>ソケットによりデータベースに接続する</title> <programlisting role="url"> mysql://user@unix(/path/to/socket)/pear </programlisting> </example> <example> <title>標準以外のポートでデータベースに接続する</title> <programlisting role="url"> pgsql://user:pass@word@tcp(localhost:5555)/pear </programlisting> </example> </para> <warning> <para> いくつかの機能は、 全てのデータベースバックエンドでサポートされていません。 どの機能がどのバックエンドでサポートされているかに関する詳細なリストを 取得するには <filename>&lt;pear base dir&gt;/DB/STATUS</filename> にあるPEAR DB拡張 のステータスドキュメントを参照して下さい。 </para> </warning> </refsect1> </refentry> <!-- 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 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 --> Index: peardoc/ja/package/database/db/intro-query.xml +++ peardoc/ja/package/database/db/intro-query.xml <!-- $Revision: 1.1 $ --> <!-- Sync: 1.5 --> <refentry id="package.database.db.intro-query"> <refnamediv> <refname>導入 - Query</refname> <refpurpose>データベースでクエリを実行する</refpurpose> </refnamediv> <refsect1 id="package.database.db.intro-query.desc"> <title>説明</title> <simpara> 使用するデータベースに対してクエリを実行するには、 クエリ文字列を引数として<link linkend="package.database.db.db-common.query"><function>query</function></link> 関数を使用する必要があります。 失敗した場合は、<link linkend="package.database.db.db-error"><classname>DB_Error</classname></link> オブジェクトが返されますので、<link linkend="package.database.db.db.iserror"><function>DB::isError</function></link> で確認して下さい。 成功時には、 <constant>DB_OK</constant>(定義済みのPEAR::DBの定数) または、<parameter>SELECT</parameter>命令を設定した場合、<link linkend="package.database.db.db-result"><classname>DB_Result</classname></link> オブジェクトが返されます。 </simpara> <example> <title>queryを行う</title> <programlisting role="php"> <![CDATA[ <?php // 有効なDBオブジェクトを有している場合... $sql = "select * from clients"; $result = $db->query($sql); // $resultがエラーでないか常にチェックして下さい if (DB::isError($result)) { die ($result->getMessage()); } .... ?> ]]> </programlisting> </example> </refsect1> </refentry> <!-- 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 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 --> Index: peardoc/ja/package/database/db/intro-sequences.xml +++ peardoc/ja/package/database/db/intro-sequences.xml <!-- $Revision: 1.1 $ --> <!-- Sync: 1.6 --> <refentry id="package.database.db.intro-sequences"> <refnamediv> <refname>導入 - Sequences</refname> <refpurpose>データベース シーケンス</refpurpose> </refnamediv> <refsect1 id="package.database.db.intro-sequences.desc"> <title>説明</title> <para> シーケンスは、データレコード用にユニークなIDを取得する手段です。 多くの業務を例えばMySQLで行っている場合、シーケンスは、 <constant>AUTO_INCREMENT</constant> を行う別の手段と考えであると考えて下さい。 シーケンス処理はかなり簡単で、最初にIDをリクエストし、 作成する新規レコードのIDフィールドに値を挿入します。 全てのテーブルに複数のシーケンスを有することが可能です。 ただし、特定のテーブルについては 同じシーケンスを常に使用する必要があることに注意して下さい。 このユニークなIDの値を取得するには、<link linkend="package.database.db.db-common.nextid"><function>nextId</function></link> を使用してください。 もし、シーケンスが存在しない場合は、自動で作成されます。 <example> <title>sequenceの使用法</title> <programlisting role="php"> <![CDATA[ ... $id = $db->nextId('mySequence'); // INSERTクエリでIDを使用します $res = $db->query("INSERT INTO myTable (id,text) VALUES ($id,'foo')"); ... ]]> </programlisting> </example> </para> </refsect1> </refentry> <!-- 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 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 -->
« previous php.pear.doc (#2005) next »