Учебник РНР
Назад		Вперёд

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 конкретной ассоциации.

Пример 1. Параллельный поиск с использованием YAZ()

Этот скрипт показывает возможность параллельного поиска этого API. При вызове без аргументов он печатает форму запроса; или (аргументы предоставлены) ищет targets в хосте массива.

$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 для выполнения

Назад	Оглавление	Вперёд
xslt_set_scheme_handlers	Вверх	yaz_addinfo