LXXVI. YAZ 関数

導入

この拡張モジュールは、情報取得用のZ39.50プロトコルを実装する YAZツールキットへのPHPインターフェース を提供するものです。この拡張モジュールにより、Z39.50ターゲット(サー バー)を並列に検索するZ39.50オリジン(クライアント)を容易に実装する ことが可能になります。

YAZ は、http://www.indexdata.dk/yaz/で取得可能です。この拡張モジュー ルに関する新しい情報、スクリプトの例等を http://www.indexdata.dk/phpyaz/にて 参照可能です。

このモジュールはZ39.50 の複雑さを隠蔽するため、使用法がかなり容 易になります。PHPで利用可能な様々なSQL APIにより提供されているも のに非常によく似たステートレスな持続的接続がサポートされています。 これにより、セッションはステートレスですが、ユーザ間で共有され、 これにより多くの場合に接続および初期化手順が保存されます。

インストール

YAZをコンパイルし、インストールして下さい。PHPをオプション-- with-yazを付けて他の任意のモジュールとコンパイルして下さい。この 手順の概要を以下に示します。


gunzip -c yaz-1.6.tar.gz|tar xf -
gunzip -c php-4.0.X.tar.gz|tar xf -
cd yaz-1.6
./configure --prefix=/usr
make
make install
cd ../php-4.0.X
./configure --with-yaz=/usr/bin
make
make install
      

Example

PHP/YAZ はターゲット(Z-Associations)との接続を保持し続けます。 正の整数で特定の接続のIDを表します。

以下のスクリプトは、APIのパラレルサーチ機能のデモです。 このスクリプトは起動された際に(引数が指定されない場合は)クエリフォー ムを表示し、引数(termおよび一つ以上のhost)がある場合には、配列host にあるターゲットを検索します。

例 1. YAZ()


$num_hosts = count ($host);
if (empty($term) || count($host) == 0) {
    echo '<form method="get">
    <input type="checkbox"
    name="host[]" value="bagel.indexdata.dk/gils">
        GILS test
    <input type="checkbox"
    name="host[]" value="localhost:9999/Default">
        local test
    <input type="checkbox" checked="1"
    name="host[]" value="z3950.bell-labs.com/books">
        BELL Labs Library
    <br>
    RPN Query:
    <input type="text" size="30" name="term">
    <input type="submit" name="action" value="Search">
    ';        
} else {
    echo 'You searced for ' . htmlspecialchars($term) . '<br>';
    for ($i = 0; $i < $num_hosts; $i++) {
        $id[] = yaz_connect($host[$i]);
        yaz_syntax($id[$i],"sutrs");
        yaz_search($id[$i],"rpn",$term);
    }
    yaz_wait();
    for ($i = 0; $i < $num_hosts; $i++) {
        echo '<hr>' . $host[$i] . ":";
        $error = yaz_error($id[$i]);
        if (!empty($error)) {
            echo "Error: $error";
        } else {
            $hits = yaz_hits($id[$i]);
            echo "Result Count $hits";
        }
        echo '<dl>';
        for ($p = 1; $p <= 10; $p++) {
            $rec = yaz_record($id[$i],$p,"string");
            if (empty($rec)) continue;
            echo "<dt><b>$p</b></dt><dd>";
            echo ereg_replace("\n", "<br>\n",$rec);
            echo "</dd>";
        }
        echo '</dl>';
    }
}
      

目次
yaz_addinfo — 詳細なエラー情報を返す
yaz_close — YAZ接続をクローズする
yaz_connect — 成功時に正の接続ID、失敗した場合にゼロを返す
yaz_errno — エラー番号を返す
yaz_error — エラーの内容を返す
yaz_hits — 直近の検索に関するヒット数を返す
yaz_range — 取得するレコードの最大数を指定する
yaz_record — レコードを返す
yaz_search — 検索を準備する
yaz_syntax — 取得時のレコード構文に関してオブジェクトID(OID)を指定する
yaz_wait — クエリを実行する