PEAR: 中間データベース アプリケーション層 1 を作成する

作成|データ|データベース

内容:

1. DB クラスとは何ですか
2. 抽象中間データ層を設計する必要がある理由
3. DB の使用を開始する
4. DB_Common の使用方法のリファレンス
5. さらに一歩進んで、独自の中間データを作成しますデータベース アプリケーション層
6. DB の欠点
7. 参考リソース
著者について

関連コンテンツ:

1. PEAR を使用して次の php プログラムを作成する
2. よく使用されるモジュール
3. PHPDoc を使用して簡単に作成するあなたの PEAR ドキュメント





Pan Fan(nightsailer@hotmail.com)
Beijing Saidi Network Information Technology Co., Ltd.
2001 年 8 月

PHP アプリケーションの場合、90% 以上がデータベースを扱う必要があります。では、データベースはどのように操作するのでしょうか?バックエンド データベースがアップグレードまたは変更された場合、プログラムはスムーズにアップグレードして接続できますか?この問題を検討している場合は、PEAR の DB クラスを使用してデータベースから独立したデータベース アプリケーション層を作成する方法について私と話し合った方がよいでしょう。
1. DBクラスとは
まずはDBクラスについて簡単に理解しましょう。 DB クラスは、データ操作を実行する PEAR のいくつかのクラスのコレクションです。その主な目的は、バックエンド データベースとは関係のない、統合された抽象データ インターフェイスを提供することです。したがって、アプリケーションがこの共通インターフェイスを使用してデータベース操作を実行する場合、MYSQL、SQL、SYBASE などの異なるデータベースにスムーズに切り替えることができます。実際、DB クラスは、PERL の ODBC や DBI に似た単純な役割を果たすことを望んでいます。そういえば、PHP のもう 1 つの優れたライブラリ、ADODB について触れなければなりません。 ADODB は DB と同様に抽象的な中間層を提供し、ADODB は DB よりも多くのバックエンド データベースをサポートします (少なくとも現時点では)。ただし、ADODB は PEAR の一部の機能を直接使用せず、DB を含む多くのアイデアを PEAR から吸収するだけです。 、この 2 つの使い方には多くの類似点があります。どちらが優れているかについてはコメントしません。個人の好みに応じて使用してください。

2. 抽象的な中間データ層を設計する必要があるのはなぜですか? DB の使用について詳しく説明する前に、まず中間データ層を設計する必要がある理由について説明します。たとえば、どのくらいのデータが必要ですか? コードを作成すると、特定のデータベースに限定される一部の機能が直接利用できなくなります。

過去にやったことを思い出してみましょう。MYSQL データベースに接続する方法は?これはまさに小児期の問題です。次のコードに精通している必要があります:
/**
* MYSQLデータベースに接続します
*/
$host = "localhost";

$user = "root";
$passwd = "";
$persistent = 1;

if ($persisternt){
$conn = mysql_connect($host,$user,$passwd);
}else {
$conn = mysql_pconnect($host,$user, $ passwd);
}
?>
さて、データベース接続が確立されたので、それを使用してデータベース操作を実行できます:
function sql_exec($sql) {
global $db_Name;
$result = mysql_db_query($db_dbName,$sql);
if (!$result) {
>" ;
exit(); return $result;
}
$db_Name = "test";
$sql = "ユーザーから * を選択";
$result = sql_exec($sql);
while( $row = mysql_fetch_row($result) ){
echo "名前:$row[0] 性別:$row[1] Age$row[2]
";
}
mysql_free_result($result);
?>



いい感じですね?おそらくコード内で同様のスニペットを多数使用しているでしょう。しかし、あまり喜んではいけません。ここで問題が発生します。突然、データベースを MYSQL から ORACLE や SYBASE などの他のデータベース プラットフォームに移行する必要が生じたとします。移行にはさまざまな理由があります。おそらく、上司が気まぐれでより良い価格で販売できると考えたか、データが急激に増加して MYSQL のパフォーマンスが低下した可能性があります。つまり、移行は必須です。どうやってやるのでしょうか? 「ははは、これは単純です。関連する関数を置き換えるだけです。」と思われるかもしれません。

簡単そうに聞こえますが... まず、データベースに接続する関数を変更する必要があります。Mysql_connect と mysql_pconnect を OCILogon と OCIPLogon に置き換える必要があります。もちろん、mysql_errno や mysql_error() は使用できません。OCIError() によって返された配列から応答情報を抽出する必要があります。

これはそれほど悪いことではありません。関連する mysql_fetch_row、mysql_fetch_array およびその他のステートメントが多くのコード関数およびプロシージャに分散されていて、対応する ORACLE バージョンを 1 つずつ見つけて、置換または作成する必要があります。データベース操作が特定のモジュールまたはクラスに集中している場合は、この作業は許容されます。そうでない場合は、コードの大部分を再読み込みして変更したことになります。たとえこの不幸な人があなたではなかったとしても、彼は密かにあなたを呪うでしょう =)

