Функции YAZ
Введение
Это расширение предлагает интерфейс PHP с набором утилит YAZ, реализующим протокол Z39.50 Z39.50 Protocol fo r Information Retrieval. С помощью этого расширения вы легко сможете реализовать Z39.50 origin (клиент), который ищет или сканирует Z39.50 targets (серверы) параллельно.
YAZ доступен с www.indexdata.dk/yaz/. Вы можете найти новости, примеры скриптов и т.п. для этого расширения 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
Если вы хотите использовать YAZ как shared-расширение, добавьте следущие строки в php.ini для Unix: extension=php_yaz.so
и для Windows: extension=php_yaz.dll
В Windows требуется, php_yaz.dll зависимый от yaz.dll. Вы найдете yaz.dll в поставке библиотек dlls для Win32. Скопируйте yaz.dll в директорию PATH (напрример: c:\winnt\system32 или c:\windows\system32).
Пример
PHP/YAZ отслеживает соединения с targets (Z-ассоциациями). Положительное целое число представляет ID конкретной ассоциации.
Пример 1. Параллельный поиск с использованием YAZ()
Этот скрипт показывает возможность параллельного поиска этого API. При вызове без аргументов он печатает форму запроса; или (аргументы предоставлены) ищет targets в хосте массива.<?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>;
}
}
?>
Содержание
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_es_result - инспектирует результат расширенных сервисов
yaz_get_option - возвращает значение опции для соединения
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_schema - определяет схему для поиска
yaz_search - готовит к поиску
yaz_set_option - устанавливает один или более вариантов для подключения
yaz_sort - устанавливает критерий сортировки
yaz_syntax - специфицирует предпочтительный синтаксис записи для получения
yaz_wait - ждёт запросы Z39.50 для выполнения