|
|
@@ -1,6 +1,6 @@
|
|
|
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
<!-- Reviewed: no -->
|
|
|
-<!-- EN-Revision: 18786 -->
|
|
|
+<!-- EN-Revision: 18821 -->
|
|
|
<sect1 id="zend.db.adapter">
|
|
|
|
|
|
<title>Zend_Db_Adapter</title>
|
|
|
@@ -115,7 +115,7 @@
|
|
|
<title>Zend_Db アダプタのコンストラクタの使用</title>
|
|
|
|
|
|
<para>
|
|
|
- コンストラクタを使用して、アダプタのインスタンスを作成することができます。
|
|
|
+ コンストラクタを使用して、アダプタのインスタンスを作成できます。
|
|
|
アダプタのコンストラクタが受け取る引数はひとつで、
|
|
|
接続を確立するために必要なパラメータを配列で渡します。
|
|
|
</para>
|
|
|
@@ -148,7 +148,7 @@ $db = new Zend_Db_Adapter_Pdo_Mysql(array(
|
|
|
|
|
|
<para>
|
|
|
最初の引数には、アダプタクラスのベース名を文字列で指定します。
|
|
|
- たとえば、文字列 'Pdo_Mysql' は <classname>Zend_Db_Adapter_Pdo_Mysql</classname>
|
|
|
+ たとえば、文字列 '<classname>Pdo_Mysql</classname>' は <classname>Zend_Db_Adapter_Pdo_Mysql</classname>
|
|
|
クラスに対応します。その次の引数は、
|
|
|
アダプタのコンストラクタに指定するのと同じ形式の配列となります。
|
|
|
</para>
|
|
|
@@ -175,7 +175,7 @@ $db = Zend_Db::factory('Pdo_Mysql', array(
|
|
|
<para>
|
|
|
独自に <classname>Zend_Db_Adapter_Abstract</classname>
|
|
|
の派生クラスを作成し、そのクラス名のプレフィックスが
|
|
|
- "Zend_Db_Adapter" でない場合に <methodname>factory()</methodname>
|
|
|
+ "<classname>Zend_Db_Adapter</classname>" でない場合に <methodname>factory()</methodname>
|
|
|
でそのアダプタを読み込むには、
|
|
|
作成したクラス名の先頭の部分をパラメータ配列のキー
|
|
|
'adapterNamespace' で指定します。
|
|
|
@@ -213,9 +213,9 @@ $db = Zend_Db::factory('Pdo_Mysql', array(
|
|
|
|
|
|
<para>
|
|
|
最初の引数に config オブジェクトを渡す場合は、そのプロパティに
|
|
|
- <code>adapter</code> が含まれているものとします。
|
|
|
+ <property>adapter</property> が含まれているものとします。
|
|
|
そこに、アダプタクラス名を表す文字列を指定します。
|
|
|
- また、オプションで <code>params</code> というプロパティも指定することができ、
|
|
|
+ また、オプションで <property>params</property> というプロパティも指定することができ、
|
|
|
その配下のサブプロパティとしてアダプタのパラメータ名を指定します。
|
|
|
これは、<methodname>factory()</methodname> メソッドの
|
|
|
2 番目のパラメータを省略した場合にのみ読み込まれます。
|
|
|
@@ -328,7 +328,7 @@ $db = Zend_Db::factory($config->database);
|
|
|
<listitem>
|
|
|
<para>
|
|
|
<emphasis>adapterNamespace</emphasis>:
|
|
|
- アダプタクラスの名前の先頭が 'Zend_Db_Adapter'
|
|
|
+ アダプタクラスの名前の先頭が '<classname>Zend_Db_Adapter</classname>'
|
|
|
以外である場合に、それを指定します。これは、
|
|
|
Zend 以外が作成したアダプタクラスを
|
|
|
<methodname>factory()</methodname> メソッドで使いたい場合に指定します。
|
|
|
@@ -478,12 +478,12 @@ $db = Zend_Db::factory('Pdo_Mysql', $params);
|
|
|
(<classname>Zend_Db_Select</classname> オブジェクトなど) にとっても有用です。
|
|
|
デフォルトではアダプタのシリアライズが許可されています。
|
|
|
シリアライズをしたくない場合は、上の例のように
|
|
|
- <classname>Zend_Db::ALLOW_SERIALIZATION=false</classname> オプションを渡します。
|
|
|
+ <constant>Zend_Db::ALLOW_SERIALIZATION</constant> オプションに <constant>FALSE</constant> を渡します。
|
|
|
遅延接続の理念を尊重し、アンシリアライズされたアダプタの
|
|
|
自動再接続は行いません。つまり、自分で
|
|
|
<methodname>getConnection()</methodname> をコールしなければなりません。
|
|
|
- 自動再接続を有効にするには、アダプタのオプションに
|
|
|
- <classname>Zend_Db::AUTO_RECONNECT_ON_UNSERIALIZE=true</classname>
|
|
|
+ 自動再接続を有効にするには、アダプタのオプションとして
|
|
|
+ <constant>Zend_Db::AUTO_RECONNECT_ON_UNSERIALIZE</constant> に <constant>TRUE</constant>
|
|
|
を渡します。
|
|
|
</para>
|
|
|
|
|
|
@@ -580,10 +580,10 @@ CREATE TABLE bugs_products (
|
|
|
]]></programlisting>
|
|
|
|
|
|
<para>
|
|
|
- また、<code>bugs</code> テーブルには <code>accounts</code>
|
|
|
+ また、'bugs' テーブルには 'accounts'
|
|
|
テーブルを指す外部キー参照が複数含まれることにも注意しましょう。
|
|
|
それぞれの外部キーは、そのバグに対して
|
|
|
- <code>accounts</code> テーブルの別々の行を参照することもあります。
|
|
|
+ 'accounts' テーブルの別々の行を参照することもあります。
|
|
|
</para>
|
|
|
|
|
|
<para>
|
|
|
@@ -870,7 +870,7 @@ echo $result;
|
|
|
<para>
|
|
|
アダプタクラスを使用して、
|
|
|
新しいデータをデータベースに書き込んだり
|
|
|
- 既存のデータに変更を加えたりすることができます。
|
|
|
+ 既存のデータに変更を加えたりできます。
|
|
|
ここでは、そのためのメソッドについて説明します。
|
|
|
</para>
|
|
|
|
|
|
@@ -952,7 +952,7 @@ $db->insert('bugs', $data);
|
|
|
<para>
|
|
|
そのテーブルで自動インクリメントの主キーを定義している場合は、
|
|
|
データを追加した後で <methodname>lastInsertId()</methodname>
|
|
|
- メソッドを使用することができます。このメソッドは、
|
|
|
+ メソッドを使用できます。このメソッドは、
|
|
|
現在のデータベース接続において最後に自動生成された値を返します。
|
|
|
</para>
|
|
|
|
|
|
@@ -968,7 +968,7 @@ $id = $db->lastInsertId();
|
|
|
|
|
|
<para>
|
|
|
<acronym>RDBMS</acronym> によっては、シーケンスをサポートしているものもあります。
|
|
|
- シーケンスを使用して、主キー用の一意な値を生成することができます。
|
|
|
+ シーケンスを使用して、主キー用の一意な値を生成できます。
|
|
|
シーケンスをサポートするために、<methodname>lastInsertId()</methodname>
|
|
|
ではオプションの文字列引数を 2 つ受け取れるようにしています。
|
|
|
これらの引数には、それぞれテーブル名とカラム名を指定します。
|
|
|
@@ -1012,10 +1012,10 @@ $id = $db->lastSequenceId('bugs_id_gen');
|
|
|
<para>
|
|
|
シーケンスをサポートしていない <acronym>RDBMS</acronym>、たとえば MySQL や
|
|
|
Microsoft SQL Server、SQLite などの場合、
|
|
|
- lastInsertId() メソッドの引数は無視されます。
|
|
|
+ <methodname>lastInsertId()</methodname> メソッドの引数は無視されます。
|
|
|
このメソッドの返り値は、現在の接続で最後に実行された
|
|
|
INSERT 操作が生成した値となります。また、これらの <acronym>RDBMS</acronym> では
|
|
|
- lastSequenceId() メソッドの返り値は常に <constant>NULL</constant>
|
|
|
+ <methodname>lastSequenceId()</methodname> メソッドの返り値は常に <constant>NULL</constant>
|
|
|
となります。
|
|
|
</para>
|
|
|
|
|
|
@@ -1025,7 +1025,7 @@ $id = $db->lastSequenceId('bugs_id_gen');
|
|
|
たしかにこのクエリは、最後にテーブルに追加された主キーの値を返すこともあります。
|
|
|
しかしこれは、複数のクライアントがデータベースにレコードを追加するという環境では
|
|
|
安全ではありません。
|
|
|
- つまり、データを追加してから MAX(id) の値を取得するまでの間に
|
|
|
+ つまり、データを追加してから <methodname>MAX(id)</methodname> の値を取得するまでの間に
|
|
|
他のクライアントが別のデータを追加する可能性があるということです。
|
|
|
この場合、クエリが返す結果はあなたが実際に追加した行の ID とは異なり、
|
|
|
誰か他の人が追加した行の ID となってしまいます。
|
|
|
@@ -1237,7 +1237,7 @@ echo $sql;
|
|
|
|
|
|
<para>
|
|
|
<classname>Zend_Db</classname> Adapter クラスの提供する便利な関数を使用すると、
|
|
|
- あなたの <acronym>PHP</acronym> コードが <acronym>SQL</acronym> インジェクション攻撃を受ける危険性を軽減することができます。
|
|
|
+ あなたの <acronym>PHP</acronym> コードが <acronym>SQL</acronym> インジェクション攻撃を受ける危険性を軽減できます。
|
|
|
この攻撃を回避する方法は、<acronym>PHP</acronym> のクォート文字のような特殊文字を
|
|
|
正しくエスケープしてから <acronym>SQL</acronym> に使用することです。
|
|
|
これにより、不意に (あるいは故意に)
|
|
|
@@ -1255,7 +1255,7 @@ echo $sql;
|
|
|
エスケープ処理は、使用している <acronym>RDBMS</acronym>
|
|
|
にあわせて適切に行われます。
|
|
|
文字列の両端に使用する区切り文字は、標準の <acronym>SQL</acronym>
|
|
|
- ではシングルクォート (<code>'</code>) となります。
|
|
|
+ ではシングルクォート (') となります。
|
|
|
</para>
|
|
|
|
|
|
<example id="zend.db.adapter.quoting.quote.example">
|
|
|
@@ -1285,7 +1285,7 @@ echo $sql;
|
|
|
数値型カラムや計算式で利用できなくなってしまうという
|
|
|
<acronym>RDBMS</acronym> もあります。つまり、次のような <acronym>SQL</acronym>
|
|
|
がエラーになってしまう実装があるということです。
|
|
|
- ここで、<code>intColumn</code> のデータ型は
|
|
|
+ ここで、 <property>intColumn</property> のデータ型は
|
|
|
<constant>INTEGER</constant> であるものとします。
|
|
|
|
|
|
<programlisting language="php"><
yoshida@zend.co.jp