yaz_connect

(PHP 4 >= 4.0.1)

yaz_connect --  Prépare une connexion à un hôte YAZ

Description

resource yaz_connect ( string zurl [, mixed options])

yaz_connect() retourne un identifiant positif en cas de succès, et FALSEsinon.

yaz_connect() prépare une connexion à un serveur Z39.50. zurl est de la forme "host[:port][/database]". Si port est omis, 210 est utilisé. Si database est omis, default est utilisé. yaz_connect() n'est pas bloquante, et ne tente pas d'établir une socket. En fait, elle ne fait que préparer la connexion pour exécution ultérieure par yaz_wait().

Si le second argument options est fourni sous la forme d'une chaîne, il est traité comme une chaîne d'authentification Z39.50 V2 (OpenAuth).

Si options est fourni sous la forme d'un tableau, le contenu du tableau servira d'options. Notez que ce tableau d'options est supporté depuis PHP 4.1.0.

Options yaz_connect()

user

Nom d'utilisateur pour l'authentification.

group

Groupe d'authentification.

password

Mot de passe d'authentification.

cookie

Cookie de session (proxy YAZ).

proxy

Proxy de connexion (proxy YAZ).

persistent

Un booléen. Si il vaut TRUE la connexion sera persistante; Si il vaut FALSE, la connexion ne le sera pas. Par défaut, les connexions sont persistantes.

piggyback

Un booléen. Si il vaut TRUE, piggyback est activé pour les recherches. Si il vaut FALSE, piggyback est désactivé. Par défaut, piggyback est activé. Activer piggyback est plus efficace, et généralement, cela économise des aller-retours sur le réseau pour les premières lectures de résultat. Mais peu de serveurs Z39.50 supportent piggyback, ou bien ils ignorent ce jeu de noms. Pour ceux là, il faut que piggyback soit désactivé.

charset

Une chaîne qui spécifie un jeu de caractères à utiliser pour les négotations de langues et jeux de caractères Z39.50. Utilisez des chaînes comme : ISO-8859-1, UTF-8, UTF-16.

La plupart des cibles Z39.50 ne supportent pas cette fonctionnalité (et elle est donc ignorée). Plusieurs cibles utilisent l'encodage ISO-8859-1 pour les requêtes et les messages. Les enregistrements MARC21/USMARC ne sont pas affectés par cette configuration.

Note : L'utilisation d'un proxy améliore souvent les performances. Un proxy Z39.50 fait partie du package libre YAZ++.