上記では、私たちの以前の実践とそれがもたらす可能性のある不幸を思い出しました。では、DB クラスを使用して同様の操作を行う場合、どのようにすればよいでしょうか?対応する DB バージョン コードは次のとおりです。
include_once "DB.php";
/*
* データベースに接続します
*/
$db_host = "localhost";
$db_user = "root";
$ db_passwd = "";
$db_dbName = "テスト";
$PersistentConnection = 1;
$db_type ="mysql";
$db_proto ="";
$db = DB::connect("$db_type:/ /$ db_user@$db_passwd:$db_host/$db_dbName",$db_options);
if( DB::isError($db) ){
die "データベースに接続できません。エラー理由: ".DB::errorMessage ($db);
}
function sql_exec($sql) {
global $db;
$result = $db->query($sql);
if (DB::isError($result)){
echo 「データベース エラーが発生しました: ".DB::errorMessage($result);
exit();
}
return $result;
}
///////////////// /////// /////////////////////
$sql = "ユーザーから * を選択";
$result = sql_exec($sql);
while( $row = $result ->fetchRow() ){
echo "名前:$row[0] 性別:$row[1] 年齢$row[2]
";
}
?> ;



データベースへの接続に加えて、一部のエラー処理には、実際には PEAR から継承された PEAR のようなメソッド (isError) が使用されているようです。同じ状況で、データベースを mysql から別の形式 (今回は LINUX の優れたデータベースである PostegreSQL としましょう) に移行する場合、必要な作業は 1 行のコードを変更するだけです。
$db_type = "mysql";
$db_type ="pgsql";


その他、変更する必要はありません。どうですか? アップグレードはとても新鮮に感じられますか? 残りの時間をコードの残りの学習に使ってもいいですし、DB の使用法について引き続き話し合ってもいいですか?

3. DB の入門
DB クラスは 3 つの部分で構成されます:

DB.php これは、DB クラスに多くの「静的」パブリック メソッドを提供するフロントエンド インターフェイスです。通常、必要なのは INCLUDE_ONCE ファイルのみです。 。
DB/common.php これは、バックエンド データベースの共通の抽象クラスです。さまざまなデータベースのバックエンド クラスは、このクラスで定義されているパブリック メソッドとプロパティを継承して実装する必要があります。データベースがサポートされていない場合は、次のように記述できます。アプリケーションを移行できるように、自分でサポート クラスを作成します。
DB/storage.php これは、SQL クエリをオブジェクトとして返し、これらのオブジェクトを維持し、オブジェクトの変更に応じてデータベースを更新できる補助ツールです。

DB/ifx.php
mssql.php Ms SQL Server サポート クラス
oci8.php Orcale 8i サポート クラス
pgsql.php PostegreSQL サポート クラス
sybase.php Sybase サポート クラス
ibase.php ibase サポート クラス
msqlサポート クラス
mysql.php mysql サポート クラス
odbc.php odbc サポート クラス

これらは、対応するバックエンド データベースのサポート クラスです。対応する特定のデータベース操作は、これらのサポート クラスによって実装されます。

以下では、まず DB.PHP のいくつかの「静的」メソッドを詳しく紹介します:

connect() メソッド
このメソッドは最も重要な静的メソッドです。DB_COMMON オブジェクトを取得し、対応するデータベースに接続します。このメソッドのプロトタイプは次のとおりです。
function &connect($dsn, $options = false)
$dsn はデータ ソース名 (データ ソース名) の省略形で、文字列または特定の配列形式にすることができます。

