PHP 8.4.0 RC3 available for testing

    session_id

    (PHP 4, PHP 5, PHP 7, PHP 8)

    session_id — Liefert und/oder setzt die aktuelle Session-ID

    Beschreibung

    session_id(?string $id = null): string|false

    session_id() wird verwendet, um die Session-ID der aktuellen Session zu erhalten oder zu setzen.

    Die Konstante SID kann auch dazu verwendet werden, den aktuellen Namen und die Session-ID als Zeichenkette passend zum Anhängen an URLs zu erhalten. Siehe auch Session-Funktionen.

    Parameter-Liste

    id

    Wenn id angegeben wird und nicht null ist, wird die aktuelle Session-ID ersetzt. session_id() muss zu diesem Zweck vor session_start() aufgerufen werden. In Abhängigkeit von der Session-Routine sind in der Session-ID nicht alle Zeichen erlaubt. Zum Beispiel erlaubt die dateibasierte Session-Routine nur Zeichen im Bereich [a-zA-Z0-9,-]!

    Hinweis: Falls Session-Cookies verwendet werden und für session_id() eine id angegeben wird, wird ungeachtet dessen, ob die aktuelle Session-ID mit der neuen identisch ist, bei jedem Aufruf von session_start() ein neues Cookie gesendet.

    Rückgabewerte

    session_id() gibt die Session-ID der aktuellen Session zurück oder die leere Zeichenkette (""), falls es keine aktuelle Session gibt (es existiert keine aktuelle Session-ID). Bei Auftreten eines Fehlers wird false zurückgegeben.

    Changelog

    Version Beschreibung
    8.0.0 id ist jetzt nullable (akzeptiert den NULL-Wert).

    Siehe auch

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    42
    Riikka K
    9 years ago
    It may be good to note that PHP does not allow arbitrary session ids. The session id validation in PHP source is defined in ext/session/session.c in the function php_session_valid_key:

    https://github.com/php/php-src/blob/master/ext/session/session.c

    To put it short, a valid session id may consists of digits, letters A to Z (both upper and lower case), comma and dash. Described as a character class, it would be [-,a-zA-Z0-9]. A valid session id may have the length between 1 and 128 characters. To validate session ids, the easiest way to do it use a function like:

    <?php

    function session_valid_id($session_id)
    {
    return     preg_match('/^[-,a-zA-Z0-9]{1,128}$/', $session_id) > 0;
    }

    ?>

    session_id() itself will happily accept invalid session ids, but if you try to start a session using an invalid id, you will get the following error:

    Warning: session_start(): The session id is too long or contains illegal characters, valid characters are a-z, A-Z, 0-9 and '-,'
    ＋add a note
    To Top