導入

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

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

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

インストール手順

YAZ (ANSI/NISO Z39.50 サポート) を取得し、インストールしてください。 YAZ archive から、ソース形式あるいは さまざまな形式のビルド済みパッケージで YAZ が取得可能です。 Debian GNU/Linux、Suse Linux、FreeBSD のようなシステムでは、 ディストリビューションの一部として YAZ が組み込まれています。

PHP 4 シリーズでは、YAZ 拡張モジュールがバンドルされています(しかし、 YAZ 自体はバンドルされていません)。 オプション --with-yaz[=DIR] を 指定し、他の任意のモジュールとあわせて PHP をコンパイルしてください。

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

PHP 5 では YAZ 拡張モジュールは PECL にあり、共有オブジェクト/dll としてインストールされます。 もし pear がインストールされている場合、YAZ 拡張モジュールを ダウンロードして設定・インストールをする最も簡単な方法は pear コマンドを使用することです。

sudo apt-get install libyaz-dev
sudo pear install yaz

Windows では、php_yaz.dll は yaz.dll に依存しています。 yaz.dll は、PHP サイトにある Win32 zip アーカイブに 含まれています。また、YAZ WIN32 area にある Windows 版の YAZ の中にも含まれています。

Windows では、システムが yaz.dll ファイルを 見つけられるよう、PHP のディレクトリを PATH に追加することを 忘れないでください。

YAZ を共有モジュールとして使用する場合、Unix では php.ini の以下の行を 追加(あるいはコメント解除)してください。

extension=php_yaz.so

また、Windows では以下の行になります。

extension=php_yaz.dll

実行時設定

php.ini の設定により動作が変化します。

リソース型

リソース型は定義されていません。

定義済み定数

定数は定義されていません。

例

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

以下のスクリプトは、API の並列検索機能のデモです。引数を指定せずに コールした場合、この関数はクエリフォームを出力します。そうでない場合 （引数を指定した場合）は、配列 host にあるターゲットを 検索します。

例 3. YAZ による並列検索 <?php $host=$_REQUEST[host]; $query=$_REQUEST[query]; $num_hosts = count($host); if (empty($query) || 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="checked"     name="host[]" value="z3950.loc.gov:7090/voyager" />         Library of Congress     <br />     RPN Query:     <input type="text" size="30" name="query" />     <input type="submit" name="action" value="Search" />     </form>     ';         } else {     echo 'You searched for ' . htmlspecialchars($query) . '<br />';     for ($i = 0; $i < $num_hosts; $i++) {         $id[] = yaz_connect($host[$i]);     yaz_syntax($id[$i], "usmarc");         yaz_range($id[$i], 1, 10);         yaz_search($id[$i], "rpn", $query);     }     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 nl2br($rec);             echo "</dd>";         }         echo '</dl>';     } } ?>