imap-open.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 34892f82742329af7e7b4b22be6ad21418fd9768 Maintainer: haluk Status: ready -->
<refentry xml:id="function.imap-open" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>imap_open</refname>
  <refpurpose>Belirtilen posta kutusuna yeni bir  <acronym>IMAP</acronym>
  akımı açar</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>IMAP\Connection</type><type>false</type></type><methodname>imap_open</methodname>
   <methodparam><type>string</type><parameter>pk</parameter></methodparam>
   <methodparam><type>string</type><parameter>kullanıcı</parameter></methodparam>
   <methodparam><type>string</type><parameter>parola</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>bayraklar</parameter><initializer>NIL</initializer></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>dnm_sayısı</parameter><initializer>0</initializer></methodparam>
   <methodparam choice="opt"><type>array</type><parameter>seçenekler</parameter><initializer>[]</initializer></methodparam>
  </methodsynopsis>
  <para>
   Belirtilen posta kutusuna (<parameter>pk</parameter>) bir
   <acronym>IMAP</acronym> akımı açar.
  </para>
  <para>
   Bu işlev <acronym>POP3</acronym> ve <acronym>NNTP</acronym> sunucularına
   oturum açmak için de kullanılabilirse de bazı işlevler ve özellikler
   sadece <acronym>IMAP</acronym> sunucularında kullanılabilmektedir.
  </para>
 </refsect1>
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>pk</parameter></term>
     <listitem>
      <para>
       Bir posta kutusu ismi, bir sunucu ve sunucu üzerindeki bir posta kutusu
       yolundan oluşur. <literal>INBOX</literal> özel bir isim olup
       kullanıcıların kişisel posta kutularını betimler. Uluslararası
       karakterler içeren posta kutusu isimleri, ASCII bölgesinde basılabilir
       hale getirilmek üzere <function>imap_utf7_encode</function> ile
       kodlanır.
      </para>
      &imap.mailboxname.insecure;
      <para>
       Posta kutusu isminin sunucu parçası  '{' ve '}' ayraçları arasına
       yazılmış sunucu adı veya IP adresine iki nokta imi ile eklemlenebilen
       isteğe bağlı bir port ve '/' ile eklemlenebilen yine isteğe bağlı bir
       protokol belirtiminden oluşur.
      </para>
      <para>
       Tüm posta kutusu bağımsız değişkenlerinde sunucu parçasının belirtilmesi
       zorunludur.
      </para>
      <para>
       Tüm isimler <literal>{</literal> ayracı ile başlar ve genelde şu
       sözdizimine sahiptir: <literal>"{" uzak_sistem_adı [":" port] [imler]
       "}" [pk_ismi]</literal>. Sözdizimini oluşturan parçaların açıklamaları:
       <itemizedlist>
        <listitem>
         <simpara>
          <literal>uzak_sistem_adı</literal> - Genel Ağ alan adı veya
          sunucunun IP adresi.
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <literal>port</literal> - İsteğe bağlı TCP port numarası; öntanımlı
          değeri hizmetin öntanımlı port numarasıdır.
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <literal>imler</literal> - İsteğe bağlı imlerin açıklamaları için
          aşağıdaki tabloya bakınız.
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <literal>pk_ismi</literal> - Uzak posta kutusu ismi; INBOX
          öntanımlı isimdir.
         </simpara>
        </listitem>
       </itemizedlist>
      </para>
      <para>
       <table>
        <title>İsimler için seçimlik imler</title>
        <tgroup cols="2">
         <thead>
          <row>
           <entry>İm</entry>
           <entry>Açıklama</entry>
          </row>
         </thead>
         <tbody>
          <row>
           <entry><userinput>/service=</userinput><replaceable>hizmet</replaceable></entry>
           <entry>Posta kutusuna erişimi sağlayan hizmetin adı; "imap"
           öntanımlı değerdir.</entry>
          </row>
          <row>
           <entry><userinput>/user=</userinput><replaceable>kullanıcı</replaceable></entry>
           <entry>Sunucuya oturum açmak için uzak kullanıcı ismi</entry>
          </row>
          <row>
           <entry><userinput>/authuser=</userinput><replaceable>kullanıcı</replaceable></entry>
           <entry>Kimlik doğrulaması için kullanılacak kullanıcı ismi;
           belirtilirse parola olarak bu kullanıcının parolası
           kullanılır.</entry>
          </row>
          <row>
           <entry><userinput>/anonymous</userinput></entry>
           <entry>Bir anonim kullanıcı olarak erişim</entry>
          </row>
          <row>
           <entry><userinput>/debug</userinput></entry>
           <entry>Uygulamanın hata ayıklama günlüğündeki protokol uzaktan
           ölçümü kaydedilir.</entry>
          </row>
          <row>
           <entry><userinput>/secure</userinput></entry>
           <entry>Salt metin bir parola ağ üzerinden aktarılmaz.</entry>
          </row>
          <row>
           <entry><userinput>/imap</userinput>, <userinput>/imap2</userinput>,
            <userinput>/imap2bis</userinput>, <userinput>/imap4</userinput>,
            <userinput>/imap4rev1</userinput></entry>
           <entry><literal>/service=imap</literal>'a eşdeğerdir.</entry>
          </row>
          <row>
           <entry><userinput>/pop3</userinput></entry>
           <entry><literal>/service=pop3</literal>'e eşdeğerdir.</entry>
          </row>
          <row>
           <entry><userinput>/nntp</userinput></entry>
           <entry><literal>/service=nntp</literal>'ye eşdeğerdir.</entry>
          </row>
          <row>
           <entry><userinput>/norsh</userinput></entry>
           <entry>Ön kimlik doğrulamalı IMAP oturumu oluşturmak için rsh veya
           ssh kullanılmaz</entry>
          </row>
          <row>
           <entry><userinput>/ssl</userinput></entry>
           <entry>Oturumu şifrelemek için use the <acronym>SSL</acronym>
           kullanılır.</entry>
          </row>
          <row>
           <entry><userinput>/validate-cert</userinput></entry>
           <entry>TLS/SSL sunucusundaki sertifikaları doğrular (bu öntanımlı
           davranıştır)</entry>
          </row>
          <row>
           <entry><userinput>/novalidate-cert</userinput></entry>
           <entry>TLS/SSL sunucusundaki sertifikalar doğrulanmaz; sunucu öz-
           imzalı sertifikalar kullanıyorsa gerekir.</entry>
          </row>
          <row>
           <entry><userinput>/tls</userinput></entry>
           <entry>Oturumu şifrelemek için <literal>start-TLS</literal>
           kullanımı zorlanır ve bunu desteklemeyen sunuculara bağlantı
           reddedilir.</entry>
          </row>
          <row>
           <entry><userinput>/notls</userinput></entry>
           <entry>Oturumu şifrelemek için sunucular desteklese bile
           <literal>start-TLS</literal> kullanılmaz.</entry>
          </row>
          <row>
           <entry><userinput>/readonly</userinput></entry>
           <entry>Salt-okunur posta kutusu açma isteği yapılır. (Sadece IMAP
           içindir. NNTP'de yoksayılır, SMTP ve POP3 ile kullanıldığında ise
           hata oluşur).</entry>
          </row>
         </tbody>
        </tgroup>
       </table>
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>kullanıcı</parameter></term>
     <listitem>
      <para>
       Kullanıcı ismi.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>Parola</parameter></term>
     <listitem>
      <para>
       <parameter>kullanıcı</parameter> ile ilişkili parola.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>bayraklar</parameter></term>
     <listitem>
      <para>
       Aşağıdakilerden bir veya birkaçını içeren bir bit maskesidir:
       <itemizedlist>
        <listitem>
         <simpara>
          <constant>OP_READONLY</constant> - Posta kutusu salt-okunu açılır.
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>OP_ANONYMOUS</constant> - Haberler (sadece
          <acronym>NNTP</acronym>) için <filename>.newsrc</filename>
          kullanılmaz ve güncellenmez.
        </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>OP_HALFOPEN</constant> - <acronym>IMAP</acronym>
          ve <acronym>NNTP</acronym> isimleri için bir posta kutusu değil bir
          bağlantı açar.
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>CL_EXPUNGE</constant> - Kapatmadan önce posta kutusu
          sessizce silinir (ayrıca bakınız: <function>imap_delete</function>
          ve <function>imap_expunge</function>)
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>OP_DEBUG</constant> - Hata ayıklama protokolü pazarlığı
          yapılır.
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>OP_SHORTCACHE</constant> - Küçük (sadece
          <literal>elt</literal>) önbellekleme
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>OP_SILENT</constant> - Olaylar aktarılmaz (dahili
          kullanım)
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>OP_PROTOTYPE</constant> - Sürücü önörneği döner.
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>OP_SECURE</constant> - Güvenilir olmayan bağlantıyla
          kimlik doğrulaması yapılmaz.
         </simpara>
        </listitem>
       </itemizedlist>
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>dnm_sayısı</parameter></term>
     <listitem>
      <para>
       Azami bağlantı denemesi sayısı.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>seçenekler</parameter></term>
     <listitem>
      <para>
       Bağlantı bağımsız değişkenleri. Aşağıdaki anahtarlar bunlardan biri veya bir
       kaçını atamakta kullanılabilir:
       <itemizedlist>
        <listitem>
         <simpara>
          <literal>DISABLE_AUTHENTICATOR</literal> - Kimlik kanıtlama
          özelliklerini iptal eder.
         </simpara>
        </listitem>
       </itemizedlist>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Hata durumunda &false; yoksa bir <classname>IMAP\Connection</classname>
   nesnesi döner.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.1.0</entry>
      <entry>
       Artık <classname>IMAP\Connection</classname> nesnesi dönüyor;
       evvelce imap akımı özkaynağı dönerdi.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>- <function>imap_open</function> işlevinin farklı kullanımları
    </title>
    <programlisting role="php">
<![CDATA[
<?php
// Yerel makinenin 143. portunda çalışan IMAP sunucusuna bağlan
$mbox = imap_open("{localhost:143}INBOX", "birey", "parola");

// Yerel makinenin 110. portunda çalışan POP3 sunucusuna bağlan
$mbox = imap_open ("{localhost:110/pop3}INBOX", "birey", "parola");

// Protokol belirtimi olarak /ssl kullanarak
// bir SSL IMAP veya POP3 sunucusuna bağlan
$mbox = imap_open ("{localhost:993/imap/ssl}INBOX", "birey", "parola");

// Protokol belirtimi olarak /ssl/novalidate-cert kullanarak öz-imzalı
// sertifika kullanan bir SSL IMAP veya POP3 sunucusuna bağlan
$mbox = imap_open ("{localhost:995/pop3/ssl/novalidate-cert}",
          "birey", "parola");

// Yerel makinenin 119. portunda çalışan NNTP sunucusuna bağlan
$nntp = imap_open ("{localhost:119/nntp}comp.test", "", "");
// Bir uzak sunucuya bağlanmak için "localhost" yerine sunucunun adını
// veya IP adresini yazın.
?>
]]>
    </programlisting>
   </example>
   <example>
    <title>- <function>imap_open</function> örneği</title>
    <programlisting role="php">
<![CDATA[
<?php
$mbox = imap_open("{imap.example.org:143}", "birey", "parola");

echo "<h1>Posta kutuları</h1>\n";
$folders = imap_listmailbox($mbox, "{imap.example.org:143}", "*");

if ($folders == false) {
    echo "İşlem başarısız oldu<br />\n";
} else {
    foreach ($folders as $val) {
        echo $val . "<br />\n";
    }
}

echo "<h1>INBOX içindeki başlıklar</h1>\n";
$headers = imap_headers($mbox);

if ($headers == false) {
    echo "İşlem başarısız oldu<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:
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
-->