PHP session_module_name 会话函数

• 

  定义和用法

  session_module_name - 获取/设置会话模块名称
• 

  版本支持

  PHP4	PHP5	PHP7
  支持	支持	支持

  7.2.0 不允许设置模块名称为 "user"。 在之前的版本中，如果设置为 "user"，那么会被静默的忽略到。

• 

  语法

  session_module_name ( [ string $module ] )
  

  session_module_name() 获取或设置会话模块名称
• 

  参数

  参数	必需的	描述
  module	否	如果指定 module 参数，则使用 指定值作为会话模块。 禁止传入 "user" 作为此参数的值， 请使用 set_set_save_handler() 来设置用户自定义的会话处理器。

• 

  返回值

  返回当前所用的会话模块名称。
• 

  示例

  // 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_regenerate_id() - 使用新生成的会话 ID 更新现有会话 ID

  session_start() - 启动新会话或者重用现有会话

  session_set_save_handler() - 设置用户自定义会话存储函数