curl-getinfo.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8b3f89ed6171cb711b00afb0fcacbea3462537b9 Maintainer: jaenecke Status: ready -->
<!-- Reviewed: yes -->
<!-- Rev-Revision: f9c4a68ef4f89e51e6d9b905ad3ddb6492386dd3 Reviewer: samesch -->
<refentry xml:id="function.curl-getinfo" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>curl_getinfo</refname>
  <refpurpose>Ruft Informationen zu einem bestimmten Transfer ab</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>mixed</type><methodname>curl_getinfo</methodname>
   <methodparam><type>CurlHandle</type><parameter>handle</parameter></methodparam>
   <methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>option</parameter><initializer>&null;</initializer></methodparam>
  </methodsynopsis>
  <para>
   Gibt Informationen über den letzen Transfer zurück.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    &curl.ch.description;
    <varlistentry>
     <term><parameter>option</parameter></term>
     <listitem>
      <para>
       Dies kann eine der folgenden Konstanten sein:
       <informaltable>
        <tgroup cols="2">
         <thead>
          <row>
           <entry valign="top">Option</entry>
           <entry valign="top">&Description;</entry>
          </row>
         </thead>
         <tbody>
          <row>
           <entry><constant>CURLINFO_CAINFO</constant></entry>
           <entry>
            Der standardmäßige interne Pfad zur CA-Zertifikatsdatei
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_CAPATH</constant></entry>
           <entry>
            Der standardmäßige interne Pfad zum CA-Verzeichnis
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_EFFECTIVE_URL</constant></entry>
           <entry>
            Die letzte erfolgreiche URL
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_HTTP_CODE</constant></entry>
           <entry>
            Der letzte Antwortcode. Von cURL 7.10.8 an ist dies ein veralteter
            Alias von CURLINFO_RESPONSE_CODE
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_FILETIME</constant></entry>
           <entry>
            Die (Server-) Zeit der letzten Änderung des abgerufenen Dokuments,
            wenn die Option CURLOPT_FILETIME aktiviert ist; wenn -1
            zurückgegeben wird, ist die Zeit unbekannt
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_TOTAL_TIME</constant></entry>
           <entry>
            Die Gesamtdauer des letzten Transfers in Sekunden
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_NAMELOOKUP_TIME</constant></entry>
           <entry>
            Die Zeit in Sekunden, bis die Auflösung des Hostnamens
            abgeschlossen war.
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_CONNECT_TIME</constant></entry>
           <entry>
            Die Dauer des Verbindungsaufbaus in Sekunden
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_PRETRANSFER_TIME</constant></entry>
           <entry>
            Die Zeit in Sekunden zwischen dem Start und dem eigentlichen
            Beginn des Empfangs
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_STARTTRANSFER_TIME</constant></entry>
           <entry>
            Die Zeit in Sekunden bis zur Übertragung des ersten Bytes
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_REDIRECT_COUNT</constant></entry>
           <entry>
            Die Anzahl der Weiterleitungen, wenn die Option
            CURLOPT_FOLLOWLOCATION aktiviert ist
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_REDIRECT_TIME</constant></entry>
           <entry>
            Die Zeit in Sekunden, die von allen Weiterleitungsschritten
            beansprucht wird, bevor der eigentliche Transfer beginnt, wenn die
            Option CURLOPT_FOLLOWLOCATION aktiviert ist
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_REDIRECT_URL</constant></entry>
           <entry>
            Bei deaktivierter CURLOPT_FOLLOWLOCATION-Option: die
            Weiterleitungs-URL, die in der letzten Transaktion gefunden wurde
            und als nächstes manuell angefordert werden sollte. Bei
            aktivierter CURLOPT_FOLLOWLOCATION-Option ist dies immer leer. Die
            Weiterleitungs-URL ist in diesem Fall in CURLINFO_EFFECTIVE_URL
            verfügbar
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_PRIMARY_IP</constant></entry>
           <entry>
            Die IP-Adresse der jüngsten Verbindung
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_PRIMARY_PORT</constant></entry>
           <entry>
            Der Ziel-Port der jüngsten Verbindung
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_LOCAL_IP</constant></entry>
           <entry>
            Die lokale (Quell-) IP-Adresse der jüngsten Verbindung
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_LOCAL_PORT</constant></entry>
           <entry>
            Der lokale (Quell-) Port der jüngsten Verbindung
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_SIZE_UPLOAD</constant></entry>
           <entry>
            Die Anzahl der gesendeten Bytes
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_SIZE_DOWNLOAD</constant></entry>
           <entry>
            Die Anzahl der empfangenen Bytes
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_SPEED_DOWNLOAD</constant></entry>
           <entry>
            Die durchschnittliche Download-Geschwindigkeit
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_SPEED_UPLOAD</constant></entry>
           <entry>
            Die durchschnittliche Upload-Geschwindigkeit
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_HEADER_SIZE</constant></entry>
           <entry>
            Die Gesamtgröße aller empfangenen Header
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_HEADER_OUT</constant></entry>
           <entry>
            Die gesendete Anfrage. Damit dies funktioniert, muss die Option
            CURLINFO_HEADER_OUT durch Aufruf von curl_setopt() zum Handle
            hinzugefügt werden
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_REFERER</constant></entry>
           <entry>
            Der Referrer-Header
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_REQUEST_SIZE</constant></entry>
           <entry>
            Die Gesamtgröße aller Anfragen; momentan nur für HTTP verfügbar
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_RETRY_AFTER</constant></entry>
           <entry>
            Die Information aus dem Retry-After:-Header oder Null, wenn es
            keinen gültigen Header gibt.
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_SSL_VERIFYRESULT</constant></entry>
           <entry>
            Das Ergebnis der Überprüfung des SSL-Zertifikats, angefordert
            durch das Setzen von CURLOPT_SSL_VERIFYPEER
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_CONTENT_LENGTH_DOWNLOAD</constant></entry>
           <entry>
            Die Größe des Downloads, ermittelt aus dem Content-Length:-Header
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_CONTENT_LENGTH_UPLOAD</constant></entry>
           <entry>
            Die festgesetzte Größe des Uploads
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_CONTENT_TYPE</constant></entry>
           <entry>
            Der Content-Type: des angeforderten Dokuments. NULL zeigt an, dass
            der Server keinen gültigen Content-Type:-Header gesendet hat
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_PRIVATE</constant></entry>
           <entry>
            Private Daten, die zu diesem cURL-Handle gehören und zuvor mit der
            Option CURLOPT_PRIVATE der Funktion curl_setopt() gesetzt wurden
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_PROXY_ERROR</constant></entry>
           <entry>
            Der detaillierte (SOCKS) Proxy-Fehlercode, wenn bei der letzten
            Übertragung ein CURLE_PROXY-Fehler aufgetreten ist. Der
            zurückgegebene Wert ist genau einer der CURLPX_*-Werte. Wenn kein
            Antwortcode verfügbar ist, lautet der Fehlercode CURLPX_OK.
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_RESPONSE_CODE</constant></entry>
           <entry>
            Der letzte Antwortcode
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_HTTP_CONNECTCODE</constant></entry>
           <entry>
            Der CONNECT-Antwortcode
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_HTTPAUTH_AVAIL</constant></entry>
           <entry>
            Eine Bitmaske, die die verfügbaren Authentifizierungsmethode(n)
            gemäß der vorherigen Antwort anzeigt
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_PROXYAUTH_AVAIL</constant></entry>
           <entry>
            Eine Bitmaske, die die verfügbaren Proxy-Authentifikationsmethode(n)
            gemäß der vorherigen Antwort anzeigt
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_OS_ERRNO</constant></entry>
           <entry>
            Die Fehlernummer (Errno) eines Verbindungsfehlers. Die Zahl ist
            OS- und  systemabhängig.
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_NUM_CONNECTS</constant></entry>
           <entry>
            Die Anzahl der Verbindungen, die cURL erzeugen musste, um die
            vorherige Übertragung durchzuführen
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_SSL_ENGINES</constant></entry>
           <entry>
            Die unterstützten OpenSSL-Crypto-Engines
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_COOKIELIST</constant></entry>
           <entry>
            Alle bekannten Cookies
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_FTP_ENTRY_PATH</constant></entry>
           <entry>
            Der Entry-Pfad des FTP-Servers
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_APPCONNECT_TIME</constant></entry>
           <entry>
            Die Zeitdauer in Sekunden, die bis zum
            SSL/SSH-Verbindungsaufbau/Handshake zum entfernten Server
            verstrichen ist
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_CERTINFO</constant></entry>
           <entry>
            Die TLS-Zertifikatskette
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_CONDITION_UNMET</constant></entry>
           <entry>
            Die Info über eine nicht eingehaltene Zeitbedingung
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_RTSP_CLIENT_CSEQ</constant></entry>
           <entry>
            Die nächste CSeq des RTSP-Clients
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_RTSP_CSEQ_RECV</constant></entry>
           <entry>
            Die zuletzt empfangene CSeq
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_RTSP_SERVER_CSEQ</constant></entry>
           <entry>
            Die nächste CSeq des RTSP-Servers
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_RTSP_SESSION_ID</constant></entry>
           <entry>
            Die RTSP-Session-ID
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_CONTENT_LENGTH_DOWNLOAD_T</constant></entry>
           <entry>
            Die inhaltliche Länge des Downloads. Das ist der Wert, der aus dem
            Content-Length:-Feld gelesen wurde. -1, wenn die Größe nicht
            bekannt ist
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_CONTENT_LENGTH_UPLOAD_T</constant></entry>
           <entry>
            Die angegebene Größe des Uploads. -1, wenn die Größe nicht bekannt
            ist
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_HTTP_VERSION</constant></entry>
           <entry>
            Die Version, die in der letzten HTTP-Verbindung verwendet wurde.
            Der Rückgabewert ist eine der definierten
            CURL_HTTP_VERSION_*-Konstanten oder 0, wenn die Version nicht
            ermittelt werden kann
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_PROTOCOL</constant></entry>
           <entry>
            Das Protokoll, das in der letzten HTTP-Verbindung verwendet wurde.
            Der Rückgabewert ist genau einer der CURLPROTO_*-Werte
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_PROXY_SSL_VERIFYRESULT</constant></entry>
           <entry>
            Das Ergebnis der Zertifikatsprüfung, die angefordert wurde (durch
            Verwendung der Option CURLOPT_PROXY_SSL_VERIFYPEER). Wird nur für
            HTTPS-Proxies verwendet
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_SCHEME</constant></entry>
           <entry>
            Das URL-Schema, das für die jüngste Verbindung verwendet wurde
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_SIZE_DOWNLOAD_T</constant></entry>
           <entry>
            Die Gesamtanzahl von Bytes, die heruntergeladen wurden. Die Anzahl
            betrifft nur die letzte Übertragung, und wird für jede neue
            Übertragung zurückgesetzt
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_SIZE_UPLOAD_T</constant></entry>
           <entry>
            Die Gesamtanzahl von Bytes, die hochgeladen wurden
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_SPEED_DOWNLOAD_T</constant></entry>
           <entry>
            Die durchschnittliche Download-Geschwindigkeit in Bytes pro
            Sekunde, die CURL für den vollständigen Download gemessen hat
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_SPEED_UPLOAD_T</constant></entry>
           <entry>
            Die durchschnittliche Upload-Geschwindigkeit in Bytes pro Sekunde,
            die CURL für den vollständigen Upload gemessen hat
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_APPCONNECT_TIME_T</constant></entry>
           <entry>
            Die Zeit in Mikrosekunden, die vom Beginn bis zur Vollendung der
            SSL/SSH-Verbindung/des Handshakes zum Remote-Host vergangen ist
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_CONNECT_TIME_T</constant></entry>
           <entry>
            Die Gesamtdauer in Mikrosekunden, vom Beginn bis zur Vollendung
            der Verbindung zum Remote-Host (oder Proxy)
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_FILETIME_T</constant></entry>
           <entry>
            Die letzte Änderung des abgerufenen Dokuments (als
            Unix-Zeitstempel); eine Alternative zu CURLINFO_FILETIME, die es
            Systemen mit 32-Bit-Ganzzahlvariablen ermöglicht, Daten außerhalb
            des 32-Bit-Zeitstempelbereichs zu extrahieren
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_NAMELOOKUP_TIME_T</constant></entry>
           <entry>
            Die Dauer in Mikrosekunden vom Beginn bis zur Vervollständigung
            der Namensauflösung
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_PRETRANSFER_TIME_T</constant></entry>
           <entry>
            Die benötigte Zeit vom Beginn bis zum eigentlichen Beginn der
            Dateiübertragung in Mikrosekunden
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_REDIRECT_TIME_T</constant></entry>
           <entry>
            Die Gesamtdauer in Mikrosekunden für alle Weiterleitungsschritte
            einschließlich Namenslookup, Verbindung, Vorübertragung und
            Übertragung, bis zum Beginn der eigentlichen Transaktion
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_STARTTRANSFER_TIME_T</constant></entry>
           <entry>
            Die benötigte Zeit in Mikrosekunden vom Beginn bis zum Empfang des
            ersten Bytes
           </entry>
          </row>
          <row>
           <entry><constant>CURLINFO_TOTAL_TIME_T</constant></entry>
           <entry>
            Die Gesamtdauer in Mikrosekunden für die vorhergehende Übertragung
            einschließlich Namensauflösung, TCP-Verbindung usw.
           </entry>
          </row>
         </tbody>
        </tgroup>
       </informaltable>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Wird der Parameter <parameter>option</parameter> angegeben, wird der
   entsprechende Wert zurückgegeben. Andernfalls liefert die Funktion ein
   assoziatives Array mit den folgenden Elementen zurück (analog zum Parameter
   <parameter>option</parameter>), oder &false; im Fehlerfall:
   <itemizedlist>
    <listitem>
     <simpara>
      "url"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "content_type"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "http_code"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "header_size"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "request_size"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "filetime"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "ssl_verify_result"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "redirect_count"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "total_time"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "namelookup_time"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "connect_time"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "pretransfer_time"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "size_upload"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "size_download"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "speed_download"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "speed_upload"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "download_content_length"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "upload_content_length"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "starttransfer_time"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "redirect_time"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "certinfo"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "primary_ip"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "primary_port"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "local_ip"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "local_port"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "redirect_url"
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      "request_header" (Dies ist nur gesetzt, wenn die Option
      <constant>CURLINFO_HEADER_OUT</constant> durch einen vorherigen Aufruf
      von <function>curl_setopt</function> gesetzt wurde)
     </simpara>
    </listitem>
   </itemizedlist>
   Es ist zu beachten, dass private Daten nicht im assoziativen Array
   enthalten sind, sondern individuell mit der Option
   <constant>CURLINFO_PRIVATE</constant> abgerufen werden müssen.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>8.3.0</entry>
       <entry>
        <constant>CURLINFO_CAINFO</constant>
        und <constant>CURLINFO_CAPATH</constant> eingeführt.
       </entry>
      </row>
      <row>
       <entry>8.2.0</entry>
       <entry>
        <constant>CURLINFO_PROXY_ERROR</constant>,
        <constant>CURLINFO_REFERER</constant>,
        <constant>CURLINFO_RETRY_AFTER</constant> eingeführt.
       </entry>
      </row>
      &curl.changelog.handle-param;
      <row>
       <entry>8.0.0</entry>
       <entry>
        <parameter>option</parameter> ist jetzt nullable (akzeptiert den
        &null;-Wert); vorher war der Vorgabewert <literal>0</literal>.
       </entry>
      </row>
      <row>
       <entry>7.3.0</entry>
       <entry>
        <constant>CURLINFO_CONTENT_LENGTH_DOWNLOAD_T</constant>,
        <constant>CURLINFO_CONTENT_LENGTH_UPLOAD_T</constant>,
        <constant>CURLINFO_HTTP_VERSION</constant>,
        <constant>CURLINFO_PROTOCOL</constant>,
        <constant>CURLINFO_PROXY_SSL_VERIFYRESULT</constant>,
        <constant>CURLINFO_SCHEME</constant>,
        <constant>CURLINFO_SIZE_DOWNLOAD_T</constant>,
        <constant>CURLINFO_SIZE_UPLOAD_T</constant>,
        <constant>CURLINFO_SPEED_DOWNLOAD_T</constant>,
        <constant>CURLINFO_SPEED_UPLOAD_T</constant>,
        <constant>CURLINFO_APPCONNECT_TIME_T</constant>,
        <constant>CURLINFO_CONNECT_TIME_T</constant>,
        <constant>CURLINFO_FILETIME_T</constant>,
        <constant>CURLINFO_NAMELOOKUP_TIME_T</constant>,
        <constant>CURLINFO_PRETRANSFER_TIME_T</constant>,
        <constant>CURLINFO_REDIRECT_TIME_T</constant>,
        <constant>CURLINFO_STARTTRANSFER_TIME_T</constant>,
        <constant>CURLINFO_TOTAL_TIME_T</constant> eingeführt.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title><function>curl_getinfo</function>-Beispiel</title>
    <programlisting role="php">
