8.145 YAZ
8 Référence des fonctions
Manuel PHP
. Introduction . Installation . Configuration à l'exécution . Types de ressources . Constantes pré-définies . Exemples . yaz_addinfo . yaz_ccl_conf . yaz_ccl_parse . yaz_close ->yaz_connect . yaz_database . yaz_element . yaz_errno . yaz_error . yaz_es_result . yaz_get_option . yaz_hits . yaz_itemorder . yaz_present . yaz_range . yaz_record . yaz_scan_result . yaz_scan . yaz_schema . yaz_search . yaz_set_option . yaz_sort . yaz_syntax . yaz_wait
|
8.145.11 yaz_connect()Prépare une connexion à un serveur Z39.50[ Exemples avec yaz_connect ] PHP 4 >= 4.0.1, PECL
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.
|
-
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 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 options (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 octet 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 octet 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.
|
Une ressource de connexion en cas de réussite,
FALSE
en cas d'erreur.
| Version |
Description |
| 4.1.0 |
Le paramètre
options
a été ajouté.
|
|