« yaz_error
yaz_es_result »

yaz_es

(PECL yaz >= 0.9.0)

yaz_es — 拡張サービスのリクエストを準備する

説明

function yaz_es( resource $id , string $type , array $args ): void

この関数は、拡張サービスのリクエストを準備します。 拡張サービスとは、レコードの更新や蔵書の注文、データベースの管理などの Z39.50 のさまざまな機能のことです。

注意:

Z39.50 サーバーの多くは、拡張サービスをサポートしていません。

yaz_es() は、拡張サービスリクエストのパッケージを作成し、 それを操作キューに配置します。リクエストをサーバーに送信するには yaz_wait() を使用します。 yaz_wait() の処理が完了すると、拡張サービス操作の結果が yaz_es_result() で取得できるようになります。

パラメータ

id

yaz_connect() が返す接続リソース。

type

拡張サービスの形式を表す文字列。 itemorder (蔵書の注文)、 create (データベースの作成)、 drop (データベースの削除)、 commit (操作のコミット)、 update (レコードの更新)、 xmlupdate (XMLの更新) のいずれかです。 個々の形式については、以下の節で指定されます。

args

拡張サービスのオプションに加えてパッケージ固有のオプションを指定する配列。 オプションの形式は、ZOOM C の C API で提供されているものと同じです。 ZOOM » Extended Services を参照ください。

戻り値

値を返しません。

例

例1 レコードの更新

<?php
$con = yaz_connect("myhost/database");
$args = array (
    "record" => "<gils><title>some title</title></gils>",
    "syntax" => "xml",
    "action" => "specialUpdate"
);
yaz_es($con, "update", $args);
yaz_wait();
$result = yaz_es_result($id);
?>

参考

関連キーワード:
拡張   サービス   リクエスト   準備   args   レコード   データベース   操作   wait   title   type   蔵書   注文   サーバー   パッケージ   connect   update   gils   resource   管理   サポート   キュー   配置   送信   完了
関連する関数・ページ:
function.yaz-es-result   book.yaz   ref.yaz   function.win32-delete-service   function.win32-stop-service   function.win32-start-service