# 服务 —— Session
## 1、简介
由于HTTP。
### 1.1 配置
Session配置文件位于`config/session.php`。默认情况下，Laravel使用的`session`驱动为文件驱动，这对许多应用而言是没有什么问题的。在生产环境中，你可能考虑使用`memcached`或者`redis`驱动以便获取更快的session性能。
`session`驱动定义请求的session数据存放在哪里，Laravel可以处理多种类型的驱动：
* `file` – session数据存储在 `storage/framework/sessions`目录下；
* `cookie` – session数据存储在经过加密的安全的cookie中；
* `database` – session数据存储在数据库中
* `memcached` / `redis` – session数据存储在memcached/redis中；
* `array` – session数据存储在简单PHP数组中，在多个请求之间是非持久化的。
> 注意：数组驱动通常用于运行测试以避免session数据持久化。
### 1.2 Session驱动预备知识
### 1.2.1 数据库
当使用`database`session驱动时，需要设置表包含`session`项，下面是该数据表的表结构声明：
~~~
Schema::create('sessions', function ($table) {
$table->string('id')->unique();
$table->text('payload');
$table->integer('last_activity');
});
~~~
你可以使用Artisan命令`session:table`来生成迁移：
~~~
php artisan session:table
composer dump-autoload
php artisan migrate
~~~
### 1.2.2 Redis
在Laravel中使用Redis `session`驱动前，需要通过Composer安装`predis/predis`包。
### 1.3 其它Session相关问题
Laravel框架内部使用`flash` session键，所以你不应该通过该名称添加数据项到session。
如果你需要所有存储的session数据经过加密，在配置文件中设置`encrypt`配置为`true`。
## 2、基本使用
**访问session**
首先，我们来访问session，我们可以通过HTTP请求访问session实例，可以在控制器方法中通过类型提示引入请求实例，记住，控制器方法依赖通过Laravel[服务容器](http://laravelacademy.org/post/93.html)注入：
~~~
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
class UserController extends Controller{
/**
* 显示指定用户的属性
*
* @param Request $request
* @param int $id
* @return Response
*/
public function showProfile(Request $request, $id)
{
$value = $request->session()->get('key');
//
}
}
~~~
从session中获取数据的时候，还可以传递默认值作为第二个参数到`get`方法，默认值在指定键在session中不存在时返回。如果你传递一个闭包作为默认值到`get`方法，该闭包会执行并返回执行结果：
~~~
$value = $request->session()->get('key', 'default');
$value = $request->session()->get('key', function() {
return 'default';
});
~~~
如果你想要从session中获取所有数据，可以使用`all`方法：
~~~
$data = $request->session()->all();
~~~
还可以使用全局的PHP函数`session`来获取和存储session中的数据：
~~~
Route::get('home', function () {
// 从session中获取数据...
$value = session('key');
// 存储数据到session...
session(['key' => 'value']);
});
~~~
**判断session中是否存在指定项**
`has`方法可用于检查数据项在session中是否存在。如果存在的话返回`true`：
~~~
if ($request->session()->has('users')) {
//
}
~~~
**在session中存储数据**
获取到session实例后，就可以调用多个方法来与底层数据进行交互，例如，`put`方法存储新的数据到session中：
~~~
$request->session()->put('key', 'value');
~~~
**推送数据到数组session**
`push` 方法可用于推送数据到值为数组的session，例如，如果`user.teams`键包含团队名数组，可以像这样推送新值到该数组：
~~~
$request->session()->push('user.teams', 'developers');
~~~
**获取并删除数据**
`pull`方法将会从session获取并删除数据：
~~~
$value = $request->session()->pull('key', 'default');
~~~
**从session中删除数据项**
`forget`方法从session中移除指定数据，如果你想要从session中移除所有数据，可以使用`flush`方法：
~~~
$request->session()->forget('key');
$request->session()->flush();
~~~
**重新生成Session ID**
如果你需要重新生成session ID，可以使用`regenerate`方法：
~~~
$request->session()->regenerate();
~~~
### 2.1 一次性数据
有时候你可能想要在session中存储只在下个请求中有效的数据，可以通过`flash`方法来实现。使用该方法存储的session数据只在随后的HTTP请求中有效，然后将会被删除：
~~~
$request->session()->flash('status', 'Task was successful!');
~~~
如果你需要在更多请求中保持该一次性数据，可以使用`reflash`方法，该方法将所有一次性数据保留到下一个请求，如果你只是想要保存特定一次性数据，可以使用`keep`方法：
~~~
$request->session()->reflash();
$request->session()->keep(['username', 'email']);
~~~
## 3、添加自定义Session驱动
要为Laravel后端session添加更多驱动，可以使用Session门面上的`extend`方法。可以在[服务提供者](http://laravelacademy.org/post/91.html)的`boot`方法中调用该方法：
~~~
<?php
namespace App\Providers;
use Session;
use App\Extensions\MongoSessionStore;
use Illuminate\Support\ServiceProvider;
class SessionServiceProvider extends ServiceProvider{
/**
* Perform post-registration booting of services.
*
* @return void
*/
public function boot()
{
Session::extend('mongo', function($app) {
// Return implementation of SessionHandlerInterface...
return new MongoSessionStore;
});
}
/**
* Register bindings in the container.
*
* @return void
*/
public function register()
{
//
}
}
~~~
需要注意的是自定义session驱动需要实现`SessionHandlerInterface`接口，该接口包含少许我们需要实现的方法，一个MongoDB的实现如下：
~~~
<?php
namespace App\Extensions;
class MongoHandler implements SessionHandlerInterface{
public function open($savePath, $sessionName) {}
public function close() {}
public function read($sessionId) {}
public function write($sessionId, $data) {}
public function destroy($sessionId) {}
public function gc($lifetime) {}
}
~~~
由于这些方法并不像缓存的`StoreInterface`接口方法那样容易理解，我们接下来快速过一遍每一个方法：
* `open` 方法用于基于文件的session存储系统，由于Laravel已经有了一个 `file` session 驱动，所以在该方法中不需要放置任何代码，可以将其置为空方法。
* `close` 方法和`open` 方法一样，也可以被忽略，对大多数驱动而言都用不到该方法。
* `read` 方法应该返回与给定$sessionId 相匹配的session数据的字符串版本，从驱动中获取或存储session数据不需要做任何序列化或其它编码，因为Laravel已经为我们做了序列化。
* `write` 方法应该讲给定`$data` 写到持久化存储系统相应的`$sessionId` , 例如MongoDB, Dynamo等等。
* `destroy` 方法从持久化存储中移除 `$sessionId` 对应的数据。
* `gc` 方法销毁大于给定$lifetime 的所有 session数据，对本身拥有过期机制的系统如 Memcached 和Redis而言，该方法可以留空。
session驱动被注册之后，就可以在配置文件`config/session.php`中使用`mongo` 驱动了。
- 前言
- 序言
- 序言 ―― 发行版本说明
- 序言 ―― 升级指南
- 序言 ―― 贡献代码
- 开始
- 开始 ―― 安装及配置
- 开始 ―― Laravel Homestead
- 基础
- 基础 ―― HTTP路由
- 基础 ―― HTTP 中间件
- 基础 ―― HTTP 控制器
- 基础 ―― HTTP 请求
- 基础 ―― HTTP 响应
- 基础 ―― 视图
- 基础 ―― Blade模板
- 架构
- 架构 ―― 一次请求的生命周期
- 架构 ―― 应用目录结构
- 架构 ―― 服务提供者
- 架构 ―― 服务容器
- 架构 ―― 契约
- 架构 ―― 门面
- 数据库
- 数据库 ―― 起步
- 数据库 ―― 查询构建器
- 数据库 ―― 迁移
- 数据库 ―― 填充数据
- Eloquent ORM
- Eloquent ORM ―― 起步
- Eloquent ORM ―― 关联关系
- Eloquent ORM ―― 集合
- Eloquent ORM ―― 调整器
- Eloquent ORM ―― 序列化
- 服务
- 服务 ―― 用户认证
- 服务 ―― Artisan 控制台
- 服务 ―― Laravel Cashier（交易）
- 服务 ―― 缓存
- 服务 ―― 集合
- 服务 ―― Laravel Elixir
- 服务 ―― 加密
- 服务 ―― 错误&日志
- 服务 ―― 事件
- 服务 ―― 文件系统/云存储
- 服务 ―― 哈希
- 服务 ―― 帮助函数
- 服务 ―― 本地化
- 服务 ―― 邮件
- 服务 ―― 包开发
- 服务 ―― 分页
- 服务 ―― 队列
- 服务 ―― Redis
- 服务 ―― Session
- 服务 ―― Envoy 任务运行器（SSH任务）
- 服务 ―― 任务调度
- 服务 ―― 测试
- 服务 ―― 验证