YAZ yaz_connect

(PHP 4 >= 4.0.1, PECL yaz >= 0.9.0)

yaz_connect — Z39.50 서버 연결 준비


설명

yaz_connect(string $zurl, mixed $options = ?): mixed

이 함수는 성공 시 연결 리소스를 반환하고 실패 시 0을 반환합니다.

yaz_connect()는 Z39.50 서버에 대한 연결을 준비합니다. 이 함수는 비차단적이며 연결 설정을 시도하지 않습니다. 단지 yaz_wait()가 호출될 때 나중에 수행될 연결을 준비합니다.

메모: » YAZ 프록시는 무료로 사용 가능한 Z39.50 프록시입니다.


매개변수

zurl
host[:port][/database] 형식을 취하는 문자열입니다. 포트를 생략하면 포트 210이 사용됩니다. 데이터베이스가 생략된 경우 Default이 사용됩니다.
options
문자열로 주어지면 Z39.50 V2 인증 문자열(OpenAuth)로 취급된다.

배열로 주어지면 배열의 내용이 옵션으로 사용됩니다.

user
인증을 위한 사용자 이름입니다.
group
인증을 위한 그룹입니다.
password
인증용 비밀번호입니다.
cookie
세션용 쿠키(YAZ 프록시).
proxy
연결용 프록시(YAZ 프록시).
persistent
boolean. true이면 연결이 지속됩니다. false인 경우 연결이 지속되지 않습니다. 기본적으로 연결은 영구적입니다.

메모: 영구 연결을 열면 나중에 yaz_close()로 닫을 수 없습니다.

piggyback
boolean. 검색에 대해 true 피기백이 활성화된 경우; false 피기백이 비활성화된 경우. 기본적으로 피기백이 활성화되어 있습니다.

피기백을 활성화하는 것이 더 효율적이며 일반적으로 처음으로 레코드를 가져올 때 네트워크 왕복을 절약합니다. 그러나 일부 Z39.50 서버는 피기백을 지원하지 않거나 요소 집합 이름을 무시합니다. 이를 위해 피기백을 비활성화해야 합니다.

charset
Z39.50 언어 및 문자 집합 협상에서 사용할 문자 집합을 지정하는 문자열입니다. ISO-8859-1, UTF-8, UTF-16과 같은 문자열을 사용합니다.

대부분의 Z39.50 서버는 이 기능을 지원하지 않으므로 무시됩니다. 많은 서버가 쿼리 및 메시지에 ISO-8859-1 인코딩을 사용합니다. MARC21/USMARC 레코드는 이 설정의 영향을 받지 않습니다.

preferredMessageSize
검색하는 동안 대상에서 반환할 모든 레코드의 최대 바이트 크기를 지정하는 정수입니다. 자세한 내용은 » Z39.50 standard을 참조하세요.

메모: 이 옵션은 PECL YAZ 1.0.5 이상에서 지원됩니다.

maximumRecordSize
검색하는 동안 대상에서 반환할 단일 레코드의 최대 바이트 크기를 지정하는 정수입니다. 이 엔티티는 » Z39.50 standard에서 Exceptional-record-size라고 합니다.

메모: 이 옵션은 PECL YAZ 1.0.5 이상에서 지원됩니다.


반환 값

성공 시 연결 리소스, 오류 시 false입니다.


변경 로그

버전 설명
4.1.0 매개변수 options이 추가되었습니다.

기타