session_name 读取/设置会话名称
发表日期：2021-07-01 08:56:51 | 来源： | | 浏览(909) 分类：Session 函数
session_name
(PHP 4, PHP 5, PHP 7, PHP 8)
session_name — 读取/设置会话名称
说明
$name = ?): string
session_name() 函数返回当前会话名称。
如果指定 name 参数，
session_name() 函数会更新会话名称，
并返回 原来的 会话名称。
如果使用 name 指定了新字符串作为会话 cookie 的名字，
session_name() 函数会修改 HTTP 响应中的 cookie
（如果启用了 session.transid，还会输出会话 cookie 的内容）。
一旦在 HTTP 响应中发送了 cookie 的内容之后，
调用 session_name() 函数会产生错误。
所以，一定要在调用 session_start() 函数之前
调用此函数。
请求开始的时候，会话名称会被重置并且存储到
session.name 配置项。
因此，要想设置会话名称，那么对于每个请求，都需要在
调用 session_start() 函数
之前调用 session_name() 函数。
参数
-
name -
用在 cookie 或者 URL 中的会话名称， 例如：
PHPSESSID。 只能使用字母和数字作为会话名称，建议尽可能的短一些， 并且是望文知意的名字（对于启用了 cookie 警告的用户来说，方便其判断是否要允许此 cookie）。 如果指定了name参数， 那么当前会话也会使用指定值作为名称。警告会话名称至少需要一个字母，不能全部都使用数字， 否则，每次都会生成一个新的会话 ID。
返回值
返回当前会话名称。如果指定 name 参数，那么此函数会更新会话名称，并且
返回 原来的 会话名称。
范例
示例 #1 session_name() 示例
<?php
/* 设置会话名称为 WebsiteID */
$previous_name = session_name("WebsiteID");
echo "The previous session name was $previous_name<br />";
?>
更新日志
| 版本 | 说明 |
|---|---|
| 7.2.0 | session_name() 函数会检查会话状态， 之前的版本仅仅检查 cookie 状态。 所以，旧版本的 PHP 允许你在调用 session_start() 函数之后再调用 session_name() 函数， 新版本的 PHP 不再允许这样做了。 |
- PHP（0）
- PHP杂项（34）
- PHP基础-李炎恢系列课程（20）
- 中文函数手册（0）
- 错误处理 函数（13）
- OPcache 函数（6）
- PHP 选项/信息 函数（54）
- Zip 函数（10）
- Hash 函数（15）
- OpenSSL 函数（63）
- Date/Time 函数（51）
- 目录函数（9）
- Fileinfo 函数（6）
- iconv 函数（11）
- 文件系统函数（81）
- 多字节字符串 函数（57）
- GD 和图像处理 函数（114）
- 可交换图像信息（5）
- Math 函数（50）
- 程序执行函数（11）
- PCNTL 函数（23）
- JSON 函数（4）
- SPL 函数（15）
- URL 函数（10）
- cURL 函数（32）
- 网络 函数（33）
- FTP 函数（36）
- Session 函数（23）
- session_abort Discard session array changes and finish session（0）
- session_cache_expire 返回当前缓存的到期时间（0）
- session_cache_limiter 读取/设置缓存限制器（0）
- session_commit session_write_close() 的别名（0）
- session_create_id Create new session id（0）
- session_decode 解码会话数据（0）
- session_destroy 销毁一个会话中的全部数据（0）
- session_encode 将当前会话数据编码为一个字符串（0）
- session_gc Perform session data garbage collection（0）
- session_get_cookie_params 获取会话 cookie 参数（0）
- session_id 获取/设置当前会话 ID（0）
- session_module_name 获取/设置会话模块名称（0）
- session_name 读取/设置会话名称（0）
- session_regenerate_id 使用新生成的会话 ID 更新现有会话 ID（0）
- session_register_shutdown 关闭会话（0）
- session_reset Re-initialize session array with original values（0）
- session_save_path 读取/设置当前会话的保存路径（0）
- session_set_cookie_params 设置会话 cookie 参数（0）
- session_set_save_handler 设置用户自定义会话存储函数（0）
- session_start 启动新会话或者重用现有会话（0）
- session_status 返回当前会话状态（0）
- session_unset 释放所有的会话变量（0）
- session_write_close Write session data and end session（0）
- PCRE 函数（11）
- PCRE 正则语法（19）
- 数组 函数（81）
- 类/对象 函数（18）
- 函数处理 函数（13）
- 变量处理 函数（37）
- SimpleXML 函数（3）
- 杂项 函数（31）
- 字符串 函数（101）
宁公网安备 64010402001209号