導入 (Previous)

(Next) 接続

View this page in	Last updated: Sun, 06 Jul 2008
English \| Dutch \| French \| German \| Hungarian \| Japanese \| Polish \| Russian \| Spanish \| Plain HTML

DSN

DSN -- データソース名 (Data Source Name)

説明

PEAR::MDB2 でデータベースに接続するには、正しい DSN を作成しなければなりません。この DSN は、以下のパーツから構成されています。

phptype: PHP で使用するデータベースバックエンド (例えば mysql や pgsql など)

dbsyntax: データベースで使用する SQL の構文など

protocol: 使用する通信プロトコル (例えば tcp や unix など)

hostspec: ホストの指定 (hostname[:port])

database: DBMS サーバ上で使用するデータベース

username: ログイン時のユーザ名

password: ログイン時のパスワード

proto_opts: おそらく protocol と組み合わせて使用する

option: 追加の接続オプションを、URI クエリ文字列形式で指定する。複数存在する場合は & で連結する。以下の表は、オプションの一部を示したものです。

表 39-1オプションの一覧

名前	説明	型
`charset`	クライアントの文字セットを指定できるバックエンドもあります (setCharset(string $charset, [resource $connection = null]) を実行します)。	string
`new_link` [boolean]	同じホストから複数回の接続があった場合に、新しい接続を作成しない RDBMS があります。このオプションを `TRUE` にすると、そのような場合に強制的に新しい接続を作成しようとします。	boolean

DSN は、連想配列あるいは文字列のいずれかの形式で指定することができます。配列形式を推奨します。というのも、そうすれば余計なパース処理が不要となるからです (接続の例を参照ください)。文字列形式で示した DSN は次のようになります。

phptype(dbsyntax)://username:password@protocol+hostspec/database?option=value

さまざまな変化形があります。

phptype://username:password@protocol+hostspec:110//usr/db_file.db
phptype://username:password@hostspec/database
phptype://username:password@hostspec
phptype://username@hostspec
phptype://hostspec/database
phptype://hostspec
phptype:///database
phptype:///database?option=value&anotheroption=anothervalue
phptype(dbsyntax)
phptype

現在サポートしているデータベースバックエンドは次のとおりです。

fbsql  -> FrontBase
ibase  -> InterBase / Firebird (PHP 5 が必要です)
mssql  -> Microsoft SQL Server (Sybase 用ではありません。PHP を --with-mssql でコンパイルします)
mysql  -> MySQL
mysqli -> MySQL (新しい認証プロトコルをサポートしています) (PHP 5 が必要です)
oci8   -> Oracle 7/8/9/10
pgsql  -> PostgreSQL
querysim -> QuerySim
sqlite -> SQLite 2

このような DSN の書式もサポートしています。

phptype(syntax)://user:pass@protocol(proto_opts)/database

database、option の値、 username あるいは password に DSN の区切り文字として使用する文字が含まれている場合は、それを URI の十六進エンコーディング方式でエスケープします。

: = %3a   / = %2f   @ = %40
+ = %2b   ( = %28   ) = %29
? = %3f   = = %3d   & = %26

警告

中には、すべてのデータベースバックエンドがサポートしているわけではない機能もあることに注意しましょう。

例

例 39-1ソケットを使用したデータベースへの接続

mysql://user@unix(/path/to/socket)/pear

例 39-2標準以外のポートを使用したデータベースへの接続

pgsql://user:pass@tcp(localhost:5555)/pear

例 39-3Unix マシン上の SQLite への、オプションを使用した接続

sqlite:////full/unix/path/to/file.db?mode=0666

例 39-4Windows マシン上の SQLite への、オプションを使用した接続

sqlite:///c:/full/windows/path/to/file.db?mode=0666

例 39-5SSL を使用した MySQLi での接続

mysqli://user:pass@localhost/pear?key=client-key.pem&cert=client-cert.pem

例 39-6サービス名を使用した Oracle への接続

oci8://username:password@foo.example.com[:port]/?service=service

例 39-7"Easy Connect" 方式での Oracle への接続

username/password@[//]host[:port][/service_name]

導入 (Previous)

(Next) 接続

Download Documentation	Last updated: Sun, 06 Jul 2008
Do you think that something on this page is wrong? Please file a bug report or add a note.
User Notes:
Note by: mapopa@gmail.com 2008-05-14 14:45 UTC if you are using firebird on linux then you need to add an extra slash to the db path like this $mdb2 =& MDB2::connect(’ibase://sysdba:masterkey@localhost//var/lib/firebird/2.1/data/employee.fdb’); and you can check the result with the extra debug info if (PEAR::isError($mdb2)) { die($mdb2->getMessage(). ‘,’ . $mdb2->getDebugInfo()); Note by: nilya 2007-07-02 03:59 UTC If you use Firebird database, specify dbsyntax='firebird'. For example, "ibase(firebird)://SYSDBA:masterkey@localhost/dbname". In current version (MDB2_Driver_ibase 1.4.1) this value affects only limiting queries (by setLimit(limit,offset))