7.112 YAZ
7 Index des fonctions
Manuel PHP
. Introduction . Installation . Configuration à l'exécution . Types de ressources . Constantes prédefinies . Exemples . yaz_addinfo . yaz_ccl_conf . yaz_ccl_parse . yaz_close ->yaz_connect . yaz_database . yaz_element . yaz_errno . yaz_error . 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
|
7.112.11 yaz_connect()
Prépare une connexion à un hôte YAZ
[ Exemples avec yaz_connect ] PHP 4 >= 4.0.1
resource
yaz_connect (
string
zurl
,
mixed
options
)
yaz_connect
retourne un identifiant positif en cas
de succès, et
FALSE
sinon.
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é.
Note |
L'utilisation d'un proxy améliore souvent les performances. Un
proxy Z39.50 fait partie du package libre
YAZ++ .
|
|