一般に、$dsn は文字列であり、その形式は次のとおりです: phptype(dbsyntax)://username:password@protocol+hostspec/database

、odbc など)
* dbsyntax: データベースで使用される SQL 構文標準。通常は使用されません。 O*プロトコル: 使用される通信プロトコル。 (tcp、unix など)
* hostspec: データベースが配置されているホストの説明。 (形式は: ホスト名 [: ポート番号])
* データベース: データベースの名前。
* ユーザー名: ログインユーザー名。 W*password: パスワードでログインします。




DSN の場合、一般的に使用される形式は次のとおりです:
* phptype://username:password@protocol+hostspec:110//usr/db_file.db
* phptype://username:password@hostspec/ Database_name
* phptype://username:password@hostspec
デフォルト値が使用されます。 S もちろん、$ DSN は配列の形式でも構いません:
$ dsn = Array
$options は、混合型のデータベース オプションです。ブール型の場合、一般的に、このパラメータは永続接続 (永続接続) を使用するかどうかを示します。バックエンド データベースがサポートしている場合、$options が TRUE の場合、永続接続が使用されます。配列の場合、これが特定のバックエンド データベースのオプションであることを意味します。これらのオプションは、DB_common クラスの set_option メソッドに渡されます。バックエンド データベースは、または実装することによって、これらのオプションを使用する方法を決定できます。このメソッドをオーバーロードします。

isError($value)
このメソッドは、DB の一部のメソッドによって返された結果がエラー オブジェクトであるかどうかを判断するために使用されます。このメソッドを使用して、操作の結果が例外であるかどうかを判断できます。

もちろん、アプリケーションが PEAR から継承している場合は、PEAR の isError を直接使用して判断することもできます。特に、プログラムでスローされた例外がデータベース以外の例外である可能性がある場合、このメソッドはそれが DB_Errro オブジェクトであるかどうかを判断することしかできません。他の PEAR_Error オブジェクトは認識できません。

function isWarning($value)
DBメソッドの戻り結果が警告かどうかを判定するメソッドです。エラーとは異なり、警告は致命的ではないため、実行を続行できます。 OnFunction ErrorMessage ($ Value)
エラーが特定されたら、このメソッドを使用して、DB 内の事前定義されたエラー メッセージを取得できます。
db_error = & gt => DB_ERROR_CANNOT_CREATE => "作成できません",
DB_ERROR_CANNOT_DELETE => 削除できません",
DB_ERROR_CONSTRAINT => "制約違反" ,
DB_ERROR_DIVZERO = & GT; "ゼロ除算",
db_error_inValid = & GT; "無効",
db_error_invalid_date = & gt; Error_invalid_number = & gt; "無効な番号"、
db_error_mismatch ",
;    DB_ERROR_NODBSELECTED => "データベースが選択されていません",
DB_ERROR_NOSUCHFIELD => "そのようなフィールドはありません",
DB_ERROR_NOSUCHTABLE => "そのようなテーブルはありません",
DB_ERROR_NOT_CAPABLE => "DB バックエンドが機能しません",
DB_ERROR_NOT_FOUND => "見つかりません"、
DB_ERROR_NOT_LOCKED => "ロックされていません",
DB_ERROR_SYNTAX => "構文エラー",
DB_ERROR_UNSUPPORTED => "サポートされていません",
DB_ERROR_VALUE_COUNT_ON_ROW => "行の値の数",
DB_OK => "エラーなし"、
DB_WARNING => "不明な警告",
DB_WARNING_READ_ONLY => "読み取り専用"




assertExtension($name)
自動ダウンロードされた PHP のデータ ストア エクステンション。 PHP を特定のデータベースにロードする必要がありますが、php.ini の内部を変更する場合は、この関数を使用できます。もちろん、DB もこの方法を使用して必要な PHP データベースをロードすることができます。
比例：你如果必要なoracleの扩展、那么可使用：
include_once "DB.php";
if ( DB::assertExtension("php_oci8") ){
echo "oracle 8扩展追加成功！"；
}else {
die "無法加下oracle 8扩展"；
}
?>


