Функции YAZ
Это расширение предлагает интерфейс PHP с набором утилит YAZ, реализующим протокол Z39.50
Z39.50
Protocol for Information Retrieval. С помощью этого расширения вы легко сможете
реализовать 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 |
Если вы хотите использовать YAZ как shared-расширение, добавьте следущие строки в php.ini для Unix:
и для Windows:
В 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 для выполнения