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 이 추가되었습니다. |
기타
- yaz_close() - YAZ 연결 닫기