CVII. Функции YAZ

Введение

Это расширение предлагает интерфейс PHP с набором утилит YAZ, реализующим протокол Z39.50 для получения информации. С помощью этого расширения вы легко сможете реализовать Z39.50 origin (клиент), который ищет или сканирует Z39.50 targets (серверы) параллельно.

YAZ доступен с http://www.indexdata.dk/yaz/. Вы можете найти новости, примеры скриптов и т.п. для этого расширения http://www.indexdata.dk/phpyaz/.

Этот модуль скрывает сложную работу Z39.50 таким образом, что пользоваться им достаточно легко. Он поддерживает постоянные бесстатусные соединения, очень похожие на соединения, предлагаемые различными SQL API, доступными для PHP. Это означает, что сессии являются бесстатусными, но используются совместно несколькими пользователями, сохраняя таким образом соединение и шаги фазы инициализации в большинстве случаев.

Установка

Скомпилируйте 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

Пример

PHP/YAZ отслеживает соединения с targets (Z-ассоциациями). Положительное целое число представляет ID конкретной ассоциации.

$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_ccl_conf - конфигурирует CCL-разборщик

yaz_ccl_parse - вызывает CCL-разборщик

yaz_close - закрывает YAZ-соединение

yaz_connect - готовит соединение и Z-ассоциацию для Z39.50 target

yaz_database - специфицирует БД в сессии

yaz_element - специфицирует Element-Set Name для получения

yaz_errno - возвращает номер ошибки

yaz_error - возвращает описание ошибки

yaz_hits - возвращает количество попаданий в последнем поиске

yaz_itemorder - готовит Z39.50 Item Order с пакетом ILL-Request

yaz_present - готовит к получению (Z39.50 имеется)

yaz_range - специфицирует максимальное количество записей для получения

yaz_record - возвращает запись

yaz_scan_result - возвращает результат Scan Response

yaz_scan - готовит к сканированию

yaz_search - готовит к поиску

yaz_sort - устанавливает критерий сортировки

yaz_syntax - специфицирует предпочтительный синтаксис записи для получения

yaz_wait - ждёт запросы Z39.50 для выполнения