php/archived-doc-ja
1
0
Fork 0
mirror of https://github.com/php/doc-ja.git synced 2026-03-23 22:52:11 +01:00
Code Issues Packages Projects Releases Wiki Activity

mysql : fix XML by converting para to simpara tags via script

Browse Source
This commit is contained in:
Gina Peter Banyard
2026-01-19 03:22:58 +00:00
parent 89ac15cd58
commit 894a1de8ab
54 changed files with 570 additions and 581 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
reference/mysql/book.xml
View File

@@ -1,9 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 68c2c871505aadf983f16113c5b077b335ce8d76 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<!-- State: deprecated -->
<book xml:id="book.mysql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<book xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="book.mysql">
<?phpdoc extension-membership="pecl"?>
<title>最初の MySQL API</title>
<titleabbrev>MySQL (最初の API)</titleabbrev>
@@ -11,22 +10,21 @@
<!-- {{{ preface -->
<preface xml:id="intro.mysql">
&reftitle.intro;
<para>
<simpara>
この拡張モジュールは PHP 5.5.0 で非推奨になり、PHP 7.0.0 で削除されました。
新しくコードを書くときには <link linkend="book.mysqli">mysqli</link> や
<link linkend="ref.pdo-mysql">PDO_MySQL</link> を使うべきです。
<link linkend="mysqlinfo.api.choosing">MySQL API
Overview</link> が、MySQL API を選択する際の参考となります。
</para>
<para>
</simpara>
<simpara>
以下の関数は、MySQL データベースサーバーへのアクセスを可能にします。
MySQL に関するより詳細な情報は、
<link xlink:href="&url.mysql;">&url.mysql;</link> にあります。
</para>
<para>
MySQL のドキュメントは、<link
xlink:href="&url.mysql.docs;">&url.mysql.docs;</link>にあります。
</para>
</simpara>
<simpara>
MySQL のドキュメントは、<link xlink:href="&url.mysql.docs;">&url.mysql.docs;</link>にあります。
</simpara>
</preface>
<!-- }}} -->
@@ -57,4 +55,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

20
reference/mysql/changelog.xml
View File

@@ -1,22 +1,22 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="changelog.mysql">
<title>&ChangelogListingTitle;</title>
<para>&ChangelogListingDescription;</para>
<simpara>&ChangelogListingDescription;</simpara>
<simplesect>
<title>ext/mysql 拡張モジュールの変更履歴</title>
<para>
<simpara>
ext/mysql 拡張モジュールの変更履歴をまとめました。
</para>
</simpara>
</simplesect>
<simplesect xml:id="changelog.mysql.global">
<title>ext/mysql の全体的な変更点</title>
<para>
<simpara>
ext/mysql 拡張モジュールの全体的な変更点を、以下にまとめます。
</para>
</simpara>
<informaltable xml:id="changelog.mysql.global.table">
<tgroup cols="2">
<thead>
@@ -29,10 +29,10 @@
<row>
<entry>7.0.0</entry>
<entry>
<para>
<simpara>
この拡張モジュールは PHP 本体から削除されました。詳細は
<xref linkend="mysqlinfo.api.choosing"/> を参照ください。
</para>
</simpara>
</entry>
</row>
</tbody>
@@ -42,9 +42,9 @@
<simplesect xml:id="changelog.mysql.functions">
<title>既存の関数の変更点</title>
<para>
<simpara>
ext/mysql の関数に対する変更点を、以下にまとめます。
</para>
</simpara>
<?phpdoc generate-changelog-for="ref.mysql book.mysql"?>
</simplesect>

46
reference/mysql/configure.xml
View File

@@ -1,40 +1,40 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 40667918dcff1d5c9f7ecdc88b5caca24ba0686c Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: takagi -->
<section xml:id="mysql.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<section xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="mysql.installation">
&reftitle.install;
<warning>
&mysql.alternative.note;
</warning>
<para xml:id="mysql.configure">
<simpara xml:id="mysql.configure">
コンパイルするには、単純に
<option role="configure">--with-mysql[=DIR]</option>
設定オプションを利用してください。ここで、オプションの
<literal>[DIR]</literal> は MySQL がインストールされているディレクトリを表します。
</para>
<para>
</simpara>
<simpara>
この MySQL 拡張モジュールは MySQL 4.1.0 以降とも互換性がありますが、
それ以降のバージョンが提供する新機能はサポートしていません。
この機能を使用するには、
<link linkend="book.mysqli">MySQLi</link> 拡張モジュールを使用してください。
</para>
<para>
</simpara>
<simpara>
もし mysql 拡張モジュールと mysqli
拡張モジュールを同時にインストールしたい場合は、
衝突を避けるために両方で同じクライアントライブラリを用いる必要があります。
</para>
</simpara>
<section xml:id="mysql.installation.linux">
<title>Linux へのインストール</title>
<para>
<simpara>
注意: <literal>[DIR]</literal> は MySQL クライアントライブラリファイル
(<emphasis>ヘッダやライブラリファイル</emphasis>) へのパスです。
これらのファイルは
<link xlink:href="&url.mysql;">MySQL</link> からダウンロードできます。
</para>
</simpara>
<table xml:id="mysql.installation.compile.support">
<title>ext/mysql のコンパイル時のサポート表</title>
<tgroup cols="5">
@@ -87,7 +87,7 @@
<title>Windows へのインストール</title>
<section xml:id="mysql.installation.windows.php52">
<title>PHP 5.0.x, 5.1.x, 5.2.x</title>
<para>
<simpara>
MySQL はもはやデフォルトでは有効となりません。したがって &php.ini;
で <filename>php_mysql.dll</filename> DLL を有効にしておく必要があります。
また、PHP が MySQL クライアントライブラリにアクセスできなければなりません。
@@ -101,8 +101,8 @@
のシステムディレクトリにコピーしても動作しますが
(システムディレクトリは、デフォルトでシステムの <envar>PATH</envar>
に含まれています)、お勧めしません。
</para>
<para>
</simpara>
<simpara>
(<filename>php_mysql.dll</filename> も含めた) PHP
拡張モジュールを有効にするには、PHP ディレクティブ
<link linkend="ini.extension-dir">extension_dir</link>
@@ -110,47 +110,46 @@
<link linkend="install.windows.manual">Windows
へのマニュアルインストール方法</link> も参照ください。PHP 5 での
extension_dir の例は <literal>c:\php\ext</literal> です。
</para>
</simpara>
<note>
<para>
<simpara>
Web サーバーの起動時に以下のようなエラーが発生する場合：
<literal>"Unable to load dynamic library './php_mysql.dll'"</literal>
これは <filename>php_mysql.dll</filename> や
<filename>libmysqlclient.dll</filename>
がシステムによって見つけられなかったことが原因です。
</para>
</simpara>
</note>
</section>
<section xml:id="mysql.installation.windows.php53">
<title>PHP 5.3.0+</title>
<para>
<simpara>
<link linkend="mysqlnd.overview">MySQL Native Driver</link> がデフォルトで有効になります。
<filename>php_mysql.dll</filename> は含まれますが、<filename>libmysqlclient.dll</filename>
はもはや必須ではなく、使われません。
</para>
</simpara>
</section>
</section>
<section xml:id="mysql.installation.notes">
<title>MySQL インストールの注意</title>
<warning>
<para>
<simpara>
この拡張モジュールと recode 拡張モジュールを同時にロードした場合、
PHP のクラッシュと起動に関する問題が発生する可能性があります。
より詳細な情報については、<link linkend="ref.recode">recode</link>
拡張モジュールを参照ください。
</para>
</simpara>
</warning>
<note>
<para>
<simpara>
<emphasis>latin</emphasis>（デフォルト）以外の文字セットを必要とする場合、
使用する文字セットのサポートを有効にしてコンパイルした（バンドル版でない）
libmysqlclient をインストールする必要があります。
</para>
</simpara>
</note>
</section>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -171,4 +170,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

