HTTunnel:: Klient ist eine Klientenkategorie für Apache:: HTTunnel.

SYNOPSE

mein $hc = neues HTTunnel:: Klient („http://localhost/httunnel ");
$hc->connect (TCP, $some_host, $some_port);

$hc->print (einige Antrag);
mein $some_response = $hc->read (1024);

$ch->close ();

HTTunnel:: Klient ist die Klientenkategorie zu Apache:: HTTunnel. Es erlaubt die Kreation einer Network Connection, die durch HTTP einen Tunnel angelegt wird. Alle Daten, die während dieses Anschlußes gesendet werden und empfangen sind, werden innerhalb der normalen HTTP-Anträge transportiert.

HTTunnel:: Klient dehnt LWP: aus: UserAgent, so alles LWP:: UserAgent Methoden sind durch HTTunnel: erhältlich: Klient.

ERBAUER

neu (URL, [ARGS])

Erstellt ein HTTunnel:: Klientennachricht, die URL verwendet, um den Apache in Kontakt zu bringen:: HTTunnel Server. ARGS sind wird passiert direkt zum LWP:: UserAgent Erbauer.

METHODEN

anschließen (PROTO, HOST, ÖFFNUNG, [UNTERBRECHUNG])

Bittet um um den Apache:: HTTunnel Server, zum eines Anschlußes des Protokolls PROTO zum HOST festzulegen: ÖFFNUNG. Eine Ausnahme wird geworfen, wenn ein Fehler auftritt.

Geltende Werte für PROTO sind TCP und UDP.

Druck (DATEN)

Bittet um um den Apache:: HTTunnel Server, zum von DATEN zum festgelegten Fernanschluß zu schreiben. Eine Ausnahme wird geworfen, wenn ein Fehler auftritt.
DATEN können ein Scalar oder eine Liste sein, in diesem Fall die Listenpunkte zusammen verkettet werden.

gelesen (LEN, [UNTERBRECHUNG], [LEBENSADER], [LIFELINE_CUT_ACTION])

Bittet um um den Apache:: HTTunnel Server, zum bis zu den LEN Bytes vom festgelegten Fernanschluß zu lesen. Eine Ausnahme wird geworfen, wenn ein Fehler auftritt.

Beim Versuchen zu lesen, HTTunnel:: Klient legt einen HTTP-Anschluß zum Apache: fest: HTTunnel Server, der fragt, dass LEN Bytes gelesen werden. Wenn keine Daten nach TIMEOUTsekunden (der Standardwert ist- 15 Sekunden), erhältlich sind, wird der HTTP-Anschluß durch den Server geschlossen und die gelesene Methode legt ein Neues fest. Dieses geht bis etwas Daten weiter, oder EOF wird zurückgebracht.

Folglich gelesen geht zurück, nur wenn etwas (oder no more) Daten erhältlich sind gelesen zu werden (wie der Regular gelesen worden).

LEBENSADER kann jedes gültige filehandle von sein, kann welches lesen. Wenn Sie verwendet werden, gelesen, unterbricht seinen Anschlußregelkreis und führt LIFELINE_CUT_ACTION durch, wenn Daten (oder EOF) erhältlich ist, von der LEBENSADER gelesen zu werden. Sie bringt dann undef zurück.
LIFELINE_CUT_ACTION wust ist eine CODE-Referenz. Der Standardwert ist

Unterseeboot {sterben („Lebensader cutn“)}

Diese Funktionen können verwendet werden, wenn Sie Gabel und einen Prozeß zu beginnen wünschen, der tut, nichts aber die Daten über ein Rohr liest und zurückbringt. Sie können ein zweites Rohr dann verwenden, um sicherzustellen, daß der Leserprozeß abbricht, wenn der Vorlagenprozeß abbricht.

Ist hier ein Beispiel:

mein $lifeline = neuer IO:: Rohr ();
mein $reader = neuer IO:: Rohr ();
mein $pid = Gabel ();
wenn ($pid) {
$reader->reader ();
$lifeline->writer ();

# Daten von $reader lesen…
}
sonst {
$reader->writer ();
$reader->autoflush (1);
$lifeline->reader ();

während (1) {
mein $data = $hc->read (1024, 15, $lifeline, Unterseeboot {Ausgang ()});
beenden () es sei denn definiert ($data);
$reader $data drucken;
}
}
schließen ()

Bittet um um den Apache:: HTTunnel Server, zum eines vorher festgelegten Anschlußes zu schließen.
get_peer_info ()

Die get_peer_info Methode bringt Informationen über den Fernanschluß zurück. Eine Zeichenkette, die das IP address und die Anschlußnummer, getrennt durch einen Doppelpunkt enthält (:) wird zurückgegangen. Diese Methode kann mit UDP-Anschlüssen nützlich sein, den Absender jedes Pakets zu validieren.

request_callback (ANTRAG)

Die request_callback Methode ist ein Rückrufverfahren, das angewendet werden kann, um auf das HTTP zurückzugreifen:: Antragnachricht, kurz bevor sie gesendet wird. Die Zahlungseinstellungumsetzung tut nichts.

response_callback (ANTWORT)

Die response_callback Methode ist ein Rückrufverfahren, das angewendet werden kann, um auf das HTTP zurückzugreifen:: Wartenachricht, gleich nachdem sie empfangen wird. Die Zahlungseinstellungumsetzung tut nichts.