cvs: phpdoc-de /reference/imap/functions imap-open.xml

From: Date: Wed, 28 Feb 2007 13:00:14 +0000
Subject: cvs: phpdoc-de /reference/imap/functions imap-open.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-2045@lists.php.net to get a copy of this message
hholzgra Wed Feb 28 13:00:14 2007 UTC Modified files: /phpdoc-de/reference/imap/functions imap-open.xml Log: translation update

http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/imap/functions/imap-open.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc-de/reference/imap/functions/imap-open.xml diff -u phpdoc-de/reference/imap/functions/imap-open.xml:1.5 phpdoc-de/reference/imap/functions/imap-open.xml:1.6 --- phpdoc-de/reference/imap/functions/imap-open.xml:1.5 Mon Jan 29 21:47:10 2007 +++ phpdoc-de/reference/imap/functions/imap-open.xml Wed Feb 28 13:00:14 2007 @@ -1,135 +1,343 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.1 Maintainer: hholzgra Status: working --> -<!-- splitted from ./de/functions/imap.xml, last change in rev 1.2 --> -<!-- last change to 'imap-open' in en/ tree in rev 1.2 --> - <refentry id="function.imap-open"> - <refnamediv> - <refname>imap_open</refname> - <refpurpose> - Öffnet eine Verbindung zu einem Postfach auf einem POP-, IMAP- - oder NNTP-Server - </refpurpose> - </refnamediv> - <refsect1 role="description"> - &reftitle.description; - <methodsynopsis> - <type>int</type><methodname>imap_open</methodname> - <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> - <methodparam><type>string</type><parameter>username</parameter></methodparam> - <methodparam><type>string</type><parameter>password</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam> - </methodsynopsis> - <para> - Diese Funktion liefert ein Verbindungs-Handle bzw. &false; bei - evtl. auftretenden Fehlern. Verbindungen können nicht nur zu - IMAP-, sondern auch zu POP- oder NNTP-Servern aufgebaut werden, - wobei dann allerdings nicht der gesamte Funktionsumfang zur - Verfügung steht. Liefert ein IMAP-Streamhandle oder &false; bei - Fehlern. - </para> - <para> - Der Name eines Postfachs setzt sich zusammen aus der Bezeichnung - des Servers und dem Pfad des Postfachs auf diesem Server. Der - spezielle Name INBOX steht dabei als Synonym für das persönliche - Postfach des jeweiligen Benutzers. Die Bezeichnung des Servers - setzt sich zusammen aus dem eigentlichen Servernamen oder der - entsprechenden IP-Adresse sowie das gewünschte Protokoll - (getrennt durch '/') und optional der zu benutzende Port - (getrennt durch ':'). Die gesamte Serverbezeichnung wird in '{' - und '}' eingeschlossen und muss immer mit angegeben - werden. Enthält der Name eines Postfachs Zeichen außerhalb des - druckbaren ASCII-Bereiches wie z.B. Umlaute oder das 'ß', so muss - er mit Hilfe der Funktion <function>imap_utf7_encode</function> - codiert werden. - </para> - <para> - Der optionale Parameter <parameter>flags</parameter> kann sich - aus den folgenden Bitmasken zusammensetzen: - <itemizedlist> - <listitem> - <simpara> - OP_READONLY - Über diese Verbindung darf nur lesend - zugegriffen werden - </simpara> - </listitem> - <listitem> - <simpara> - OP_ANONYMOUS - Bei NNTP-Verbindungen wird die Datei .newsrc - nicht aktualisiert - </simpara> - </listitem> - <listitem> - <simpara> - OP_HALFOPEN - es wird eine IMAP- oder NNTP-Verbindung - aufgebaut, aber noch kein Postfach ausgewählt - </simpara> - </listitem> - <listitem> - <simpara> - CL_EXPUNGE - beim Schließen der Verbindung werden alle zum - Löschen vorgemerkte Nachrichten endgültig gelöscht (siehe auch - <function>imap_delete</function> und - <function>imap_expunge</function>) - </simpara> - </listitem> - </itemizedlist> - </para> - <para> - Das folgende Beispiel stellt eine Verbindung zu einem - lokalen IMAP-Server (IMAP = Port 143) her: - <informalexample> - <programlisting role="php"> -$mbox = imap_open ("{localhost:143}INBOX", "user_id", "password"); - </programlisting> - </informalexample> - Eine Verbindung zu einem lokalen POP3-Server (POP3 = Port 110) - erhalten sie mit: - <informalexample> - <programlisting role="php"> -$mbox = imap_open ("{localhost/pop3:110}INBOX", "user_id", "password"); - </programlisting> - </informalexample> - Eine Verbindung zu einem lokalen News-Server (NNTP = Port 119) - erhalten Sie mit: - <informalexample> - <programlisting role="php"> -$nntp = imap_open ("{localhost/nntp:119}comp.test", "", ""); - </programlisting> - </informalexample> - Eine Verbindung zu einem nicht lokalen Server können Sie - herstellen, indem Sie in den oben genannten Beispielen - "localhost" durch den Namen oder die IP-Adresse des Servers - ersetzen. - </para> - <para> - <example> - <title><function>imap_open</function> Beispiel</title> - <programlisting> -$mbox = imap_open ("{your.imap.host:143}", "username", "password"); - -echo "&lt;p>&lt;h1>Mailboxes&lt;/h1>\n"; -$folders = imap_listmailbox ($mbox, "{your.imap.host:143}", "*"); -if ($folders == false) - echo "Call failed&lt;br>\n"; -else - while (list ($key, $val) = each ($folders)) - echo $val . "&lt;br>\n"; - -echo "&lt;p>&lt;h1>Headers in INBOX&lt;/h1>\n"; -$headers = imap_headers ($mbox); -if ($headers == false) - echo "Call failed&lt;br>\n"; -else - while (list ($key, $val) = each ($headers)) - echo $val . "&lt;br>n"; - -imap_close ($mbox); - </programlisting> - </example> - </para> - </refsect1> - </refentry> +<!-- $Revision: 1.6 $ --> +<!-- EN-Reference: 1.12 Maintainer: hholzgra Status: ready --> +<refentry id="function.imap-open"> + <refnamediv> + <refname>imap_open</refname> + <refpurpose>Öffnet eine Verbindung zu einem Mailserver-Postfach</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>imap_open</methodname> + <methodparam><type>string</type><parameter>mailbox</parameter></methodparam> + <methodparam><type>string</type><parameter>username</parameter></methodparam> + <methodparam><type>string</type><parameter>password</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <para> + Öffnet eine Verbindung zum Postfach <parameter>mailbox</parameter>. + </para> + <para> + Diese Funktion kann neben IMAP auch POP3 und NNTP Verbindungen aufbauen, + einige Funktionen und Eigenschaften sind aber nur in IMAP Verbindungen + verfügbar. + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>mailbox</parameter></term> + <listitem> + <para> + Ein Postfachname besteht aus einer Angabe des Servers und aus dem + Pfad zum Postfach auf diesem Server. Der reservierte Name + <literal>INBOX</literal> steht für das persönliche Postfach + des aktuellen Benutzers. Enthält der Name des Postfach internationale + Zeichen außerhalb des druckbaren ASCII Bereichs so müssen diese + mit <function>imap_utf7_encode</function> kodiert werden. + </para> + <para> + Der Serverteil wird in '{' und '}' eingebettet, er besteht aus dem + Namen oder der IP-Adresse des Servers, einer optionalen Portnummer + (eingeleitet mit ':' und einer optionalen Protokollangabe + (eingeleitet mit '/'). + </para> + <para> + Die Angabe des Serverteils ist immer zwingend. + </para> + <para> + Alle Namen die mit <literal>{</literal> beginnen bezeichnen Serverdienste + und werden in der Form + <literal>"{" remote_system_name [":" port] [flags] "}"</literal> + angegeben: + <itemizedlist> + <listitem> + <simpara> + <literal>remote_system_name</literal> - DNS Servername oder + IP-Adresse des Servers in eckigen Klammern + </simpara> + </listitem> + <listitem> + <simpara> + <literal>port</literal> - optionale Portnummer, Standard ist der + jeweilige Standardport des gewählten Protokolls + </simpara> + </listitem> + <listitem> + <simpara> + <literal>flags</literal> - Optionsflags, s.u. + </simpara> + </listitem> + <listitem> + <simpara> + <literal>mailbox_name</literal> - Name des gewünschten Serverpostfachs, + Standard ist "INBOX" + </simpara> + </listitem> + </itemizedlist> + </para> + <para> + <table> + <title>Optional flags for names</title> + <tgroup cols="2"> + <thead> + <row> + <entry>Flag</entry> + <entry>Description</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>/service=</literal><emphasis>service</emphasis></entry> + <entry>Postfach-Zugriffsprotokoll, Standard ist "imap"</entry> + </row> + <row> + <entry><literal>/user=</literal><emphasis>user</emphasis></entry> + <entry>Benutzername auf dem Mailserver</entry> + </row> + <row> + <entry><literal>/authuser=</literal><emphasis>user</emphasis></entry> + <entry>remote authentication user; if specified this is the user name + whose password is used (e.g. administrator)</entry> + </row> + <row> + <entry><literal>/anonymous</literal></entry> + <entry>Zugriff als anonymer Benutzer</entry> + </row> + <row> + <entry><literal>/debug</literal></entry> + <entry>Protokollausgaben in das Fehlerlog des Webservers leiten</entry> + </row> + <row> + <entry><literal>/secure</literal></entry> + <entry>Übertragung von Klartext-Passwörtern wird verhindert</entry> + </row> + <row> + <entry><literal>/imap</literal>, <literal>/imap2</literal>, + <literal>/imap2bis</literal>, <literal>/imap4</literal>, + <literal>/imap4rev1</literal></entry> + <entry>Kurzform für /service=imap</entry> + </row> + <row> + <entry><literal>/pop3</literal></entry> + <entry>Kurzform für /service=pop3</entry> + </row> + <row> + <entry><literal>/nntp</literal></entry> + <entry>Kurzform für /service=nntp</entry> + </row> + <row> + <entry><literal>/norsh</literal></entry> + <entry>Für eine vorauthentifizierte IMAP Verbindung soll weder rsh + noch ssh verwendet werden</entry> + </row> + <row> + <entry><literal>/ssl</literal></entry> + <entry>Secure Socket Layer (SSL) zur Verschlüsselung der Verbindung + verwenden</entry> + </row> + <row> + <entry><literal>/validate-cert</literal></entry> + <entry>TLS/SSL Zertifikate verifizieren (Standardverhalten)</entry> + </row> + <row> + <entry><literal>/novalidate-cert</literal></entry> + <entry>TLS/SSL Zertifikate nicht verifizieren, wird für + selbstsignierte Zertifikate benötigt </entry> + </row> + <row> + <entry><literal>/tls</literal></entry> + <entry>start-TLS Verschlüsselung erzwingen, Verbindungen von Servern + die dies nicht unterstützen ablehnen.</entry> + </row> + <row> + <entry><literal>/notls</literal></entry> + <entry>start-TLS nicht verwenden, auch wenn es der Server + unterstützt</entry> + </row> + <row> + <entry><literal>/readonly</literal></entry> + <entry>Nur lesender Zugriff auf den Server ohne serverseitige + Änderung von Daten (nur für IMAP, NNTP ignoriert dies, + POP3 und SMTP verweigern readonly Verbindungen)</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>username</parameter></term> + <listitem> + <para> + Der Benutzername + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>password</parameter></term> + <listitem> + <para> + Das Passwort zum Benutzernamen + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <para> + Der Parameter <parameter>options</parameter> kann sich als Bitmaske + aus folgenden Werten zusammensetzen: + <itemizedlist> + <listitem> + <simpara> + <constant>OP_READONLY</constant> - Nur lesende Zugriffe + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_ANONYMOUS</constant> - ein existierendes + <filename>.newsrc</filename> weder lesen noch aktualisieren + (nur NNTP) + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_HALFOPEN</constant> - Verbindung zum Server öffnen + aber noch kein Postfach auswählen (nur IMAP und NNTP) + </simpara> + </listitem> + <listitem> + <simpara> + <constant>CL_EXPUNGE</constant> - Zum löschen markierte Nachrichten + beim Schließen des Postfachs automatisch entfernen (siehe auch + <function>imap_delete</function> und <function>imap_expunge</function>) + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_DEBUG</constant> - Debug Protokoll + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_SHORTCACHE</constant> - verkürztes Cacheing + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_SILENT</constant> - Ereignisse nicht weitergeben + (interne Einstellung) + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_PROTOTYPE</constant> - Driver Prototyp zurückgeben + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_EXPUNGE</constant> - Silently expunge recycle stream + </simpara> + </listitem> + <listitem> + <simpara> + <constant>OP_SECURE</constant> - Authentifikation nicht absichern + </simpara> + </listitem> + </itemizedlist> + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Liefert einen IMAP Stream oder &flase; bei Fehlern. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Verschiedene <function>imap_open</function> Aufrufe</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Verbindung zu einem IMAP server auf Port 143 des lokalen Rechners +$mbox = imap_open("{localhost:143}INBOX", "user_id", "password"); + +// Verbindung zu einem POP3 server auf Port 110 des lokalen Rechners +$mbox = imap_open ("{localhost:110/pop3}INBOX", "user_id", "password"); + +// Für SSL verschlüsselte Verbindungen wird /ssl an die +// Protokollspezifikation angefügt +$mbox = imap_open ("{localhost:993/imap/ssl}INBOX", "user_id", "password"); + +// Zur SSL Verbindung mit Servern mit selbstsignierten Zertifikaten +// muss zusätzlich /novalidate-cert angefügt werden +$mbox = imap_open ("{localhost:995/pop3/ssl/novalidate-cert}", "user_id", "password"); + +// Verbindung zu einem NNTP server auf Port 119 des lokalen Rechners +$nntp = imap_open ("{localhost:119/nntp}comp.test", "", ""); + +// Für Verbindungen zu anderen Servern ersetzen Sie "localhost" mit +// dem Namen oder der IP-Adresse des Servers +?> +]]> + </programlisting> + </example> + <example> + <title><function>imap_open</function> Beispiel</title> + <programlisting role="php"> +<![CDATA[ +<?php +$mbox = imap_open("{imap.example.org:143}", "username", "password"); + +echo "<h1>Postfächer</h1>\n"; +$folders = imap_listmailbox($mbox, "{imap.example.org:143}", "*"); + +if ($folders == false) { + echo "Abruf fehlgeschlagen<br />\n"; +} else { + foreach ($folders as $val) { + echo $val . "<br />\n"; + } +} + +echo "<h1>Nachrichten in INBOX</h1>\n"; +$headers = imap_headers($mbox); + +if ($headers == false) { + echo "Abruf fehlgeschlagen<br />\n"; +} else { + foreach ($headers as $val) { + echo $val . "<br />\n"; + } +} + +imap_close($mbox); +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>imap_close</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables:
« previous php.doc.de (#2045) next »