|
8.45.48 hw_GetText()Retourne un document texte[ Exemples avec hw_gettext ] PHP 3 >= 3.0.3, PHP 4, PECL
int
hw_gettext (
int
connection
,
int
objectID
,
mixed
rootID/prefix
)
hw_gettext
retourne le document de l'objet
objectID
. Si le document possède des ancrages
qui peuvent être insérés, ils le seront déjà.
L'option rootID/prefix peut être une
chaîne ou un entier. Si c'est un entier, il détermine la
méthode d'insertion des liens dans le document. Par défaut,
il vaut 0 et les liens seront construits en fonction du nom de l'objet cible.
Cela sert beaucoup dans les applications web. Si un lien pointe sur un objet
avec le nom 'film_internet' le lien HTML sera <A HREF="/film_internet">.
La position réelle de la source et de la cible dans la hiérarchie
seront ignorés. Vous devrez modificer votre site web pour qu'il
réécrive les URL, comme
'/mon_script.php3/film_internet'. 'mon_script.php3' devra analyser
$PATH_INFO et savoir rechercher le document '/mon_script.php3/film_internet'.
Si vous ne voulez pas de ce comportement, vous pouvez affecter à
rootID/prefix n'importe quel prefixe. Dans ce cas, ce sera une chaîne.
Si
rootID/prefix
est un entier différent de 0
le lien sera construit avec tous les noms de la hiérarchie, en
commençant à l'objet d'identifiant
rootID/prefix
, et séparé
par des slash. Si, par exemple, le document 'film_internet' est situé
à 'a-b-c-film_internet' et '-' qui sert de séparateur
hiérarchique de niveau sur le serveur Hyperwave et le document
source est situé dans 'a-b-d-source' alors, le lien HTML sera :
<A HREF="../c/film_internet">. Cela est très pratique si vous
voulez télécharger tout le contenu d'un serveur sur un disque,
et faire une carte du système sur votre disque.
hw_gettext
n'est opérationnelle qu'avec des
documents de pur texte. Elle n'ouvrira pas de canal spécial de
transfert et, ainsi, bloquera le script le temps du transfert.
Voir aussi
hw_pipedocument
,
hw_free_document
,
hw_document_bodytag
,
hw_document_size
et
hw_output_document
.
|