<![CDATA[
<?php
// Eine cURL-Ressource erstellen
$ch = curl_init('http://www.example.com/');

// ausführen
curl_exec($ch);

// prüfen, ob ein Fehler aufgetreten ist
if (!curl_errno($ch)) {
  $info = curl_getinfo($ch);
  echo 'Es wurden ', $info['total_time'], ' Sekunden benötigt für eine Anfrage an ', $info['url'], "\n";
}

// Ressource schliessen
curl_close($ch);
?>
]]>
    </programlisting>
   </example>
  </para>
  <para>
   <example>
    <title><function>curl_getinfo</function>-Beispiel mit dem Parameter <parameter>option</parameter></title>
    <programlisting role="php">
<![CDATA[
<?php
// Eine cURL-Ressource erstellen
$ch = curl_init('http://www.example.com/');

// ausführen
curl_exec($ch);

// HTTP-Status-Code prüfen
if (!curl_errno($ch)) {
  switch ($http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE)) {
    case 200:  # OK
      break;
    default:
      echo 'Unerwarteter HTTP-Code: ', $http_code, "\n";
  }
}

// Ressource schliessen
curl_close($ch);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <note>
   <para>
    Informationen, die mit dieser Funktion gesammelt wurden, bleiben erhalten,
    wenn das Handle wiederverwendet wird. Das bedeutet, dass außer wenn eine
    Statistik intern von dieser Funktion überschrieben wird, die vorherige Info
    zurückgegeben wird.
   </para>
  </note>
 </refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->