mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-06-17 21:16:57 +08:00
155 lines
6.1 KiB
HTML
155 lines
6.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
||
<title>读取/设置会话名称</title>
|
||
</head>
|
||
<body class="docs"><div id="layout">
|
||
<div id="layout-content"><div id="function.session-name" class="refentry">
|
||
<div class="refnamediv">
|
||
<h1 class="refname">session_name</h1>
|
||
<p class="verinfo">(PHP 4, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">session_name</span> — <span class="dc-title">读取/设置会话名称</span></p>
|
||
|
||
</div>
|
||
|
||
<div class="refsect1 description" id="refsect1-function.session-name-description">
|
||
<h3 class="title">说明</h3>
|
||
<div class="methodsynopsis dc-description">
|
||
<span class="methodname"><strong>session_name</strong></span>
|
||
([ <span class="methodparam"><span class="type">string</span> <code class="parameter">$name</code></span>
|
||
] ) : <span class="type">string</span></div>
|
||
|
||
<p class="para rdfs-comment">
|
||
<span class="function"><strong>session_name()</strong></span> 函数返回当前会话名称。
|
||
如果指定 <code class="parameter">name</code> 参数，
|
||
<span class="function"><strong>session_name()</strong></span> 函数会更新会话名称，
|
||
并返回 <em class="emphasis">原来的</em> 会话名称。
|
||
</p>
|
||
<p class="para">
|
||
如果使用 <code class="parameter">name</code> 指定了新字符串作为会话 cookie 的名字，
|
||
<span class="function"><strong>session_name()</strong></span> 函数会修改 HTTP 响应中的 cookie
|
||
（如果启用了 <em>session.transid</em>，还会输出会话 cookie 的内容）。
|
||
一旦在 HTTP 响应中发送了 cookie 的内容之后，
|
||
调用 <span class="function"><strong>session_name()</strong></span> 函数会产生错误。
|
||
所以，一定要在调用 <span class="function"><a href="session_start.html" class="function">session_start()</a></span> 函数之前
|
||
调用此函数。
|
||
</p>
|
||
<p class="para">
|
||
请求开始的时候，会话名称会被重置并且存储到
|
||
<em>session.name</em> 配置项。
|
||
因此，要想设置会话名称，那么对于每个请求，都需要在
|
||
调用 <span class="function"><a href="session_start.html" class="function">session_start()</a></span> 函数
|
||
之前调用 <span class="function"><strong>session_name()</strong></span> 函数。
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 parameters" id="refsect1-function.session-name-parameters">
|
||
<h3 class="title">参数</h3>
|
||
<p class="para">
|
||
<dl>
|
||
|
||
|
||
<dt>
|
||
<code class="parameter">name</code></dt>
|
||
|
||
<dd>
|
||
|
||
<p class="para">
|
||
用在 cookie 或者 URL 中的会话名称，
|
||
例如：<em>PHPSESSID</em>。
|
||
只能使用字母和数字作为会话名称，建议尽可能的短一些，
|
||
并且是望文知意的名字（对于启用了 cookie 警告的用户来说，方便其判断是否要允许此 cookie）。
|
||
如果指定了 <code class="parameter">name</code> 参数，
|
||
那么当前会话也会使用指定值作为名称。
|
||
</p>
|
||
<p class="para">
|
||
<div class="warning"><strong class="warning">Warning</strong>
|
||
<p class="para">
|
||
会话名称至少需要一个字母，不能全部都使用数字，
|
||
否则，每次都会生成一个新的会话 ID。
|
||
</p>
|
||
</div>
|
||
</p>
|
||
</dd>
|
||
|
||
|
||
</dl>
|
||
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 returnvalues" id="refsect1-function.session-name-returnvalues">
|
||
<h3 class="title">返回值</h3>
|
||
<p class="para">
|
||
返回当前会话名称。如果指定 <code class="parameter">name</code> 参数，那么此函数会更新会话名称，并且
|
||
返回 <em class="emphasis">原来的</em> 会话名称。
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 examples" id="refsect1-function.session-name-examples">
|
||
<h3 class="title">范例</h3>
|
||
<p class="para">
|
||
<div class="example" id="example-5835">
|
||
<p><strong>Example #1 <span class="function"><strong>session_name()</strong></span> 示例</strong></p>
|
||
<div class="example-contents">
|
||
<div class="phpcode"><pre><span style="color: #000000">
|
||
<span style="color: #0000BB"><?php<br /><br /></span><span style="color: #FF8000">/* 设置会话名称为 WebsiteID */<br /><br /></span><span style="color: #0000BB">$previous_name </span><span style="color: #007700">= </span><span style="color: #0000BB">session_name</span><span style="color: #007700">(</span><span style="color: #DD0000">"WebsiteID"</span><span style="color: #007700">);<br /><br />echo </span><span style="color: #DD0000">"The previous session name was </span><span style="color: #0000BB">$previous_name</span><span style="color: #DD0000"><br />"</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?></span>
|
||
</span>
|
||
</pre></div>
|
||
</div>
|
||
|
||
</div>
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 changelog" id="refsect1-function.session-name-changelog">
|
||
<h3 class="title">更新日志</h3>
|
||
<p class="para">
|
||
<table class="doctable informaltable">
|
||
|
||
<thead>
|
||
<tr>
|
||
<th>版本</th>
|
||
<th>说明</th>
|
||
</tr>
|
||
|
||
</thead>
|
||
|
||
<tbody class="tbody">
|
||
<tr>
|
||
<td>7.2.0</td>
|
||
<td>
|
||
<span class="function"><strong>session_name()</strong></span> 函数会检查会话状态，
|
||
之前的版本仅仅检查 cookie 状态。
|
||
所以，旧版本的 PHP 允许你在调用 <span class="function"><a href="session_start.html" class="function">session_start()</a></span>
|
||
函数之后再调用 <span class="function"><strong>session_name()</strong></span> 函数，
|
||
新版本的 PHP 不再允许这样做了。
|
||
</td>
|
||
</tr>
|
||
|
||
</tbody>
|
||
|
||
</table>
|
||
|
||
</p>
|
||
</div>
|
||
|
||
|
||
<div class="refsect1 seealso" id="refsect1-function.session-name-seealso">
|
||
<h3 class="title">参见</h3>
|
||
<p class="para">
|
||
<ul class="simplelist">
|
||
<li class="member">
|
||
<a href="session.configuration.html#ini.session.name" class="link">session.name</a>
|
||
配置指示
|
||
</li>
|
||
</ul>
|
||
</p>
|
||
</div>
|
||
|
||
|
||
</div></div></div></body></html> |