<?php
|
/**
|
* PhalApi_Cookie COOKIE操作
|
*
|
* - 原生态COOKIE操作的简单封装
|
* - 注意，设置的COOKIE需要在下一次才能生效
|
*
|
* <br>使用示例：<br>
|
```
|
* //COOKIE
|
* DI()->cookie = 'PhalApi_Cookie';
|
*
|
* //设置COOKIE服务
|
* DI()->cookie->set('name', 'phalapi', $_SERVER['REQUEST_TIME'] + 600);
|
*
|
* //获取
|
* echo DI()->cookie->get('name'); //输出 phalapi
|
*
|
* //删除
|
* DI()->cookie->delete('name');
|
*
|
```
|
* @package PhalApi\Cookie
|
* @license http://www.phalapi.net/license GPL 协议
|
* @link http://www.phalapi.net/
|
* @author dogstar <chanzonghuang@gmail.com> 2015-04-11
|
*/
|
|
class PhalApi_Cookie {
|
|
/**
|
* COOKIE配置
|
*/
|
protected $config = array();
|
|
/**
|
* @param string $config['path'] 路径
|
* @param string $config['domain'] 域名
|
* @param boolean $config['secure'] 是否加密
|
* @param boolean $config['httponly'] 是否只HTTP协议
|
* @link http://php.net/manual/zh/function.setcookie.php
|
*/
|
public function __construct($config = array()) {
|
$this->config['path'] = isset($config['path']) ? $config['path'] : NULL;
|
$this->config['domain'] = isset($config['domain']) ? $config['domain'] : NULL;
|
$this->config['secure'] = isset($config['secure']) ? $config['secure'] : FALSE;
|
$this->config['httponly'] = isset($config['httponly']) ? $config['httponly'] : FALSE;
|
}
|
|
/**
|
* 获取COOKIE
|
*
|
* @param string $name 待获取的COOKIE名字
|
* @return string/NULL/array $name为NULL时返回整个$_COOKIE，存在时返回COOKIE，否则返回NULL
|
*/
|
public function get($name = NULL) {
|
if ($name === NULL) {
|
return $_COOKIE;
|
}
|
|
return isset($_COOKIE[$name]) ? $_COOKIE[$name] : NULL;
|
}
|
|
/**
|
* 设置COOKIE
|
*
|
* @param string $name 待设置的COOKIE名字
|
* @param string/int $value 建议COOKIE值为一些简单的字符串或数字，不推荐存放敏感数据
|
* @param int $expire 有效期的timestamp，为NULL时默认存放一个月
|
* @param boolean
|
*/
|
public function set($name, $value, $expire = NULL) {
|
if ($expire === NULL) {
|
$expire = $_SERVER['REQUEST_TIME'] + 2592000; //a month
|
}
|
|
return setcookie(
|
$name,
|
$value,
|
$expire,
|
$this->config['path'],
|
$this->config['domain'],
|
$this->config['secure'],
|
$this->config['httponly']
|
);
|
}
|
|
/**
|
* 删除COOKIE
|
*
|
* @param strint $name 待删除的COOKIE名字
|
* @param boolean
|
* @see PhalApi_Cookie::set()
|
*/
|
public function delete($name) {
|
return $this->set($name, '', 0);
|
}
|
|
/**
|
* 获取COOKIE的配置
|
*/
|
public function getConfig() {
|
return $this->config;
|
}
|
}
|
