(PHP 4, PHP 5, PHP 7, PHP 8)
session_name — Geçerli oturum ismini döndürür ve/veya tanımlar
session_name() işlevi geçerli oturumun ismini döndürür. isim belirtilmişse ve null değilse, session_name() işlevi oturumun ismini günceller ve eski oturum ismini döndürür.
session_name() oturum ismini güncellerken, HTTP çerezinide günceller (ve session.transid etkinse içeriği çıktılar). HTTP çerezi gönderilirse session_name() hata üretir. Oturumun düzgün çalışması için session_name() işlevi session_start() işlevinden önce çağrılmalıdır.
Oturum ismi istek başlangıcında session.name yönergesinde tanımlı isimle sıfırlanır. Oturumun ismini öntanımlı isimden farklı bir isimle değiştirmek için her istekte session_name() çağrısı yapmalısınız (session_start() veya session_register() çağrısından önce).
isim Oturum ismi (PHPSESSID gibi), çerezler ve URL'lerde kullanılan oturum ismidir. Oturum ismi sadece abecesayısal karakterler içermeli, (çerez uyarılarını etkin kılan kullanıcılar için) kısa ve açıklayıcı olmalıdır. Bir isim belirtilirse ve null değilse, geçerli oturumun ismi bu isimle değiştirilir.
Oturum ismi sadece rakamlardan oluşamaz, hiç olmazsa bir harf içermesi gerekir. Aksi takdirde her seferinde yeni bir oturum kimliği üretilir.
Geçerli oturumun ismini döndürür. isim belirtilmişse ve null değilse işlev oturum ismini günceller ve eski oturum kimliğini döndürür, başarısızlık durumunda false döner.
| Sürüm: | Açıklama |
|---|---|
| 8.0.0 | isim artık null olabiliyor. |
| 7.2.0 | session_name() artık oturum durumuna bakıyor, evvelce sadece çerez durumuna bakardı. Bu, eski session_name() işlevinin session_start() çağrısından sonra çağrılmasına sebep oluyor ve PHP'nin çökmesine veya hatalı davranmasına yol açabiliyordu. |
Örnek 1 - session_name() örneği
<?php
$eski_isim = session_name("SiteID");
echo "Önceki oturum ismi $eski_isim idi.<br />";
?>