(PHP 4 >= 4.0.1, PECL yaz >= 0.9.0)
yaz_connect — Prepara para uma conexão com um servidor Z39.50
Esta função retorna um recurso de conexão em caso de sucesso, zero em caso de falha.
yaz_connect() prepara uma conexão com um servidor Z39.50. Esta função não é bloqueante e não tenta estabelecer uma conexão - ela apenas prepara uma conexão para ser executada posteriormente quando yaz_wait() for chamado.
Nota:
O » proxy YAZ é um proxy Z39.50 disponível gratuitamente.
zurl
Uma string que assume o formato host[:porta][/banco_de_dados]
.
Se a porta for omitida, a porta 210 será usada. Se o banco de dados for omitido,
Default
será usado.
options
Se fornecido como uma string, será tratado como a string de autenticação Z39.50 V2 (OpenAuth).
Se fornecido como um array, o conteúdo do array serve como opções.
Nome de usuário para autenticação.
Grupo para autenticação.
Senha para autenticação.
Cookie para sessão (proxy YAZ).
Proxy para conexão (proxy YAZ).
Um booleano. Se true
a conexão é persistente; se false
a
conexão não é persistente. Por padrão, as conexões são persistentes.
Nota:
Se uma conexão persistente for aberta, não será possível fechá-la mais tarde com yaz_close().
Um booleano. Se true
, piggyback estará habilitado para pesquisas; Se false
piggyback estará desabilitado. Por padrão, o piggyback está habilitado.
Habilitar o piggyback é mais eficiente e geralmente economiza uma viagem de ida e volta pela rede para as primeiras buscas de registros. No entanto, alguns servidores Z39.50 não suportam piggyback ou ignoram nomes de conjuntos de elementos. Para esses, o piggyback deve ser desabilitado.
Uma string que especifica o conjunto de caracteres a ser usado na linguagem Z39.50
e a negociação do conjunto de caracteres. Use strings como:
ISO-8859-1
, UTF-8
ou
UTF-16
.
A maioria dos servidores Z39.50 não oferece suporte a esse recurso (e, portanto, ele é ignorado). Muitos servidores usam a codificação ISO-8859-1 para consultas e mensagens. Registros MARC21/USMARC não são afetados por esta configuração.
Um inteiro que especifica o tamanho máximo em bytes de todos os registros a serem retornados por um destino durante a recuperação. Consulte o » padrão Z39.50 para mais informações.
Nota:
Esta opção é suportada no PECL YAZ 1.0.5 ou posterior.
Um inteiro que especifica o tamanho máximo em bytes de um único registro a ser retornado por um destino durante a recuperação. Esta entidade é chamada de Exceptional-record-size (tamanho de registro excepcional) no » padrão Z39.50.
Nota:
Esta opção é suportada no PECL YAZ 1.0.5 ou posterior.
Um recurso de conexão em caso de sucesso, false
em caso de erro.