(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
/* oturum ismini SiteID yapalım */
$eski_isim = session_name("SiteID");
echo "Önceki oturum ismi $eski_isim idi.<br />";
?>