archived-doc-tr/reference/session/functions/session-create-id.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: a846e49f6e3083eabfe5c1ec35f209aadf50af02 Maintainer: nilgun Status: ready -->
<refentry xml:id="function.session-create-id" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>session_create_id</refname>
  <refpurpose>Yeni bir oturum kimliği oluşturur</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>string</type><type>false</type></type><methodname>session_create_id</methodname>
   <methodparam choice="opt"><type>string</type><parameter>önek</parameter><initializer>""</initializer></methodparam>
  </methodsynopsis>
  <para>
   <function>session_create_id</function> geçerli oturum için yeni bir oturum
   kimliği oluşturmak için kullanılır. Çakışmayan oturum kimliği döndürür.
  </para>
  <para>
   Oturum etkin değilse çakışma denetimi yapılmaz.
  </para>
  <para>
   Oturum kimliği php.ini ayarlarına uygun olarak üretilir.
  </para>
  <para>
   Çöp toplayıcı (gc) görev betiği için http sunucusunun kullanıcı kimliğinin
   kullanılması önemlidir. Aksi takdirde, özellikle dosya kaydetme
   işleyicisinde izin sorunları yaşanabilir.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>önek</parameter></term>
      <listitem>
       <para>
        <parameter>önek</parameter> belirtilirse, yeni oturum kimliği bu önek
        ile başlar. Oturum kimlğinde her karaktere izin verilmez. Geçerli
        karakterler: <literal>a-z A-Z 0-9 , (virgül) ve - (tire)</literal>.
        Azami uzunluk 256 karakterdir.
       </para>
      </listitem>
     </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   <function>session_create_id</function> geçerli oturum için çakışmayan yeni
   bir oturum kimliği döndürür. Etkin olmayan bir oturum için kullanılırsa
   çakışma denetimi yapılmaz. Başarısızlık durumunda &false; döner.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>- <function>session_create_id</function> ile <function>session_regenerate_id</function> örneği</title>
    <programlisting role="php">
<![CDATA[
<?php
// Oturum başlatma işlevimiz zaman damgası yönetimi de içeriyor
function my_session_start() {
    session_start();
    // Eski oturum kimliği kullanılmasın
    if (!empty($_SESSION['deleted_time']) && $_SESSION['deleted_time'] < time() - 180) {
        session_destroy();
        session_start();
    }
}

// Oturum kimliğini yeniden üretme işlevimiz
function my_session_regenerate_id() {
    // Çakışmasız oturum kimliği üretilmesi için
    // session_create_id() işlevini oturum etkinken çağırmalıyız
    if (session_status() != PHP_SESSION_ACTIVE) {
        session_start();
    }
    // UYARI: Önek için asla gizli kalması gereken verileri kullanmayın!
    $newid = session_create_id('myprefix-');
    // Silinmiş zaman damgasını ata. Oturum verisi sırf bu nedenle silinmesin
    $_SESSION['deleted_time'] = time();
    // Oturumu bitir
    session_commit();
    // Kullanıcı tanımlı oturum kimliği kabul edildiğinden emin olun
    // BİLGİ: Normal işlemler için use_strict_mode etkin olmalıdır.
    ini_set('session.use_strict_mode', 0);
    // Yeni özel oturum kimliğini ata
    session_id($newid);
    // Yeni özel oturum kimliği ile oturmu başlat
    session_start();
}

// use_strict_mode etkin olduğundan emin olun.
// use_strict_mode güvenli bir oturum için zorunludur.
ini_set('session.use_strict_mode', 1);
my_session_start();

// Oturum kimliğinin yeniden üretilmesini gerektiren durumlar:
//  - Kullanıcı oturum açmışsa
//  - Kullanıcı oturumu kapatmışsa
//  - Belirlenen süre aşılmışsa
my_session_regenerate_id();

// Diğer işlemler ...
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>session_regenerate_id</function></member>
    <member><function>session_start</function></member>
    <member>
     <link linkend="ini.session.use-strict-mode">session.use_strict_mode</link>
     yapılandırma yönergesi
    </member>
    <member><methodname>SessionHandler::create_sid</methodname></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
-->