This function is used to set the Session Module at site or script level.
The global configuration can be done in php.ini under the [Session] section and with the name of "session.save_handler". The sessions are saved in files by default, like so:
session.save_handler = files
But with this configuration you set one of your websites to use some other session module (if you have them installed and extension loaded with PHP), like so:
<?php
// NOTE: You must use this function before starting session with session_start(); to make it work properly
session_module_name('memcache'); // or pgsql or redis etc
// You'll need to define a save path also, if the module is other than files, like so:
session_save_path('localhost:11211'); // memcache uses port 11211
// or you can use multiple for load balancing:
session_save_path('localhost:11211:41,otherhost:11211:60') // First part is hostname or path to socket, next is port and the last is the weight for that server
//The function also returns the value of the current session module.
echo session_module_name(); // will print memcache in our case
// or maybe a check
if(session_module_name() != 'memcache'){
// Do something, throw an exception maybe
}
session_module_name
(PHP 4, PHP 5, PHP 7, PHP 8)
session_module_name — Liefert und/oder setzt das aktuelle Session-Modul
Beschreibung
session_module_name() gibt den Namen des aktuellen Session-Moduls zurück, das auch unter dem Namen session.save_handler bekannt ist.
Parameter-Liste
-
module -
Wenn
moduleangegeben wird und nichtnullist, wird stattdessen dieses Modul verwendet. Die Übergabe von"user"an diesen Parameter ist verboten. Statt dessen sollte session_set_save_handler() aufgerufen werden, um eine benutzerdefinierte Session-Routine festzulegen.
Rückgabewerte
Gibt den Namen des aktuellen Session-Moduls zurück.
Bei einem Fehler wird false zurückgegeben.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 |
module ist jetzt nullable (akzeptiert den
NULL-Wert).
|
| 7.2.0 |
Es ist nun explizit verboten, den Modulnamen auf
"user" festzulegen. Zuvor wurde dies stillschweigend
ignoriert.
|
add a note
User Contributed Notes 2 notes
raees at steelbrain dot com dot pk ¶
10 years ago
Anonymous ¶
9 years ago
was looking for a rather comprehensive list of modules, and found http://stackoverflow.com/questions/8415962/what-exactly-phps-function-session-module-name-is-for but there are more.