38
reference/mysql/functions/mysql-affected-rows.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: takagi -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-affected-rows">
<refnamediv>
@@ -24,10 +24,10 @@
<type>int</type><methodname>mysql_affected_rows</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<parameter>link_identifier</parameter> と関連付けられた直近の
INSERT、UPDATE、REPLACE、DELETE クエリによって変更された行の数を取得します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,31 +39,31 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に変更された行の数を、直近のクエリが失敗した場合に
-1 を返します。
</para>
<para>
</simpara>
<simpara>
直近のクエリが WHERE 句を含まない DELETE だった場合、テーブルから
すべてのレコードが削除されますが、MySQL 4.1.2 以前のバージョンでは
この関数はゼロを返します。
</para>
<para>
</simpara>
<simpara>
UPDATE を使用する場合、MySQL では新旧の値が同じときには更新処理を行いません。
このことから、必ずしも <function>mysql_affected_rows</function> の返す値が
マッチする行の数と一致するとは限りません。返す値は実際に更新処理が行われた
行の数です。
</para>
<para>
</simpara>
<simpara>
REPLACE ステートメントは、まず最初に同じ主キーのレコードを削除した後に
新しいレコードを挿入します。この関数は、削除された行の数と
挿入された行の数を足したものを返します。
</para>
<para>
</simpara>
<simpara>
"INSERT ... ON DUPLICATE KEY UPDATE" クエリの場合の戻り値は、
新しい行を追加した場合が <literal>1</literal>
で既存の行を更新した場合が <literal>2</literal> となります。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -128,26 +128,26 @@ Updated Records: 10
&reftitle.notes;
<note>
<title>トランザクション</title>
<para>
<simpara>
トランザクションを使用する場合には、コミット後ではなく
INSERT, UPDATE, DELETE クエリの後に
<function>mysql_affected_rows</function> をコールする必要があります。
</para>
</simpara>
</note>
<note>
<title>SELECT ステートメント</title>
<para>
<simpara>
SELECT から返される行の数を得る際には、
<function>mysql_num_rows</function> が利用できます。
</para>
</simpara>
</note>
<note>
<title>外部キーによる連鎖</title>
<para>
<simpara>
<function>mysql_affected_rows</function> は、外部キー制約の
ON DELETE CASCADE や ON UPDATE CASCADE
で暗黙のうちに変更された行については数えません。
</para>
</simpara>
</note>
</refsect1>

10
reference/mysql/functions/mysql-client-encoding.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-client-encoding">
<refnamediv>
<refname>mysql_client_encoding</refname>
@@ -22,9 +22,9 @@
<type>string</type><methodname>mysql_client_encoding</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
MySQL の <literal>character_set</literal> 変数の値を取得します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,9 +36,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
カレントの接続から、デフォルトの文字セット名を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

14
reference/mysql/functions/mysql-close.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-close">
<refnamediv>
@@ -24,12 +24,12 @@
<type>bool</type><methodname>mysql_close</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_close</function> は、指定した link_identifier が指す
MySQL データベースへの非持続的リンクを閉じます。
<parameter>link_identifier</parameter> が指定されない場合、最後に
オープンされたリンクが使用されます。
</para>
</simpara>
&mysql.close.connections.result.sets;
</refsect1>
@@ -42,9 +42,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -75,12 +75,12 @@ mysql_close($link);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
<function>mysql_close</function> は、<function>mysql_pconnect</function>
により生成された持続的リンクを閉じません。
詳細な情報は、マニュアルの
<link linkend="features.persistent-connections">持続的データベース接続</link>を参照ください。
</para>
</simpara>
</note>
</refsect1>

46
reference/mysql/functions/mysql-connect.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-connect">
<refnamediv>
@@ -28,9 +28,9 @@
<methodparam choice="opt"><type>bool</type><parameter>new_link</parameter><initializer>&false;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>client_flags</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
MySQL サーバーへの接続をオープンあるいは再利用します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,44 +39,44 @@
<varlistentry>
<term><parameter>server</parameter></term>
<listitem>
<para>
<simpara>
MySQL サーバー。"hostname:port" のようにポート番号を
指定することが可能で、localhost では ":/path/to/socket"
のようにソケットへのパスを指定することも可能です。
</para>
<para>
</simpara>
<simpara>
PHP ディレクティブ <link linkend="ini.mysql.default-host">
mysql.default_host</link> が指定されない場合（デフォルト）、
'localhost:3306' が使用されます。
&sqlsafemode; の場合はこのパラメータは無視され、常に
'localhost:3306' が用いられます。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>username</parameter></term>
<listitem>
<para>
<simpara>
ユーザー名。デフォルト値は <link linkend="ini.mysql.default-user">mysql.default_user</link>
で定義されている値です。&sqlsafemode; の場合はこのパラメータは無視され、
サーバープロセスの所有ユーザー名が用いられます。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>password</parameter></term>
<listitem>
<para>
<simpara>
パスワード。デフォルト値は <link linkend="ini.mysql.default-password">mysql.default_password</link>
で定義されている値です。&sqlsafemode; の場合はこのパラメータは無視され、
空のパスワードが用いられます。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>new_link</parameter></term>
<listitem>
<para>
<simpara>
同じ引数で 2 回 <function>mysql_connect</function> をコールした場合、
2 回目は新規のリンクが確立されるのではなく、代わりにすでにオープンされた
リンクのリンク ID が返されます。
@@ -84,13 +84,13 @@
<function>mysql_connect</function> が同じパラメータでコールされて
いる場合でも常に新規のリンクがオープンされるようにします。
&sqlsafemode; の場合はこのパラメータは無視されます。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>client_flags</parameter></term>
<listitem>
<para>
<simpara>
パラメータ <parameter>client_flags</parameter> は、
以下の定数の組み合わせです：
128 (<literal>LOAD DATA LOCAL</literal> の処理を有効にする)、
@@ -101,7 +101,7 @@
詳細な情報については <xref linkend="mysql.client-flags"/>
を参照ください。
&sqlsafemode; の場合はこのパラメータは無視されます。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -109,9 +109,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に MySQL リンク ID を、&return.falseforfailure;。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -187,7 +187,7 @@ mysql_close($link);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
サーバー名に &quot;localhost&quot; や &quot;localhost:port&quot;
を指定した場合、MySQL クライアントライブラリはそれをオーバーライドし、
ローカルソケット（Windows では名前つきパイプ）に接続しようとします。
@@ -196,21 +196,21 @@ mysql_close($link);
間違ったローカルソケットへ接続しようとしている場合、これを修正するには
&php.ini; の <link linkend="ini.mysql.default-host">mysql.default_host</link>
に正しいパスを指定したうえでサーバー名を空白にしておくべきです。
</para>
</simpara>
</note>
<note>
<para>
<simpara>
サーバーへのリンクは、<function>mysql_close</function> のコールにより
明示的に閉じられない限り、スクリプトの実行終了と同時に閉じられます。
</para>
</simpara>
</note>
<note>
<para>
<simpara>
エラー "Can't create TCP/IP socket (10106)" が発生するのは、たいていは <link linkend="ini.variables-order">variables_order</link> 設定ディレクティブに
<literal>E</literal> が含まれていない場合です。
Windows では、これが含まれていなければ <literal>SYSTEMROOT</literal>
環境変数が使用できず、PHP が Winsock の読み込みに失敗します。
</para>
</simpara>
</note>
</refsect1>

