array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.yaz-connect.php', 1 => 'yaz_connect', 2 => 'Prepara para uma conexão com um servidor Z39.50', ), 'up' => array ( 0 => 'ref.yaz.php', 1 => 'Funções de YAZ', ), 'prev' => array ( 0 => 'function.yaz-close.php', 1 => 'yaz_close', ), 'next' => array ( 0 => 'function.yaz-database.php', 1 => 'yaz_database', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/yaz/functions/yaz-connect.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

yaz_connect

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

yaz_connect — Prepara para uma conexão com um servidor Z39.50

Descrição

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

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.

Parâmetros

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.

user

Nome de usuário para autenticação.

group

Grupo para autenticação.

password

Senha para autenticação.

cookie

Cookie para sessão (proxy YAZ).

proxy

Proxy para conexão (proxy YAZ).

persistent

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().

piggyback

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.

charset

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.

preferredMessageSize

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.

maximumRecordSize

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.

Valor Retornado

Um recurso de conexão em caso de sucesso, false em caso de erro.

Veja Também