XXII. dbx 関数

導入

dbx モジュールは、データベース抽象化レイヤ (db 'X'、ただし 'X' はサポートされるデータベースの一つを意味します)のことです。dbx 関数により、サポートされる全てのデータベースを単一の呼出表記によりアクセスすることが可能になります。dbx 関数自体は、データベースへの直接のインターフェイスを有しませんが、それらのデータベースをサポートするために使用されるモジュールへのインターフェイスを有します。

要件

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以降で利用可能)

dbxにデータベースのサポートを追加するためのドキュメントは、にあります。

インストール手順

これらの関数を利用可能にするには、 --enable-dbx オプションを使用して dbxサポートを有効にし、また、使用するデータベースに関するオプション、例えば、MySQL の場合は --with-mysql=[DIR] も指定して PHPをコンパイルする必要があります。 dbxモジュールで他のサポートされるデータベースを動作させるには、指定したドキュメントを参照して下さい。

実行用の設定

これらの関数の動作は、php.iniの設定により変化します。

表 1. DBX設定オプション

名前	デフォルト	変更の可否
dbx.colnames_case	"unchanged"	PHP_INI_SYSTEM

PHP_INI_* 定数に関する詳細と定義については、 ini_set()を参照して下さい。

注意: iniオプションは、PHP 4.3.0から利用可能です。

設定ディレクティブに関する簡単な説明を以下に示します。

dbx.colnames_case string: カラム名は、変更されず("unchanged"の場合)に返すか、大文字 ("uppercase"の場合)または小文字("lowercase"の場合)に変換することができます。このディレクティブは、dbx_query() のフラグで上書きすることが可能です。

リソース型

dbxモジュールでは2種類のリソース型があります。最初のリソースは、データベース接続用のリンク-objectで、2番目はクエリ結果を保持するための結果-object です。

定義済みの定数

これらの定数は、この拡張モジュールで定義されており、この拡張モジュールがPHP内部にコンパイルされているか実行時に動的にロードされるかのどちらかの場合のみ使用可能です。

DBX_MYSQL (integer)
DBX_ODBC (integer)
DBX_PGSQL (integer)
DBX_MSSQL (integer)
DBX_FBSQL (integer)
DBX_OCI8 (integer) (available from PHP 4.3.0)
DBX_SYBASECT (integer)
DBX_SQLITE (integer) (CVS only)
DBX_PERSISTENT (integer)
DBX_RESULT_INFO (integer)
DBX_RESULT_INDEX (integer)
DBX_RESULT_ASSOC (integer)
DBX_RESULT_UNBUFFERED (integer) (CVS only)
DBX_COLNAMES_UNCHANGED (integer) (available from PHP 4.3.0)
DBX_COLNAMES_UPPERCASE (integer) (available from PHP 4.3.0)
DBX_COLNAMES_LOWERCASE (integer) (available from 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 -- Escape a string so it can safely be used in an sql-statement
dbx_fetch_row -- Fetches rows from a query-result that had the DBX_RESULT_UNBUFFERED flag set
dbx_query -- クエリを送信し、(ある場合には)結果を全て取得する
dbx_sort -- カスタマイズされたsort関数により、dbx_queryから結果をソートする

add a note User Contributed Notes
dbx 関数

bart at mediawave dot nl
09-Jul-2004 01:45


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;


}


?>

bart at mediawave dot nl
02-Jul-2004 03: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
25-Nov-2003 09: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
07-Jun-2003 08: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
06-Feb-2003 03:35


For some benchmarks of dbx connecting to mysql compared to native mysql api, adodb, and others, see:

add a note


	downloads \| documentation \| faq \| getting help \| mailing lists \| \| php.net sites \| links \| my php.net

search for in the