はDB类中定义的"静态"方法，所谓静态方法，是指示你可以不要オブジェクトを構築すると、直接使用でき、DB:: を参照するだけで、これらのメソッドをどこからでも直接使用できます。

DB_Error
このタイプは PEAR_Error から継承されており、データ サービスの操作において、発生した重大なエラーに対して、通常はこのエラーを出力します。

構築関数:
関数 DB_Error($ code = DB_ERROR, $mode = PEAR_ERROR_RETURN, $level = E_USER_NOTICE, $debuginfo = null)
$code は DB 蔙误代，$mode 決定错误処理のモード，缺省は返還，$level 错误级别，
$debuginfo は付加実行される SQL 句などの調整式情報。 1 つの DB_result のこの例では、この種の方法を使用して、バックエンド データベース結果のデータを取得できます。ここで説明する方法は、実際に実行される同じ名前の方法です。

function fetchRow($fetchmode = DB_FETCHMODE_DEFAULT)
一行データを取得、$fetchmod はデータを取得するモードです (指定がない場合は、省エネルギー方式を使用します)。

function fetchInto(&$arr, $fetchmode = DB_FETCHMODE_DEFAULT)
1 行のデータを取得し、同時に所定の $att 数グループに追加します。$att は必要です。

関数 numCols()
結果コレクションの列数を取得します。エラーが発生した場合は、DB_Error オブジェクトを返します。

関数 numRows()
結果コレクションの行数を取得します。 、 DB_Error オブジェクトを返します。

function free()
結果コレクションが占有しているリソース。

ここまで、DB の基本的な使用方法をすでに理解しています。後の会議详细介绍：
接続データベース库：
$db = DB::connect("$db_type://$db_user@$db_passwd:$db_host/$db_dbName",$db_options);

if ( DB::isError($db)){
echo "データベース接続エラー:".DB::errorMessage($db)."
";
exit();
}
/* クエリ 1 */
$sql = "select * from user_log";
$result = $db->query($sql);
if (DB::isError($result) ){
echo "データベース エラー:".DB::errorMessage($result);
exit();
}

$colCount = $result->numCols();
echo "

".$result->numRows()" が見つかりました。 users";
while($row = $result->fetch()){
i=0;$i< ;$colCount;$i++){
エコー "";
}
$result->free();
$db->disconnect();
?>



IV. DB_Common 使用法のリファレンス
DB_Common クラスは A共通インターフェイスを実装することで、データベース プラットフォームを横断する DB の機能が実現されます。データベースが DB でサポートされていない場合は、DB_Common クラスを継承し、これらのインターフェイスの機能を実装するクラスを自分で作成できます。

関数 toString()
現在のクラスの文字列の説明を返します。形式はクラス名です: (phptype="",dbsyntax="")[connected]。通常は次のようになります:
DB_mysql:(phptype=mysql, dbsyntax= )[connected]

function quoteString($string)
クエリ内の一重引用符区切り文字の間に安全に配置できるように文字列を引用符で囲みます。通常、文字フィールドの場合、クエリ時に区切り文字として '' を使用するため、文字列に ' が含まれる場合、この関数は文字列内の ' を ' に置き換えます。

function provided($feature)
現在の DB のバックエンド プログラムが指定された機能を実装し、ブール値を返すかどうかを示します。 $feature は関数の明示的な名前で、通常は「prepare」、「pconnect」、「transactions」です。これらの値はバックエンド プログラムの構築関数で設定する必要があります。例:
エンドデータベースによって生成されたエラーコードは、DB の一般的なエラーコードにマッピングされます。内部通話。バックエンド データベースは、ビルド関数で $errorcode_map プロパティを初期化する必要があります。例 (MySQL):
// DB_MYSQL の構築関数内
$ this-& gt; errorCode_map = Array Reate, 6 1006 = & gt_error_cannot_create,

1007 = & gt DB_ERROR_ALREADY_EXISTS,
1008 => NOT_DROP、1046 => DB_ERROR_NODBSELECTED、1050 => ROR_ALREADY_EXISTS、
1054 => DB_ERROR_NOSUCHFIELD、
1062 => ADY_ EXISTS,
1064 => DB_Error OR_NOSUCHTABLE,
);