HTTunnel : : L'usager est un cours d'usager pour Apache : : HTTunnel.

SYNTHÈSE

mon $hc = HTTunnel neuf : : Usager (« http://localhost/httunnel ") ;
$hc->connect (tcp, $some_host, $some_port) ;

$hc->print (certains demande) ;
mon $some_response = $hc->read (1024) ;

$ch->close () ;

HTTunnel : : L'usager est le cours d'usager à Apache : : HTTunnel. Il permet la création d'une connexion au réseau percée un tunnel par le HTTP. Toutes les caractéristiques envoyées et reçues pendant cette connexion seront transportées à l'intérieur des demandes de HTTP normales.

HTTunnel : : L'usager étend LWP : : UserAgent, tellement tout le LWP : : Les méthodes d'UserAgent sont procurables par HTTunnel : : Usager.

CONSTRUCTEURS

neuf (URL, [ARGS])

Produit un HTTunnel : : Objectif d'usager qui emploiera l'URL pour entrer en contact avec Apache : : Serveur de HTTunnel. ARGS sont sont réussis directement au LWP : : Constructeur d'UserAgent.

MÉTHODES

brancher (PROTO, SERVEUR, PORT, [MINUTERIE])

Demande Apache : : Serveur de HTTunnel pour établir une connexion de protocole PROTO au SERVEUR : PORT. Une exception est projetée si une erreur se produit.

Les valeurs reçues pour PROTO sont les tcp et l'UDP.

impression (CARACTÉRISTIQUES)

Demande Apache : : Serveur de HTTunnel pour sauver des CARACTÉRISTIQUES à la connexion distante établie. Une exception est projetée si une erreur se produit.
Les CARACTÉRISTIQUES peuvent être une grandeur scalaire ou une liste, dans ce cas les organes de liste sont enchaînés ensemble.

affiché (LEN, [MINUTERIE], [LIGNE DE SAUVETAGE], [LIFELINE_CUT_ACTION])

Demande Apache : : Serveur de HTTunnel à afficher jusqu'aux octets de LEN de la connexion distante établie. Une exception est projetée si une erreur se produit.

En essayant de s'afficher, HTTunnel : : L'usager établira une connexion de HTTP à Apache : : Serveur de HTTunnel demandant que des octets de LEN soient affichés. Si aucune caractéristique n'est procurable après des secondes de MINUTERIE (la valeur par défaut est de 15 secondes), la connexion de HTTP est fermée par le serveur et la méthode affichée établira un neuf. Ceci continuera jusqu'à quelques caractéristiques ou l'EOF est retourné.

Par conséquent affiché retournera seulement quand (ou de plus) de la caractéristique est procurable pour être affichée (comme le militaire de carrière affiché).

La LIGNE DE SAUVETAGE peut être n'importe quel filehandle admissible de lesquels peut s'afficher. Si utilisé, affiché interrompra sa boucle de connexion et accomplira LIFELINE_CUT_ACTION quand la caractéristique (ou l'EOF) est procurable pour être affiché de la LIGNE DE SAUVETAGE. Elle renverra alors l'undef.
Le wust de LIFELINE_CUT_ACTION soit un CODE réf. La valeur par défaut est

sous-marin {mourir (le « cutn de ligne de sauvetage »)}

Ces caractéristiques peuvent être employées si vous voulez la fourche et pour commencer un procédé qui ne fait rien mais affiche et renvoie les caractéristiques par l'intermédiaire d'une pipe. Vous pouvez alors utiliser une deuxième pipe pour s'assurer que le procédé de lecteur met fin quand le procédé principal met fin.

Voici un exemple :

mon $lifeline = E/S neuf : : Pipe () ;
mon $reader = E/S neuf : : Pipe () ;
mon $pid = fourche () ;
si ($pid) {
$reader->reader () ;
$lifeline->writer () ;

# afficher les caractéristiques de $reader…
}
autrement {
$reader->writer () ;
$reader->autoflush (1) ;
$lifeline->reader () ;

tandis que (1) {
mon $data = $hc->read (1024, 15, $lifeline, sous-marin {sortie ()}) ;
quitter () à moins que défini ($data) ;
estamper $reader $data ;
}
}
se fermer ()

Demande Apache : : Serveur de HTTunnel pour fermer une connexion précédemment établie.
get_peer_info ()

La méthode de get_peer_info renvoie des informations sur la connexion distante. Une chaîne de caractères contenant l'IP address et le numéro de port, séparés par un côlon (:) est retourné. Cette méthode peut être utile avec des connexions d'UDP pour valider l'émetteur de chaque paquet.

request_callback (DEMANDE)

La méthode de request_callback est une méthode de rappel de service qui peut être employée pour accéder le HTTP : : Objectif de demande juste avant qu'il soit envoyé. L'application de défaut ne fait rien.

response_callback (RÉACTION)

La méthode de response_callback est une méthode de rappel de service qui peut être employée pour accéder le HTTP : : Objectif de réaction juste après qu'il soit reçu. L'application de défaut ne fait rien.