Manuel PHP
Précédent |  | Suivant

# yaz_connect

(PHP 4 >= 4.0.1, PECL)

yaz_connect -- Prépare une connexion à un serveur Z39.50

## Description

mixed yaz_connect ( string zurl [, mixed options] )

Cette fonction retourne une ressource de connexion en cas de succès et 0 en cas d'échec.

yaz_connect() prépare une connexion à un serveur Z39.50. Cette fonction n'est pas bloquante, et ne tente pas d'établir une connexion. En fait, elle ne fait que préparer la connexion pour exécution ultérieure par yaz_wait().

> Note : Le proxy YAZ est un proxy Z39.50 librement disponible.

## Liste de paramètres

zurl

  Une chaîne de caractères qui prend la forme host[:port][/database]. Si le port est omis, le port 210 est utilisé. Si la base de données est omise, Default est utilisée.

options

  Si donné comme une chaîne de caractères, cela sera traité comme la chaîne d'authentification Z39.50 V2 (OpenAuth).

  Si donné comme un tableau, le contenu du tableau sert en tant qu'options.

  user

    Utilisateur pour authentification.

  group

    Groupe pour authentification.

  password

    Mot de passe pour authentification.

  cookie

    Cookie pour session (proxy YAZ).

  proxy

    Proxy pour connexion (proxy YAZ).

  persistent

    Un booléen. Si `TRUE` la connexion est persistante; Si `FALSE` la connexion n'est pas persistante. Par défaut les connexions sont persistantes.

    > Note : Si vous ouvrez une connexion persistante, vous ne serez pas capable de la fermer plus tard avec yaz_close().

  piggyback

    Un booléen. Si `TRUE` piggyback est activé pour les recherches. Si `FALSE` piggyback est désactivé. Par défaut piggyback est activé.

    L'activation de piggyback est plus efficace : il sauvegarde habituellement les allers-retours du réseau pour les premières lectures de résultats. Cependant, quelque serveurs Z39.50 ne supportent pas piggyback ou ils ignorent ce jeu de noms. Pour ceux-ci, piggyback devrait être désactivé.

  charset

    Une chaîne de caractères qui spécifie le jeu de caractères qui sera utilisé dans le langage Z39.50 et le jeu de caractères pour les négociations. Utilisez une chaîne de caractères comme : ISO-8859-1, UTF-8, UTF-16.

    La plupart des serveurs Z39.50 ne supportent pas cette option (et, pour ceux-ci, cet argument est ignoré). Plusieurs serveurs 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.

  preferredMessageSize

    Un entier qui spécifie la taille maximale en octets pour toutes les entrées qui seront retournées par la cible durant la récupération. Voyez le standard Z39.50 pour plus d'informations.

    > Note : Cette option est supportée dans PECL YAZ 1.0.5 ou supérieure.

  maximumRecordSize

    Un entier qui spécifie la taille maximale en octets pour une seule entrée qui sera retournée par la cible durant la récupération. Cette entité est référée à Exceptional-record-size dans le standard Z39.50.

    > Note : Cette option est supportée dans PECL YAZ 1.0.5 ou supérieure.

## Valeurs de retour

Une ressource de connexion en cas de réussite, `FALSE` en cas d'erreur.

## Historique

Version | Description
--- | ---
4.1.0 | Le paramètre options a été ajouté.

## Voir aussi

yaz_close()

Précédent | Sommaire | Suivant
yaz_close | Niveau supérieur | yaz_database