PHP マニュアル: 利用可能なDSNについての情報を返す

説明

arraynullfalse odbc_data_source(Odbc\Connection $odbc, int $fetch_type)

この関数は、有効な DSN（複数回のコールの後）のリストを返します。

パラメータ

odbc: ODBC 接続オブジェクト。詳細は odbc_connect を参照ください。
fetch_type: fetch_type は次のふたつの定数 SQL_FETCH_FIRST, SQL_FETCH_NEXT のうちのどちらかです。この関数を最初にコールする際には SQL_FETCH_FIRST を、それ以降は SQL_FETCH_NEXT を使用します。

戻り値

エラー時には false、成功時には配列を返します。最後の利用可能なDSNを取得した後は、null を返します。

変更履歴

バージョン	説明
8.4.0	引数 `odbc` は、Odbc\Connection クラスのインスタンスを期待するようになりました。これより前のバージョンでは、resource を期待していました。

例

例1 利用可能なDSNの一覧を表示する

<?php
$conn = odbc_connect('dsn', 'user', 'pass');
$dsn_info = odbc_data_source($conn, SQL_FETCH_FIRST);
while ($dsn_info) {
    print_r($dsn_info);
    $dsn_info = odbc_data_source($conn, SQL_FETCH_NEXT);
}
?>

上の例の出力は、たとえば以下のようになります。

Array
(
    [server] => dsn
    [description] => ODBC Driver 17 for SQL Server
)
Array
(
    [server] => other_dsn
    [description] => Microsoft Access Driver (*.mdb, *.accdb)
)