. . . . . . . . . . . . . . . . . . . . . . . . . |
|
|
yaz_connect
yaz_connect (PHP 4 >= 4.0.1, PECL) yaz_connect -- Prépare une connexion à un serveur Z39.50 Descriptionmixed 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.
Retour au chapitre Php
|
|