Simple function for returning paged result sets.
<?php
// use: pagedQuery($link, $sql, $rows_per_page, $current_page)
function pagedQuery($link, $sql, $nrows = 10, $page = 1) {
$handle = dbx_query($link, $sql, DBX_RESULT_UNBUFFERED);
$result = new stdClass;
$result->link = $this->link;
$result->page = $page;
$result->data = array();
$result->info['name'] = array();
$start = ($page - 1) * $nrows;
$end = $start + $nrows;
$result->rows = 0;
while ($row = dbx_fetch_row($handle)) {
$result->rows++;
if (($result->rows > $start) && ($result->rows <= $end)) {
$result->data[] = $row;
}
}
if ($result->data[0]) {
$result->cols = count($result->data[0]) / 2;
$result->info['name'] = array_slice(array_keys($result->data[0]), $result->cols, $result->cols);
$result->lastPage = ceil($result->rows / $nrows);
}
return $result;
}
?>
dbx 関数
導入
dbx モジュールは、データベース抽象化レイヤ（db 'X' の 'X' は、 サポートされるデータベースの一つを意味します）のことです。dbx 関数 により、サポートされる全てのデータベースを単一の呼出表記により アクセスすることが可能になります。dbx 関数自体は、データベースへの 直接のインターフェイスを有しませんが、それらのデータベースをサポート するために使用されるモジュールへのインターフェイスを有します。
注意: この拡張モジュールは » PECL レポジトリに移動 されており、以下のバージョン以降 PHP にバンドルされなくなっています。 PHP 5.1.0.
要件
dbx モジュールでデータベースを使用可能とするには、そのモジュールが PHP にリンクされるかロードされる必要があり、そのデータベースを dbx モジュールがサポートされている必要があります。現在 以下のデータベースがサポートされていますが、他のデータベースも 追加される予定です。
- FrontBase (PHP 4.1.0 以降で利用可能)
- Microsoft SQL Server
- MySQL
- ODBC
- PostgreSQL
- Sybase-CT (PHP 4.2.0 以降で利用可能)
- Oracle (oci8) (PHP 4.3.0 以降で利用可能)
- SQLite (PHP 5)
dbx にデータベースのサポートを追加するためのドキュメントは、 » http://www.guidance.nl/php/dbx/doc/ にあります。
インストール手順
これらの関数を利用可能にするには、 --enable-dbx オプションを使用して dbx サポートを有効にし、また、使用するデータベースに関するオプション、 例えば MySQL の場合は --with-mysql=[DIR] も指定して PHP をコンパイルする必要があります。 他のサポートされるデータベースを dbx モジュールで動作させるには、 個別のドキュメントを参照してください。
実行時設定
php.ini の設定により動作が変化します。
| 名前 | デフォルト | 変更の可否 | 変更履歴 |
|---|---|---|---|
| dbx.colnames_case | "unchanged" | PHP_INI_SYSTEM | PHP 4.3.0 以降で有効です。PHP 5.1.0 で削除されました。 |
以下に設定ディレクティブに関する 簡単な説明を示します。
- dbx.colnames_case string
-
カラム名は、変更されず("unchanged"の場合)に返すか、大文字 ("uppercase"の場合)または小文字("lowercase"の場合)に変換すること ができます。このディレクティブは、dbx_query() のフラグで上書きすることが可能です。
定義済み定数
以下の定数が定義されています。 この関数の拡張モジュールが PHP 組み込みでコンパイルされているか、 実行時に動的にロードされている場合のみ使用可能です。
- DBX_MYSQL (integer)
- DBX_ODBC (integer)
- DBX_PGSQL (integer)
- DBX_MSSQL (integer)
- DBX_FBSQL (integer)
- DBX_OCI8 (integer) (PHP 4.3.0 以降で有効)
- DBX_SYBASECT (integer)
- DBX_SQLITE (integer) (PHP 5)
- DBX_PERSISTENT (integer)
- DBX_RESULT_INFO (integer)
- DBX_RESULT_INDEX (integer)
- DBX_RESULT_ASSOC (integer)
- DBX_RESULT_UNBUFFERED (integer) (PHP 5)
- DBX_COLNAMES_UNCHANGED (integer) (PHP 4.3.0 以降で有効)
- DBX_COLNAMES_UPPERCASE (integer) (PHP 4.3.0 以降で有効)
- DBX_COLNAMES_LOWERCASE (integer) (PHP 4.3.0 以降で有効)
- DBX_CMP_NATIVE (integer)
- DBX_CMP_TEXT (integer)
- DBX_CMP_NUMBER (integer)
- DBX_CMP_ASC (integer)
- DBX_CMP_DESC (integer)
目次
- dbx_close — オープンされた接続/データベースを閉じる
- dbx_compare — ソートするために二つのレコードを比較する
- dbx_connect — 接続/データベースをオープンする
- dbx_error — 使用するモジュールの最新の関数コールにおけるエラーメッセージを出力する
- dbx_escape_string — SQL ステートメントで安全に使用できるように文字列をエスケープする
- dbx_fetch_row — DBX_RESULT_UNBUFFERED フラグを指定した クエリ結果から、行を取得する
- dbx_query — クエリを送信し、(ある場合には)結果を全て取得する
- dbx_sort — カスタマイズされたソート関数により、dbx_query から結果をソートする
dbx
bart at mediawave dot nl
09-Jul-2004 10:45
09-Jul-2004 10:45
bart at mediawave dot nl
02-Jul-2004 12:12
02-Jul-2004 12:12
Would like to confirm that dbx is at least three times faster than adodb with my application. However, once loaded, adodb has much more features and probably performs better in some situations then dbx.
One of the nice features that adodb has, is the way you can quickly make a dropdown menu from a query. Here's a similar function that works with a dbx result object:
<?php
// $result is the dbx_query result (It expects two fields)
// $name is the name of the dropdown field
// $selected is the option that should be selected
// $firstrow takes a string like "myvalue:myname"
// $attr can be used to add some extra attributes
function dropDown($result, $name, $selected, $firstRow, $attr) {
$s = '<select name="'.$name.'" '.$attr.'>';
if (is_string($firstRow)) {
$row = explode(':', $firstRow);
$s .= '<option value="'.$row[0].'">'.$row[1].'</option>';
} else
$s .= '<option></option>';
foreach ($result->data as $row) {
if ($row[0] == $selected)
$s .= '<option value="'.$row[0].'" selected="selected">'.htmlspecialchars($row[1]).'</option>';
else
$s .= '<option value="'.$row[0].'">'.htmlspecialchars($row[1]).'</option>';
}
return $s.'</select>';
}
?>
rhcf at linux dot ime dot usp dot br
26-Nov-2003 06:52
26-Nov-2003 06:52
BEWARE!!!
dbx_query allocate all retrieved data in an array on memory. If the query result is big (bigger then the memory_limit on php.ini), the result will be empty. So use dbx wih care.
carl [at] carlthompson [dot] net
08-Jun-2003 05:49
08-Jun-2003 05:49
The above benchmark is very misleading. Unfortunately, I found out the hard way by porting my app to ADODB. Most PHP apps are going to be very short-lived therefore startup / setup time is a large factor. This benchmark does not measure that. Just include()ing the main ADODB file added 27ms to my app's startup time! Considering my app took only 16ms to run in total using DBX, the idea of switching to ADODB was DOA before running a single query.
In the end, the total time for my app went from 16ms with DBX to 49ms with ADODB. ADODB's powerful features are obviously not worth that kind of overhead.
Carl Thompson
jlim at natsoft dot com dot my
07-Feb-2003 12:35
07-Feb-2003 12:35
For some benchmarks of dbx connecting to mysql compared to native mysql api, adodb, and others, see:
http://phplens.com/lens/adodb/
http://php.weblogs.com/2003/02/06#a2336