# 使用 Session 存储数据（Storing data in Session）
会话组件组件提供了一种面向对象的方式访问session数据。
使用这个组件替代原生session的原因如下:
* 在相同域名下的不同应用程序之间，你可以非常容易的隔离session数据
* Intercept where session data is set/get in your application
* 根据应用程序的需要，可以非常方便的更换session适配器
## 启动会话（Starting the Session）
Some applications are session-intensive, almost any action that performs requires access to session data. There are others who access session data casually. Thanks to the service container, we can ensure that the session is accessed only when it’s clearly needed:
~~~
<?php
use Phalcon\Session\Adapter\Files as Session;
// Start the session the first time when some component request the session service
$di->setShared(
"session",
function () {
$session = new Session();
$session->start();
return $session;
}
);
~~~
## Session 的存储与读取（Storing/Retrieving data in Session）
控制器，视图或者任何继承于[Phalcon\\Di\\Injectable](http://docs.iphalcon.cn/api/Phalcon_Di_Injectable.html)的组件，都可以访问session服务。 如下示例介绍了session的存储与读取操作:
~~~
<?php
use Phalcon\Mvc\Controller;
class UserController extends Controller
{
public function indexAction()
{
// 设置一个session变量
$this->session->set("user-name", "Michael");
}
public function welcomeAction()
{
// 检查session变量是否已定义
if ($this->session->has("user-name")) {
// 获取session变量的值
$name = $this->session->get("user-name");
}
}
}
~~~
## Sessions 的删除和销毁（Removing/Destroying Sessions）
你也可以删除某个session变量，或者销毁全部session会话:
~~~
<?php
use Phalcon\Mvc\Controller;
class UserController extends Controller
{
public function removeAction()
{
// 删除session变量
$this->session->remove("user-name");
}
public function logoutAction()
{
// 销毁全部session会话
$this->session->destroy();
}
}
~~~
## 隔离不同应用的会话数据（Isolating Session Data between Applications）
Sometimes a user can use the same application twice, on the same server, in the same session. Surely, if we use variables in session, we want that every application have separate session data (even though the same code and same variable names). To solve this, you can add a prefix for every session variable created in a certain application:
~~~
<?php
use Phalcon\Session\Adapter\Files as Session;
// Isolating the session data
$di->set(
"session",
function () {
// All variables created will prefixed with "my-app-1"
$session = new Session(
[
"uniqueId" => "my-app-1",
]
);
$session->start();
return $session;
}
);
~~~
Adding a unique ID is not necessary.
## 会话袋（Session Bags）
[Phalcon\\Session\\Bag](http://docs.iphalcon.cn/api/Phalcon_Session_Bag.html)is a component that helps separating session data into “namespaces”. Working by this way you can easily create groups of session variables into the application. By only setting the variables in the “bag”, it’s automatically stored in session:
~~~
<?php
use Phalcon\Session\Bag as SessionBag;
$user = new SessionBag("user");
$user->setDI($di);
$user->name = "Kimbra Johnson";
$user->age = 22;
~~~
## 组件的持久数据（Persistent Data in Components）
Controller, components and classes that extends[Phalcon\\Di\\Injectable](http://docs.iphalcon.cn/api/Phalcon_Di_Injectable.html)may inject a[Phalcon\\Session\\Bag](http://docs.iphalcon.cn/api/Phalcon_Session_Bag.html). This class isolates variables for every class. Thanks to this you can persist data between requests in every class in an independent way.
~~~
<?php
use Phalcon\Mvc\Controller;
class UserController extends Controller
{
public function indexAction()
{
// Create a persistent variable "name"
$this->persistent->name = "Laura";
}
public function welcomeAction()
{
if (isset($this->persistent->name)) {
echo "Welcome, ", $this->persistent->name;
}
}
}
~~~
In a component:
~~~
<?php
use Phalcon\Mvc\Controller;
class Security extends Component
{
public function auth()
{
// Create a persistent variable "name"
$this->persistent->name = "Laura";
}
public function getAuthName()
{
return $this->persistent->name;
}
}
~~~
The data added to the session (`$this->session`) are available throughout the application, while persistent (`$this->persistent`) can only be accessed in the scope of the current class.
## 自定义适配器（Implementing your own adapters）
The[Phalcon\\Session\\AdapterInterface](http://docs.iphalcon.cn/api/Phalcon_Session_AdapterInterface.html)interface must be implemented in order to create your own session adapters or extend the existing ones.
There are more adapters available for this components in the[Phalcon Incubator](https://github.com/phalcon/incubator/tree/master/Library/Phalcon/Session/Adapter)
- 简介
- 安装
- 安装(installlation)
- XAMPP下的安装
- WAMP下安装
- Nginx安装说明
- Apache安装说明
- Cherokee 安装说明
- 使用 PHP 内置 web 服务器
- Phalcon 开发工具
- Linux 系统下使用 Phalcon 开发工具
- Mac OS X 系统下使用 Phalcon 开发工具
- Windows 系统下使用 Phalcon 开发工具
- 教程
- 教程 1：让我们通过例子来学习
- 教程 2：INVO简介
- 教程 3: 保护INVO
- 教程4: 使用CRUD
- 教程5: 定制INVO
- 教程 6: Vökuró
- 教程 7：创建简单的 REST API
- 组件
- 依赖注入与服务定位器
- MVC架构
- 使用控制器
- 使用模型
- 模型关系
- 事件与事件管理器
- Behaviors
- 模型元数据
- 事务管理
- 验证数据完整性
- Workingwith Models
- Phalcon查询语言
- 缓存对象关系映射
- 对象文档映射 ODM
- 使用视图
- 视图助手
- 资源文件管理
- Volt 模版引擎
- MVC 应用
- 路由
- 调度控制器
- Micro Applications
- 使用命名空间
- 事件管理器
- Request Environmen
- 返回响应
- Cookie 管理
- 生成 URL 和 路径
- 闪存消息
- 使用 Session 存储数据
- 过滤与清理
- 上下文编码
- 验证Validation
- 表单_Forms
- 读取配置
- 分页 Pagination
- 使用缓存提高性能
- 安全
- 加密与解密 Encryption/Decryption
- 访问控制列表
- 多语言支持
- 类加载器 Class Autoloader
- 日志记录_Logging
- 注释解析器 Annotations Parser
- 命令行应用 Command Line Applications
- Images
- 队列 Queueing
- 数据库抽象层
- 国际化
- 数据库迁移
- 调试应用程序
- 单元测试
- 进阶技巧与延伸阅读
- 提高性能：下一步该做什么？
- Dependency Injection Explained
- Understanding How Phalcon Applications Work
- Api
- Abstract class Phalcon\Acl