26
reference/mysql/functions/mysql-create-db.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-create-db">
<refnamediv>
@@ -25,10 +25,10 @@
<methodparam><type>string</type><parameter>database_name</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_create_db</function> は、指定したリンク ID が指す
サーバー上に新規のデータベースを作成します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -37,9 +37,9 @@
<varlistentry>
<term><parameter>database_name</parameter></term>
<listitem>
<para>
<simpara>
作成されるデータベースの名前です。
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -48,21 +48,21 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title><function>mysql_create_db</function> の別の例</title>
<para>
<simpara>
<function>mysql_create_db</function> は廃止予定です。代わりに
<function>mysql_query</function> を用いて
<literal>CREATE DATABASE</literal> ステートメントを発行する方法が
推奨されます。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -92,16 +92,16 @@ if (mysql_query($sql, $link)) {
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_createdb</function>
</para>
</simpara>
</note>
<note>
<para>
<simpara>
MySQL 4.x クライアントライブラリを用いて MySQL 拡張モジュールを
ビルドした場合、この関数は利用できません。
</para>
</simpara>
</note>
</refsect1>

22
reference/mysql/functions/mysql-data-seek.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,mumumu -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-data-seek">
<refnamediv>
@@ -25,15 +25,15 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>row_number</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_data_seek</function> は、指定した結果 ID
（result_identifier）が指す MySQL 結果の内部ポインタが指定した行番号
（row_number）を指すように移動します。
この後、たとえば <function>mysql_fetch_assoc</function> のような
MySQL のフェッチ関数をコールした場合には、
ここで指定した行の内容が返されます。
</para>
<para>
</simpara>
<simpara>
<parameter>row_number</parameter> は 0 から始まります。
<parameter>row_number</parameter> は 0 から
<function>mysql_num_rows</function> - 1 までの範囲にあるべきです。
@@ -41,7 +41,7 @@
の場合、0 へのシークは
<constant>E_WARNING</constant>
を発生して失敗し、<function>mysql_data_seek</function> は &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -51,9 +51,9 @@
<varlistentry>
<term><parameter>row_number</parameter></term>
<listitem>
<para>
<simpara>
新しく結果ポインタを設定したい行番号です。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -61,9 +61,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -110,11 +110,11 @@ mysql_free_result($result);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
<function>mysql_data_seek</function> は、
<function>mysql_query</function> との組み合わせでのみ利用可能です。
<function>mysql_unbuffered_query</function> と組み合わせることはできません。
</para>
</simpara>
</note>
</refsect1>

26
reference/mysql/functions/mysql-db-name.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-db-name">
<refnamediv>
@@ -25,10 +25,10 @@
<methodparam><type>int</type><parameter>row</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>field</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_list_dbs</function>
をコールした結果からデータベース名を取得します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -37,26 +37,26 @@
<varlistentry>
<term><parameter>result</parameter></term>
<listitem>
<para>
<simpara>
<function>mysql_list_dbs</function> をコールして
得られた結果ポインタ。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>row</parameter></term>
<listitem>
<para>
<simpara>
結果セット内のインデックス。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>field</parameter></term>
<listitem>
<para>
<simpara>
フィールド名。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -64,11 +64,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合にデータベース名を、失敗した場合に &false; を返します。
&false; が返された場合、エラーの発生源を特定するには
<function>mysql_error</function> を使用してください。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -98,10 +98,10 @@ while ($i < $cnt) {
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_dbname</function>
</para>
</simpara>
</note>
</refsect1>

26
reference/mysql/functions/mysql-db-query.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,mumumu -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-db-query">
<refnamediv>
@@ -26,10 +26,10 @@
<methodparam><type>string</type><parameter>query</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_db_query</function> はデータベースを選択し、
そこでクエリーを実行します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -38,21 +38,21 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
選択するデータベース名。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>query</parameter></term>
<listitem>
<para>
<simpara>
MySQL クエリー。
</para>
<para>
</simpara>
<simpara>
クエリ内のデータは <link linkend="function.mysql-real-escape-string">適切にエスケープ</link>
する必要があります。
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -61,13 +61,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
クエリーの結果を指す MySQL 結果リソースを正の値で返します。
エラー時には &false; を返します。また、
<literal>INSERT</literal>/<literal>UPDATE</literal>/<literal>DELETE</literal>
クエリーの場合には &true; または &false; を返し、これらはそれぞれ
クエリーが 成功した / 失敗した ことを示します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -112,7 +112,7 @@ mysql_free_result($result);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
この関数の終了後、直前に選択されていたデータベースに自動的に戻ることは
<emphasis role="strong">ない</emphasis>ということに注意してください。
言い換えれば、<emphasis>一時的に</emphasis>別のデータベース上でクエリーを
@@ -121,7 +121,7 @@ mysql_free_result($result);
この関数のかわりに、SQL クエリーの中で <literal>database.table</literal>
構文を用いたり <function>mysql_select_db</function> を利用したりすることが
強く推奨されています。
</para>
</simpara>
</note>
</refsect1>

22
reference/mysql/functions/mysql-drop-db.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-drop-db">
<refnamediv>
@@ -24,13 +24,13 @@
<methodparam><type>string</type><parameter>database_name</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_drop_db</function> は、指定した link_identifier が指す
データベース全体をサーバーから破棄(削除)しようとします。
この関数は非推奨です。かわりに、
<function>mysql_query</function> を用いて
<literal>DROP DATABASE</literal> 文を発行する方法が推奨されます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,9 +39,9 @@
<varlistentry>
<term><parameter>database_name</parameter></term>
<listitem>
<para>
<simpara>
削除するデータベースの名前。
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -50,9 +50,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -82,16 +82,16 @@ if (mysql_query($sql, $link)) {
<refsect1 role="notes">
&reftitle.notes;
<warning>
<para>
<simpara>
MySQL 4.x のクライアントライブラリを用いて MySQL 拡張モジュールを
ビルドした場合、この関数は利用できません。
</para>
</simpara>
</warning>
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_dropdb</function>
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-errno.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.mysql-errno">
<refnamediv>
@@ -24,10 +24,10 @@
<type>int</type><methodname>mysql_errno</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
直近の MySQL 関数で発生したエラーの番号を返します。
</para>
<para>
</simpara>
<simpara>
MySQL データベースバックエンドから返ってくるエラーは、
警告を発生しません。代わりに <function>mysql_errno</function> を用いて
エラー番号を取得してください。この関数が返すのは、直近に実行された
@@ -35,7 +35,7 @@
<function>mysql_errno</function> は除く）のエラーコードだけであることに
注意しましょう。この関数を利用するなら、別の MySQL 関数をコールする前に
値を調べることを忘れないようにしましょう。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -47,10 +47,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
直近の MySQL 関数からのエラー番号を返します。エラーが発生していない
場合は、<literal>0</literal> (ゼロ)を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

10
reference/mysql/functions/mysql-error.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.mysql-error">
<refnamediv>
@@ -24,7 +24,7 @@
<type>string</type><methodname>mysql_error</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
直近の MySQL 関数からのエラー文字列を返します。
MySQL データベースバックエンドから返ってくるエラーは、
警告を発生しません。代わりに <function>mysql_error</function> を用いて
@@ -33,7 +33,7 @@
<function>mysql_errno</function> は除く）のエラー文字列だけであることに
注意しましょう。この関数を利用するなら、別の MySQL 関数をコールする前に
値を調べることを忘れないようにしましょう。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -45,10 +45,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
直近の MySQL 関数からのエラー文字列を返します。エラーが発生していない
場合には、<literal>''</literal> (空文字列) を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

22
reference/mysql/functions/mysql-escape-string.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,mumumu -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-escape-string">
<refnamediv>
@@ -24,18 +24,18 @@
<type>string</type><methodname>mysql_escape_string</methodname>
<methodparam><type>string</type><parameter>unescaped_string</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
この関数は、<function>mysql_query</function> で指定可能なように
<parameter>unescaped_string</parameter> をエスケープします。
この関数は非推奨です。
</para>
<para>
</simpara>
<simpara>
この関数は <function>mysql_real_escape_string</function> とほぼ同じです。ただ
<function>mysql_real_escape_string</function> はコネクションハンドラを用い、
カレントの文字セットを考慮したエスケープを行うという点が違います。
<function>mysql_escape_string</function> はコネクションに関する引数を
持たず、カレントの文字セット設定を考慮しません。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -44,9 +44,9 @@
<varlistentry>
<term><parameter>unescaped_string</parameter></term>
<listitem>
<para>
<simpara>
エスケープされる文字列。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -54,9 +54,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
エスケープされた文字列を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -84,10 +84,10 @@ Escaped string: Zak\'s Laptop
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
<function>mysql_escape_string</function> は、
<literal>%</literal> および <literal>_</literal> をエスケープしません。
</para>
</simpara>
</note>
</refsect1>

22
reference/mysql/functions/mysql-fetch-array.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,shimooka -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-fetch-array">
<refnamediv>
@@ -25,9 +25,9 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>result_type</parameter><initializer>MYSQL_BOTH</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
取得した行に対応する配列を返し、内部のデータポインタを前に進めます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -37,12 +37,12 @@
<varlistentry>
<term><parameter>result_type</parameter></term>
<listitem>
<para>
<simpara>
取得する配列の形式です。以下の定数値をとります。:
<constant>MYSQL_ASSOC</constant>,
<constant>MYSQL_NUM</constant>, そして
<constant>MYSQL_BOTH</constant>
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -50,7 +50,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
取得した行をあらわす文字列の配列を返します。もし行が存在しない場合は &false;
を返します。返される配列の形式は、<parameter>result_type</parameter>
がどのように指定されているかによります。<constant>MYSQL_BOTH</constant>（デフォルト）
@@ -60,15 +60,15 @@
<constant>MYSQL_NUM</constant> を利用すると
（<function>mysql_fetch_row</function> の動作と同様に）数値添字のみが
取得されます。
</para>
<para>
</simpara>
<simpara>
結果の中で同じフィールド名のカラムが 2 つ以上ある場合、
最後のカラムが優先されます。
同名の他のカラムにアクセスするには、そのカラムの数値インデックスを
使うかまたはカラムの別名を定義する必要があります。
カラムの別名を定義した場合は、本来の列名でそのカラムにアクセスすることは
できません。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -147,12 +147,12 @@ mysql_free_result($result);
&reftitle.notes;
<note>
<title>パフォーマンス</title>
<para>
<simpara>
特筆すべき点として、<function>mysql_fetch_array</function> が
著しい付加価値があるにもかかわらず、
<function>mysql_fetch_row</function>より
<emphasis>それほど</emphasis>遅くはないということが言えます。
</para>
</simpara>
</note>
&database.field-case;
&database.fetch-null;

18
reference/mysql/functions/mysql-fetch-assoc.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,shimooka -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-fetch-assoc">
<refnamediv>
@@ -28,13 +28,13 @@
<type>array</type><methodname>mysql_fetch_assoc</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
取得した行に対応する連想配列を返し、内部のデータポインタを前に進めます。
<function>mysql_fetch_assoc</function> は、
<function>mysql_fetch_array</function> の 2 番目のパラメータを
MYSQL_ASSOC に指定してコールするのと同じ働きをします。つまり、
連想配列のみを返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -46,17 +46,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
取得した行に対応する文字列の連想配列を返します。行がもうない場合には
&false; を返します。
</para>
<para>
</simpara>
<simpara>
結果の複数のカラムが同じフィールド名を有している場合、最後のカラ
ムが優先されます。同じ名前を有する他のカラムにアクセスするには、
<function>mysql_fetch_row</function>を使用して数値添字を返すか、
エイリアス名を追加する必要があります。エイリアスの説明については、
<function>mysql_fetch_array</function>の例を参照ください。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -117,12 +117,12 @@ mysql_free_result($result);
&reftitle.notes;
<note>
<title>パフォーマンス</title>
<para>
<simpara>
特筆すべき点として、<function>mysql_fetch_assoc</function> が
著しい付加価値があるにもかかわらず、
<function>mysql_fetch_row</function>より
<emphasis>それほど</emphasis>遅くはないということが言えます。
</para>
</simpara>
</note>
&database.field-case;
&database.fetch-null;

18
reference/mysql/functions/mysql-fetch-field.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-fetch-field">
<refnamediv>
@@ -25,10 +25,10 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>field_offset</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
フィールド情報を含むオブジェクトを返します。特定のクエリー結果の中の
フィールドに関する情報を得るために使用可能です。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -38,12 +38,12 @@
<varlistentry>
<term><parameter>field_offset</parameter></term>
<listitem>
<para>
<simpara>
数字で表したフィールドの位置です。もし指定されなければ、
まだこの関数で情報を取得していないフィールドのうち最初のものが
選択されます。<parameter>field_offset</parameter> は、
<literal>0</literal> からはじまります。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -51,10 +51,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
フィールド情報を含む<type>object</type>を返します。オブジェクトの
プロパティは次のとおりです。
</para>
</simpara>
<itemizedlist>
<listitem>
<simpara>
@@ -170,11 +170,11 @@ mysql_free_result($result);
&reftitle.notes;
&database.field-case;
<note>
<para>
<simpara>
SQL クエリでフィールド名やテーブル名のエイリアスを設定している場合は、
エイリアスを返します。本来の名前を取得するには、
<methodname>mysqli_result::fetch_field</methodname> を使いましょう。
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-fetch-lengths.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-fetch-lengths">
<refnamediv>
@@ -24,11 +24,11 @@
<type class="union"><type>array</type><type>false</type></type><methodname>mysql_fetch_lengths</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
MySQL により一番最近に取得された行における各フィールドの長さを
格納した配列を返します。
</para>
<para>
</simpara>
<simpara>
<function>mysql_fetch_lengths</function>は、
<function>mysql_fetch_row</function>,
<function>mysql_fetch_assoc</function>,
@@ -36,7 +36,7 @@
<function>mysql_fetch_object</function> により一番最近に返された
各結果カラムの長さを格納した配列を返します。この配列のオフセットは
0 から始まります。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -48,10 +48,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に長さの配列（<type>array</type>）を、
&return.falseforfailure;。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

26
reference/mysql/functions/mysql-fetch-object.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,shimooka -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-fetch-object">
<refnamediv>
@@ -30,10 +30,10 @@
<methodparam choice="opt"><type>string</type><parameter>class_name</parameter></methodparam>
<methodparam choice="opt"><type>array</type><parameter>params</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
取得された行を表すプロパティを有するオブジェクトを返し、
内部のデータポインタを前に進めます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -43,20 +43,20 @@
<varlistentry>
<term><parameter>class_name</parameter></term>
<listitem>
<para>
<simpara>
インスタンス化し、プロパティを設定して返すクラスの名前。
指定しなかった場合は <classname>stdClass</classname>
オブジェクトが返されます。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>params</parameter></term>
<listitem>
<para>
<simpara>
<parameter>class_name</parameter> オブジェクトのコンストラクタに渡す
オプションのパラメータの配列。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -64,10 +64,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
取得された行を表す文字列プロパティを有するオブジェクト(<type>object</type>)を返します。
もう行が残っていない場合は、&false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -113,20 +113,20 @@ var_dump($obj);
&reftitle.notes;
<note>
<title>パフォーマンス</title>
<para>
<simpara>
速度面では、この関数は <function>mysql_fetch_array</function> と同等で、
<function>mysql_fetch_row</function> とほぼ同等です(違いはわずかです)。
</para>
</simpara>
</note>
<note>
<para>
<simpara>
<function>mysql_fetch_object</function>は、配列の代わりに
オブジェクトが返されるという一つの違いを除いて
<function>mysql_fetch_array</function>と類似しています。
つまり、オフセットによってではなく、フィールド名によってのみ
データにアクセスすることができます
(数字は、プロパティ名として使用できません)。
</para>
</simpara>
</note>
&database.field-case;
&database.fetch-null;

14
reference/mysql/functions/mysql-fetch-row.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,shimooka -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-fetch-row">
<refnamediv>
@@ -28,9 +28,9 @@
<type>array</type><methodname>mysql_fetch_row</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
取得された行に対応する配列を返し、内部のデータポインタを前に進めます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -42,15 +42,15 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
取得された行に対応する文字列の配列を返します。もう行がない場合は、
&false; を返します。
</para>
<para>
</simpara>
<simpara>
<function>mysql_fetch_row</function>は、指定した結果 ID
が指す結果から 1 行分のデータを取得します。
各結果カラムは、オフセット 0 から始まる配列に格納されます。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

18
reference/mysql/functions/mysql-field-flags.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-field-flags">
<refnamediv>
@@ -25,12 +25,12 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_field_flags</function>は、指定したフィールドの
フィールドフラグを返します。個々のフラグは、空白一つで区切られた
形式で返されます。このため、返された値を
<function>explode</function> で分割することができます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -43,10 +43,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
結果についてのフラグを文字列で返します。&return.falseforfailure;。
</para>
<para>
</simpara>
<simpara>
運用システム上のMySQLがサポートしている場合、次のフラグがレポート
されます。 <literal>"not_null"</literal>,
<literal>"primary_key"</literal>, <literal>"unique_key"</literal>,
@@ -54,7 +54,7 @@
<literal>"unsigned"</literal>, <literal>"zerofill"</literal>,
<literal>"binary"</literal>, <literal>"enum"</literal>,
<literal>"auto_increment"</literal> そして <literal>"timestamp"</literal>
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -94,10 +94,10 @@ Array
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_fieldflags</function>
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-field-len.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-field-len">
<refnamediv>
@@ -25,10 +25,10 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_field_len</function>は指定したフィールドの長さを
返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -41,9 +41,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合には指定したフィールドの長さ、&return.falseforfailure;。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -72,10 +72,10 @@ echo $length;
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_fieldlen</function>
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-field-name.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-field-name">
<refnamediv>
@@ -25,10 +25,10 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_field_name</function>は、指定したフィールドの
名前を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -41,9 +41,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に指定したフィールドの名前を、&return.falseforfailure;。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -88,10 +88,10 @@ password
&reftitle.notes;
&database.field-case;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_fieldname</function>
</para>
</simpara>
</note>
</refsect1>

10
reference/mysql/functions/mysql-field-seek.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-field-seek">
<refnamediv>
@@ -29,12 +29,12 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
指定したフィールドオフセットに移動します。
<function>mysql_field_seek</function> をコールした後、
<function>mysql_fetch_field</function> をフィールドオフセットを付けずに
コールした場合、このフィールドが返されます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -47,9 +47,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="seealso">

14
reference/mysql/functions/mysql-field-table.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-field-table">
<refnamediv>
@@ -25,9 +25,9 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
指定したフィールドが含まれるテーブルの名前を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -40,9 +40,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合にテーブルの名前を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -75,10 +75,10 @@ for ($i = 0; $i < mysql_num_fields($result); ++$i) {
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_fieldtable</function>
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-field-type.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.mysql-field-type">
<refnamediv>
@@ -25,11 +25,11 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>field_offset</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_field_type</function> は、
<function>mysql_field_name</function> 関数に似ています。
引数は同じですが、この関数ではフィールドの型が返されます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -42,13 +42,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
返されるフィールド型は
<literal>"int"</literal>, <literal>"real"</literal>,
<literal>"string"</literal>, <literal>"blob"</literal>, そして
その他 <link xlink:href="&url.mysql.docs;">MySQL ドキュメント</link>
で詳細が規定されている型のうちのひとつになります。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -95,10 +95,10 @@ string type 9 not_null enum
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_fieldtype</function>
</para>
</simpara>
</note>
</refsect1>

22
reference/mysql/functions/mysql-free-result.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-free-result">
<refnamediv>
@@ -24,16 +24,16 @@
<type>bool</type><methodname>mysql_free_result</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_free_result</function> は、結果 ID <parameter>result</parameter>
に関するすべてのメモリを開放します。
</para>
<para>
</simpara>
<simpara>
<function>mysql_free_result</function> は、
スクリプト実行のメモリの使用量が多すぎると懸念される場合にのみ
必要になります。指定した結果 ID に関する全ての結果保持用メモリは、
スクリプトの実行後に自動的に開放されます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -45,16 +45,16 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
<para>
</simpara>
<simpara>
<parameter>result</parameter> がリソースではなかった場合、
E_WARNING レベルのエラーが発生します。
<function>mysql_query</function> が <type>resource</type>
を返すのは SELECT, SHOW, EXPLAIN, そして DESCRIBE
の場合だけであることに注意しましょう。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -86,10 +86,10 @@ echo $row['email'];
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_freeresult</function>
</para>
</simpara>
</note>
</refsect1>

10
reference/mysql/functions/mysql-get-client-info.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-get-client-info">
<refnamediv>
@@ -28,10 +28,10 @@
<type>string</type><methodname>mysql_get_client_info</methodname>
<void/>
</methodsynopsis>
<para>
<simpara>
<function>mysql_get_client_info</function> は、
クライアントライブラリのバージョンを表す文字列を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -41,9 +41,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
MySQL クライアントのバージョンを返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

10
reference/mysql/functions/mysql-get-host-info.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-get-host-info">
<refnamediv>
@@ -28,9 +28,9 @@
<type class="union"><type>string</type><type>false</type></type><methodname>mysql_get_host_info</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
使用されている接続の型を返します。その中にはサーバーのホスト名も含まれます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -42,10 +42,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
使用されている MySQL 接続の型を表す文字列を返します。
&return.falseforfailure;。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

10
reference/mysql/functions/mysql-get-proto-info.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-get-proto-info">
<refnamediv>
@@ -23,9 +23,9 @@
<type class="union"><type>int</type><type>false</type></type><methodname>mysql_get_proto_info</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
MySQL プロトコルを取得します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -37,9 +37,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に MySQL プロトコル、&return.falseforfailure;。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

10
reference/mysql/functions/mysql-get-server-info.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-get-server-info">
<refnamediv>
@@ -28,9 +28,9 @@
<type class="union"><type>string</type><type>false</type></type><methodname>mysql_get_server_info</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
MySQL サーバーのバージョンを取得します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -42,9 +42,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に MySQL サーバーのバージョン、&return.falseforfailure;。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

18
reference/mysql/functions/mysql-info.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-info">
<refnamediv>
<refname>mysql_info</refname>
@@ -22,9 +22,9 @@
<type>string</type><methodname>mysql_info</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
直近のクエリについての詳細な情報を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,21 +36,21 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に文についての情報、失敗した場合に &false; を返します。
どんな文が情報を返し、またそれがどのように見えるのかについては、以下の
例を参照ください。ここに挙げられていない文では &false; が返されます。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>該当する MySQL 文</title>
<para>
<simpara>
情報を返す文の例です。数値はあくまで説明用の例で、実際の値は
クエリの内容によって変わります。
</para>
</simpara>
<programlisting role="mysql">
<![CDATA[
INSERT INTO ... SELECT ...
@@ -71,10 +71,10 @@ String format: Rows matched: 65 Changed: 65 Warnings: 0
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
INSERT ... VALUES 文で <function>mysql_info</function> が非 &false; 値を
返すのは、文中で複数の値のリストが指定された場合に限ります。
</para>
</simpara>
</note>
</refsect1>

22
reference/mysql/functions/mysql-insert-id.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-insert-id">
<refnamediv>
@@ -24,10 +24,10 @@
<type>int</type><methodname>mysql_insert_id</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
直近のクエリ (通常は INSERT) により AUTO_INCREMENT カラム用に生成された ID
を取得します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,12 +39,12 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
直近のクエリにより AUTO_INCREMENT カラム用に生成された
ID を返します。直近のクエリが AUTO_INCREMENT な値を生成しなかった
場合に <literal>0</literal>、MySQL 接続が確立されていなかった
場合に &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -71,7 +71,7 @@ printf("最後に挿入されたレコードの ID は、%d\n", mysql_insert_id(
<refsect1 role="notes">
&reftitle.notes;
<caution>
<para>
<simpara>
<function>mysql_insert_id</function> は、MySQL C API 関数
<literal>mysql_insert_id()</literal> の戻り値の型を
<literal>long</literal> 型（PHP では <type>int</type> と呼ばれる）
@@ -83,21 +83,21 @@ printf("最後に挿入されたレコードの ID は、%d\n", mysql_insert_id(
PHP の integer 型の最大値に関する詳細な説明は、
<link linkend="language.types.integer">integer</link>
のドキュメントをごらんください。
</para>
</simpara>
</caution>
<note>
<para>
<simpara>
<function>mysql_insert_id</function> は直近のクエリに対して働くので、
値を生成したクエリの直後に <function>mysql_insert_id</function>
をコールすることを忘れないようにしてください。
</para>
</simpara>
</note>
<note>
<para>
<simpara>
MySQL の SQL 関数 <literal>LAST_INSERT_ID()</literal> の値には、
常に直近の AUTO_INCREMENT の値が含まれており、クエリの間では
リセットされません。
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-list-dbs.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-list-dbs">
<refnamediv>
@@ -23,9 +23,9 @@
<type>resource</type><methodname>mysql_list_dbs</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
現在の mysql デーモンで利用可能なデータベースの結果ポインタを返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -37,13 +37,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に結果ポインタ <type>resource</type> を、失敗した場合に
&false; を返します。結果ポインタの中身を調べるために
<function>mysql_tablename</function> 関数を利用し、取得したテーブルを
利用するには <function>mysql_fetch_array</function> などの関数を
利用してください。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -85,10 +85,10 @@ database3
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_listdbs</function>
</para>
</simpara>
</note>
</refsect1>

30
reference/mysql/functions/mysql-list-fields.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-list-fields">
<refnamediv>
@@ -25,14 +25,14 @@
<methodparam><type>string</type><parameter>table_name</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
指定された名前のテーブルについての情報を取得します。
</para>
<para>
</simpara>
<simpara>
この関数は非推奨です。かわりに
<function>mysql_query</function> を利用して <literal>SHOW COLUMNS FROM
table [LIKE 'name']</literal> 文を発行することを推奨します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -41,17 +41,17 @@
<varlistentry>
<term><parameter>database_name</parameter></term>
<listitem>
<para>
<simpara>
クエリの対象となるデータベース名。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>table_name</parameter></term>
<listitem>
<para>
<simpara>
クエリの対象となるテーブル名。
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -60,16 +60,16 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に結果ポインタ <type>resource</type> 、失敗した場合に &false;
を返します。
</para>
<para>
</simpara>
<simpara>
返された結果は <function>mysql_field_flags</function>,
<function>mysql_field_len</function>,
<function>mysql_field_name</function>&listendand;
<function>mysql_field_type</function> で利用可能です。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -121,10 +121,10 @@ Array
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_listfields</function>
</para>
</simpara>
</note>
</refsect1>

10
reference/mysql/functions/mysql-list-processes.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-list-processes">
<refnamediv>
<refname>mysql_list_processes</refname>
@@ -22,9 +22,9 @@
<type class="union"><type>resource</type><type>false</type></type><methodname>mysql_list_processes</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
現在の MySQL サーバーのスレッドを取得します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -36,10 +36,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に結果ポインタ <type>resource</type> 、
&return.falseforfailure;。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

26
reference/mysql/functions/mysql-list-tables.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-list-tables">
<refnamediv>
@@ -23,14 +23,14 @@
<methodparam><type>string</type><parameter>database</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
MySQL データベースから、テーブル名のリストを取得します。
</para>
<para>
</simpara>
<simpara>
この関数は非推奨となりました。かわりに
<function>mysql_query</function> を利用して <literal>SHOW TABLES
[FROM db_name] [LIKE 'pattern']</literal> 文を発行することを推奨します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,9 +39,9 @@
<varlistentry>
<term><parameter>database</parameter></term>
<listitem>
<para>
<simpara>
データベース名。
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -50,16 +50,16 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に結果ポインタ <type>resource</type> 、
&return.falseforfailure;。
</para>
<para>
</simpara>
<simpara>
結果ポインタの中身を調べるためには
<function>mysql_tablename</function> 関数を利用し、
取得したテーブルを利用するには <function>mysql_fetch_array</function>
などの関数を利用してください。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -99,10 +99,10 @@ mysql_free_result($result);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_listtables</function>
</para>
</simpara>
</note>
</refsect1>

14
reference/mysql/functions/mysql-num-fields.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-num-fields">
<refnamediv>
@@ -24,9 +24,9 @@
<type class="union"><type>int</type><type>false</type></type><methodname>mysql_num_fields</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
クエリから、フィールドの数を取得します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -38,10 +38,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に結果セット <type>resource</type> のフィールド数、
&return.falseforfailure;。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -68,10 +68,10 @@ echo mysql_num_fields($result);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_numfields</function>
</para>
</simpara>
</note>
</refsect1>

18
reference/mysql/functions/mysql-num-rows.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-num-rows">
<refnamediv>
@@ -25,12 +25,12 @@
<type class="union"><type>int</type><type>false</type></type><methodname>mysql_num_rows</methodname>
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
結果セットから行の数を取得します。このコマンドは、
SELECT や SHOW のような、実際に結果セットを返す文に対してのみ有効です。
INSERT、UPDATE、REPLACE、DELETE クエリで変更された行の数を得るには、
<function>mysql_affected_rows</function> を使用してください。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -42,9 +42,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に結果セットの行の数、&return.falseforfailure;。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -72,17 +72,17 @@ echo "$num_rows Rows\n";
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
<function>mysql_unbuffered_query</function> を使用した場合、
結果セットのすべての行を取得するまで
<function>mysql_num_rows</function> は正しい値を返しません。
</para>
</simpara>
</note>
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_numrows</function>
</para>
</simpara>
</note>
</refsect1>

54
reference/mysql/functions/mysql-pconnect.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-pconnect">
<refnamediv>
@@ -37,32 +37,32 @@
<methodparam choice="opt"><type>int</type><parameter>client_flags</parameter></methodparam>
</methodsynopsis>
-->
<para>
<simpara>
MySQL サーバーとの持続的な接続を確立します。
</para>
</simpara>
<!-- TODO: Integrate this information more nicely with features.persistent -->
<para>
<simpara>
<function>mysql_pconnect</function>は、
<function>mysql_connect</function>とよく似た動作をしますが、
2 つの大きな違いがあります。
</para>
<para>
</simpara>
<simpara>
1 番目の違いとして、この関数は接続時にまず
同じホスト、ユーザー名、パスワードを有する(持続的)リンクが
すでにオープンされていないかどうかを調べます。
それがみつかった場合、新規の接続をオープンする代わりに
そのリンクの ID が返されます。
</para>
<para>
</simpara>
<simpara>
2 番目の違いは、スクリプトの実行が終了しても SQL サーバーとの接続が
閉じられないということです。そのかわりに、将来再利用されるために
リンクがオープンされたままとなります（<function>mysql_close</function>
は、<function>mysql_pconnect</function> によって確立されたリンクを
閉じません）。
</para>
<para>
</simpara>
<simpara>
このため、この型のリンクは、'持続的(persistent)'であると言われます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -71,38 +71,38 @@
<varlistentry>
<term><parameter>server</parameter></term>
<listitem>
<para>
<simpara>
MySQL サーバー。"hostname:port" のようにポート番号を
指定することが可能で、localhost では ":/path/to/socket"
のようにソケットへのパスを指定することも可能です。
</para>
<para>
</simpara>
<simpara>
PHP ディレクティブ <link linkend="ini.mysql.default-host">
mysql.default_host</link> が指定されない場合（デフォルト）、
'localhost:3306' が使用されます。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>username</parameter></term>
<listitem>
<para>
<simpara>
ユーザー名。デフォルト値はサーバープロセスの所有ユーザー名です。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>password</parameter></term>
<listitem>
<para>
<simpara>
パスワード。デフォルト値は空のパスワードです。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>client_flags</parameter></term>
<listitem>
<para>
<simpara>
パラメータ <parameter>client_flags</parameter> は、
以下の定数の組み合わせです：
128 (<literal>LOAD DATA LOCAL</literal> の処理を有効にする)、
@@ -110,7 +110,7 @@
<constant>MYSQL_CLIENT_COMPRESS</constant>、
<constant>MYSQL_CLIENT_IGNORE_SPACE</constant> または
<constant>MYSQL_CLIENT_INTERACTIVE</constant>
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -118,26 +118,26 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に MySQL 持続的リンク ID を、失敗した場合に &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
この接続方法は、モジュールバージョンの PHP でのみ使用可能であることに
注意しましょう。詳しい情報は
<link linkend="features.persistent-connections">持続的
データベース接続</link> を参照ください。
</para>
</simpara>
</note>
<warning>
<para>
<simpara>
持続的接続を利用する場合、MySQL の同時接続数の制限をこえないように
Apache や MySQL の設定を多少変更する必要があるかも知れません。
</para>
</simpara>
</warning>
</refsect1>

14
reference/mysql/functions/mysql-ping.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-ping">
<refnamediv>
<refname>mysql_ping</refname>
@@ -22,16 +22,16 @@
<type>bool</type><methodname>mysql_ping</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
サーバーとの接続が有効かどうかを調べます。
もし接続が切れていた場合、自動的に再接続が試みられます。
この関数は、アイドル期間が長いスクリプトで利用し、
サーバーが接続を切断したかどうかを確認するために用いられます。
</para>
</simpara>
<note>
<para>
<simpara>
MySQL 5.0.3 以降、自動再接続機能は使えなくなりました。
</para>
</simpara>
</note>
</refsect1>
@@ -44,10 +44,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
MySQL サーバーとの接続が有効な場合に &true; そうでない場合に
&false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

42
reference/mysql/functions/mysql-query.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-query">
<refnamediv>
@@ -25,12 +25,12 @@
<methodparam><type>string</type><parameter>query</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_query</function> は、
ひとつのクエリを送信します (複数クエリの送信はサポートしません)。
送信先は、<parameter>link_identifier</parameter>
で指定したサーバー上にある、現在アクティブなデータベースです。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,14 +39,14 @@
<varlistentry>
<term><parameter>query</parameter></term>
<listitem>
<para>
<simpara>
SQL クエリ。
</para>
<para>
</simpara>
<simpara>
クエリ文字列は、セミコロンで終えてはいけません。
クエリ内のデータは <link linkend="function.mysql-real-escape-string">適切にエスケープ</link>
する必要があります。
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -55,40 +55,40 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
SELECT, SHOW, DESCRIBE や EXPLAIN 文、その他結果セットを返す文では、
<function>mysql_query</function> は成功した場合に
<type>resource</type> を返します。エラー時には &false; を返します。
</para>
<para>
</simpara>
<simpara>
それ以外の SQL 文 INSERT, UPDATE, DELETE, DROP などでは、
<function>mysql_query</function> は成功した場合に
&true; 、エラー時に &false; を返します。
</para>
<para>
</simpara>
<simpara>
返された結果にアクセスするためには、結果リソースを
<function>mysql_fetch_array</function> やその他の関数に渡します。
</para>
<para>
</simpara>
<simpara>
SELECT 文によって返された行の数を知るには
<function>mysql_num_rows</function> を用います。また
DELETE, INSERT, REPLACE, または UPDATE 文で変更された行の数を
知るには <function>mysql_affected_rows</function> を用います。
</para>
<para>
</simpara>
<simpara>
クエリが参照するテーブルにアクセスする権限がない場合も
<function>mysql_query</function>は失敗し、&false; が返されます。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>間違ったクエリ</title>
<para>
<simpara>
次のクエリは文法的に間違っているので、
<function>mysql_query</function>は失敗し &false;を返します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -103,10 +103,10 @@ if (!$result) {
</example>
<example>
<title>正しいクエリ</title>
<para>
<simpara>
次のクエリは正しいので、<function>mysql_query</function>
は <type>resource</type> を返します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php

50
reference/mysql/functions/mysql-real-escape-string.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-real-escape-string">
<refnamediv>
<refname>mysql_real_escape_string</refname>
@@ -24,28 +24,28 @@
<methodparam><type>string</type><parameter>unescaped_string</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
現在の接続の文字セットで <parameter>unescaped_string</parameter>
の特殊文字をエスケープし、 <function>mysql_query</function>
で安全に利用できる形式に変換します。バイナリデータを挿入しようとしている場合、
必ずこの関数を利用しなければなりません。
</para>
<para>
</simpara>
<simpara>
<function>mysql_real_escape_string</function> は、MySQL のライブラリ関数
mysql_real_escape_string をコールしています。
これは以下の文字について先頭にバックスラッシュを付加します。
<literal>\x00</literal>, <literal>\n</literal>,
<literal>\r</literal>, <literal>\</literal>, <literal>'</literal>,
<literal>"</literal> そして <literal>\x1a</literal>.
</para>
<para>
</simpara>
<simpara>
データの安全性を確保するため、MySQL へクエリを送信する場合には
（わずかな例外を除いて）常にこの関数を用いなければなりません。
</para>
</simpara>
<caution>
<title>セキュリティ: デフォルトの文字セット</title>
<para>
<simpara>
サーバーレベルで設定するなり API 関数
<function>mysql_set_charset</function> を使うなりして、
文字セットを明示しておく必要があります。この文字セットが
@@ -53,7 +53,7 @@
に影響を及ぼします。詳細は
<link linkend="mysqlinfo.concepts.charset">文字セットの概念</link>
を参照ください。
</para>
</simpara>
</caution>
</refsect1>
@@ -63,9 +63,9 @@
<varlistentry>
<term><parameter>unescaped_string</parameter></term>
<listitem>
<para>
<simpara>
エスケープされる文字列。
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -74,18 +74,18 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合にエスケープ後の文字列、失敗した場合に &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="errors">
&reftitle.errors;
<para>
<simpara>
MySQL 接続が存在しない状態でこの関数を実行すると、
<constant>E_WARNING</constant> レベルのエラーが発生します。
この関数は、MySQL 接続が確立した状態でのみ実行するようにしましょう。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -109,9 +109,9 @@ $query = sprintf("SELECT * FROM users WHERE user='%s' AND password='%s'",
</example>
<example>
<title><function>mysql_real_escape_string</function> には接続が必須であることを示す例</title>
<para>
<simpara>
この例では、MySQL 接続が存在しない状態でこの関数を実行したときにどうなるかを示します。
</para>
</simpara>
<programlisting role="php">
<![CDATA[
<?php
@@ -156,37 +156,37 @@ echo $query;
?>
]]>
</programlisting>
<para>
<simpara>
MySQL に送信されたクエリは次のとおり:
</para>
</simpara>
<screen>
<![CDATA[
SELECT * FROM users WHERE user='aidan' AND password='' OR ''=''
]]>
</screen>
<para>
<simpara>
これでは、パスワードを知らなくても誰でもログインできてしまいます。
</para>
</simpara>
</example>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
<function>mysql_real_escape_string</function> を利用する前に、MySQL
接続が確立されている必要があります。もし存在しなければ、
<constant>E_WARNING</constant> レベルのエラーが生成され、&false;
が返されます。<parameter>link_identifier</parameter> が指定されなかった場合は、
直近の MySQL 接続が用いられます。
</para>
</simpara>
</note>
<note>
<para>
<simpara>
この関数を用いてデータをエスケープしなければ、クエリは
<link linkend="security.database.sql-injection">SQL インジェクション攻撃</link>
に対しての脆弱性を持ったものになります。
</para>
</simpara>
</note>
<note>
<simpara>

30
reference/mysql/functions/mysql-result.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-result">
<refnamediv>
@@ -30,10 +30,10 @@
<methodparam><type>int</type><parameter>row</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>field</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
MySQL の結果セットからひとつのセルの内容を取得します。
</para>
<para>
</simpara>
<simpara>
大量の結果セットで作業を行う際は、行全体を取り込む関数のうちひとつを
使用することを検討するべきです（以下で説明します）。
これらの関数は一回の関数コールで複数のセルの内容を返すので、
@@ -41,7 +41,7 @@
また、フィールド引数としてオフセット数値を指定する方が
フィールド名やテーブル名.フィールド名のように指定するよりも
かなり高速です。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -51,25 +51,25 @@
<varlistentry>
<term><parameter>row</parameter></term>
<listitem>
<para>
<simpara>
結果から取得する行の番号。行番号は <literal>0</literal>
からはじまります。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>field</parameter></term>
<listitem>
<para>
<simpara>
取得したいフィールド名またはフィールドのオフセット。
</para>
<para>
</simpara>
<simpara>
フィールドのオフセット、フィールド名またはテーブル名.フィールド名を
指定可能です。カラム名のエイリアスが定義されている
（'select foo as bar from...'）場合、そのカラム名の代わりに
エイリアスを使用してください。指定しなかった場合は最初のフィールドを
取得します。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -77,10 +77,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合に MySQL 結果セットのひとつのセルの内容、
失敗した場合に &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -113,10 +113,10 @@ mysql_close($link);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
<function>mysql_result</function> は、
結果セットを処理するほかの関数と混用することはできません。
</para>
</simpara>
</note>
</refsect1>

18
reference/mysql/functions/mysql-select-db.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-select-db">
<refnamediv>
@@ -25,12 +25,12 @@
<methodparam><type>string</type><parameter>database_name</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
指定したリンク ID が指すサーバー上のデータベースを、アクティブな
データベースに設定します。それ以降にコールされる
<function>mysql_query</function> は、すべてアクティブなデータベース上で
実行されます。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,9 +39,9 @@
<varlistentry>
<term><parameter>database_name</parameter></term>
<listitem>
<para>
<simpara>
選択するデータベース名。
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -50,9 +50,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -82,10 +82,10 @@ if (!$db_selected) {
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
&info.deprecated.alias;
<function>mysql_selectdb</function>
</para>
</simpara>
</note>
</refsect1>

22
reference/mysql/functions/mysql-set-charset.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.mysql-set-charset">
<refnamediv>
<refname>mysql_set_charset</refname>
@@ -24,9 +24,9 @@
<methodparam><type>string</type><parameter>charset</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
現在の接続における、デフォルトの文字セットを設定します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -35,9 +35,9 @@
<varlistentry>
<term><parameter>charset</parameter></term>
<listitem>
<para>
<simpara>
有効な文字セット名。
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -46,26 +46,26 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
この関数は、MySQL 5.0.7 以降でないと使用できません。
</para>
</simpara>
</note>
<note>
<para>
<simpara>
文字セットを変更するにはこの方法を使うことを推奨します。
<function>mysql_query</function> で (<literal>SET NAMES utf8</literal> などとして)
設定する方法はお勧めできません。詳細は
<link linkend="mysqlinfo.concepts.charset">MySQL の文字セットの概念</link>
を参照ください。
</para>
</simpara>
</note>
</refsect1>

10
reference/mysql/functions/mysql-stat.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-stat">
<refnamediv>
<refname>mysql_stat</refname>
@@ -27,9 +27,9 @@
<type>string</type><methodname>mysql_stat</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_stat</function> は現在のサーバーの状態を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -41,13 +41,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
稼働時間、スレッド、クエリ、オープンされているテーブル、フラッシュされた
テーブル、そして 1 秒あたりのクエリ数を文字列で返します。その他のデータも
含めた完全な状態を得るには、<literal>SHOW STATUS</literal> SQL コマンドを
実行する必要があります。<parameter>link_identifier</parameter> が不正な
場合には &null; が返されます。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

30
reference/mysql/functions/mysql-tablename.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-tablename">
<refnamediv>
@@ -24,14 +24,14 @@
<methodparam><type>resource</type><parameter>result</parameter></methodparam>
<methodparam><type>int</type><parameter>i</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
<parameter>result</parameter> からテーブル名を取得します。
</para>
<para>
</simpara>
<simpara>
この関数は非推奨です。かわりに
<function>mysql_query</function> を利用して <literal>SHOW TABLES
[FROM db_name] [LIKE 'pattern']</literal> 文を発行することを推奨します。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -40,18 +40,18 @@
<varlistentry>
<term><parameter>result</parameter></term>
<listitem>
<para>
<simpara>
<function>mysql_list_tables</function> から返される
結果ポインタ <type>resource</type> 。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>i</parameter></term>
<listitem>
<para>
<simpara>
整数のインデックス（行/テーブル 番号）。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -59,15 +59,15 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合にテーブル名、&return.falseforfailure;。
</para>
<para>
</simpara>
<simpara>
結果ポインタの中身を調べるために
<function>mysql_tablename</function> 関数を利用し、取得したテーブルを
利用するには <function>mysql_fetch_array</function> などの関数を
利用してください。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">
@@ -94,10 +94,10 @@ mysql_free_result($result);
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
結果ポインタに含まれるテーブル数を調べるには
<function>mysql_num_rows</function> 関数を利用します。
</para>
</simpara>
</note>
</refsect1>

10
reference/mysql/functions/mysql-thread-id.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-thread-id">
<refnamediv>
<refname>mysql_thread_id</refname>
@@ -22,12 +22,12 @@
<type class="union"><type>int</type><type>false</type></type><methodname>mysql_thread_id</methodname>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
カレントのスレッド ID を取得します。接続が一度切断され、
<function>mysql_ping</function> によって再接続された場合には、
スレッド ID は変わります。つまり、スレッド ID は必要になったその時点で
取得すべきだということです。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -39,9 +39,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
成功した場合にスレッド ID 、&return.falseforfailure;。
</para>
</simpara>
</refsect1>
<refsect1 role="examples">

26
reference/mysql/functions/mysql-unbuffered-query.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.mysql-unbuffered-query">
<refnamediv>
<refname>mysql_unbuffered_query</refname>
@@ -23,7 +23,7 @@
<methodparam><type>string</type><parameter>query</parameter></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>link_identifier</parameter><initializer>NULL</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
<function>mysql_unbuffered_query</function> は SQL クエリ
<parameter>query</parameter> を MySQL に送信します。その際、
<function>mysql_query</function> が行っているような自動バッファリングを
@@ -32,7 +32,7 @@
はじめることができます。SQL の処理が完全に終わるまで待つ必要がありません。
複数の DB 接続を利用する場合には、オプションのパラメータ
<parameter>link_identifier</parameter> を指定する必要があります。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
@@ -41,13 +41,13 @@
<varlistentry>
<term><parameter>query</parameter></term>
<listitem>
<para>
<simpara>
実行する SQL クエリ。
</para>
<para>
</simpara>
<simpara>
クエリ内のデータは <link linkend="function.mysql-real-escape-string">適切にエスケープ</link>
する必要があります。
</para>
</simpara>
</listitem>
</varlistentry>
&mysql.linkid.description;
@@ -56,22 +56,22 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
SELECT, SHOW, DESCRIBE あるいは EXPLAIN では、
<function>mysql_unbuffered_query</function> は
成功した場合に <type>resource</type> 、エラー時に &false; を返します。
</para>
<para>
</simpara>
<simpara>
UPDATE, DELETE, DROP, などその他の SQL 文では、
<function>mysql_unbuffered_query</function> は
成功した場合に &true; 、エラー時に &false; を返します。
</para>
</simpara>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
<simpara>
<function>mysql_unbuffered_query</function> の利点には、以下のような
代償があります:
<function>mysql_unbuffered_query</function> から返される結果セットには、
@@ -80,7 +80,7 @@
を使用できません。また、結果の行をすべてフェッチするまで、
同じ <parameter>link_identifier</parameter>
を使って MySQL に新しいクエリを送信することができません。
</para>
</simpara>
</note>
</refsect1>

46
reference/mysql/ini.xml
View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb0f34cf97860c362ff10ebb050fc80daff9876b Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: takagi -->
<section xmlns="http://docbook.org/ns/docbook" xml:id="mysql.configuration">
&reftitle.runtime;
@@ -100,9 +100,9 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
PHP 側から、LOAD DATA 文によるローカルファイルへのアクセスを許可する。
</para>
</simpara>
</listitem>
</varlistentry>
@@ -112,11 +112,11 @@
<type>bool</type>
</term>
<listitem>
<para>
<simpara>
MySQL への
<link linkend="features.persistent-connections">持続的接続
</link>を可能にするかどうか。
</para>
</simpara>
</listitem>
</varlistentry>
@@ -126,9 +126,9 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
プロセス毎の持続的 MySQL 接続の最大数。
</para>
</simpara>
</listitem>
</varlistentry>
@@ -138,9 +138,9 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
持続的接続を含むプロセス毎の MySQL 接続の最大数。
</para>
</simpara>
</listitem>
</varlistentry>
@@ -150,11 +150,11 @@
<type>bool</type>
</term>
<listitem>
<para>
<simpara>
トレースモード。<literal>mysql.trace_mode</literal> が有効の場合、
テーブル/インデックスのスキャン時の警告・結果セットの未開放・SQL エラー
などが画面に表示されます（PHP 4.3.0 以降で使用可能です）。
</para>
</simpara>
</listitem>
</varlistentry>
@@ -164,7 +164,7 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
他のポートが指定されない場合、データベースサーバー接続時に使用される
デフォルトの TCP ポート番号。デフォルトが指定されない場合は、
環境変数 <envar>MYSQL_TCP_PORT</envar>・
@@ -172,7 +172,7 @@
<literal>mysql-tcp</literal>エントリ・コンパイル時の
<constant>MYSQL_PORT</constant> 定数の順番でポートが取得されます。
Win32 では、<constant>MYSQL_PORT</constant> 定数のみが使用されます。
</para>
</simpara>
</listitem>
</varlistentry>
@@ -182,10 +182,10 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
他にソケット名が指定されない場合、ローカルなデータベースサーバーに
接続する時のデフォルトのソケット名。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mysql.default-host">
@@ -194,11 +194,11 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
他のサーバー名が指定されない場合に、データベースサーバーへの接続時に
使用されるデフォルトのサーバー名。
&sqlsafemode; では適用されません。
</para>
</simpara>
</listitem>
</varlistentry>
@@ -208,11 +208,11 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
他のユーザー名が指定されない場合に、データベースサーバーへの接続時に
使用されるデフォルトのユーザー名。
&sqlsafemode; では適用されません。
</para>
</simpara>
</listitem>
</varlistentry>
@@ -222,11 +222,11 @@
<type>string</type>
</term>
<listitem>
<para>
<simpara>
他のパスワードが指定されない場合に、データベースサーバーへの接続時に
使用されるデフォルトのパスワード。
&sqlsafemode; では適用されません。
</para>
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.mysql.connect-timeout">
@@ -235,10 +235,10 @@
<type>int</type>
</term>
<listitem>
<para>
<simpara>
接続の有効時間(単位:秒)。Linux では、この有効時間はサーバーからの
最初の応答の待ち時間としても使用されます。
</para>
</simpara>
</listitem>
</varlistentry>

11
reference/mysql/reference.xml
View File

@@ -1,22 +1,21 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: hirokawa Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: takagi -->
<reference xml:id="ref.mysql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<reference xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="ref.mysql">
<title>MySQL &Functions;</title>
<partintro>
<section xml:id="mysql.notes">
&reftitle.notes;
<note>
<para>
<simpara>
ほとんどの MySQL 関数は、<parameter>link_identifier</parameter> を
最後のパラメータとしてオプションで受け付けます。これを指定しなかった場合、
直近にオープンされた接続が使用されます。もし直近の接続が存在しない場合、
&php.ini; のデフォルトパラメータを使用して接続を確立しようとします。
この試行にも失敗した場合、関数は &false; を返します。
</para>
</simpara>
</note>
</section>
</partintro>
@@ -24,7 +23,6 @@
&reference.mysql.entities.functions;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -45,4 +43,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->

15
reference/mysql/setup.xml
View File

@@ -1,18 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d5a653cf30dde918ae0a9eb897f94107b2084247 Maintainer: takagi Status: ready -->
<!-- EN-Revision: 15d88bef8b9082fb92a3753a9e7551f9cf1836d3 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa -->
<chapter xml:id="mysql.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="mysql.setup">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="mysql.requirements">
&reftitle.required;
<para>
<simpara>
以下の関数を利用可能とするには、MySQL サポートを指定して PHP を
コンパイルする必要があります。
</para>
</simpara>
<warning>
&mysql.alternative.note;
</warning>
@@ -30,16 +29,15 @@
<!-- {{{ Resources -->
<section xml:id="mysql.resources">
&reftitle.resources;
<para>
<simpara>
MySQL モジュールでは、2 種類のリソース型が使用されています。
最初のリソースはデータベース接続のリンク ID で、2 番目のリソースは
クエリ結果を保持するリソースです。
</para>
</simpara>
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
@@ -60,4 +58,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->