Cookie.class.php 2.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. <?php
  2. namespace KIF;
  3. use KIF\Core\Request;
  4. use KIF\String\Filter;
  5. /**
  6. *
  7. * cookie处理类
  8. * @author gaoxiaogang@gmail.com
  9. *
  10. */
  11. class Cookie {
  12. /**
  13. * 封闭cookie的读操作,便于cookie的统一处理
  14. *
  15. * @param string $key
  16. * @return string | Boolean 不存在返回false;存在返回值
  17. */
  18. static public function get($key, $filters = array(Filter::HTMLSPECIALCHARS, Filter::TRIM)) {
  19. return Request::c($key, $filters);
  20. }
  21. /**
  22. * 包装 php的 setcookie,便于cookie的统一处理
  23. *
  24. * @param string $key cookie名
  25. * @param string $value cookie值
  26. * @param int $expiration cookie过期的时间。 实际发送的值可以是一个Unix时间戳(自1970年1月1日起至失效时间的整型秒数),或者是一个从现在算起的以秒为单位的数字。
  27. * 对于后一种情况,这个秒数不能超过60×60×24×30(30天时间的秒数);如果失效的值大于这个值,会将其作为一个真实的Unix时间戳来处理而不是自当前时间的偏移。
  28. * @param string $cookie_domain 默认为 DOMAIN常量,如未指定,则为 当前访问的根域名
  29. * @param string $cookie_path cookie保存路径,默认为根目录 /
  30. * @param boolean $secure 是否只能通过https协议访问。默认为false
  31. * @param boolean $httponly 是否只能通过http协议读取cookie。值为true时,客户端的javascript不能读到该cookie。默认为false。
  32. * @return boolean
  33. */
  34. static public function set($key, $value, $expiration = 0, $cookie_domain = null, $cookie_path = '/', $secure = false, $httponly = false) {
  35. if (is_null($cookie_domain)) {
  36. if (defined('DOMAIN')) {
  37. $cookie_domain = DOMAIN;
  38. } else {
  39. $cookie_domain = Request::rootDomain();
  40. }
  41. }
  42. if (is_null($cookie_path)) {
  43. $cookie_path = '/';
  44. }
  45. if (is_null($secure)) {
  46. $secure = false;
  47. }
  48. if (is_null($httponly)) {
  49. $httponly = false;
  50. }
  51. # 如果 $expiration 指定的过期时间小于30天,则
  52. if ($expiration > 0 && $expiration <= 60*60*24*30) {
  53. $expiration += time();
  54. }
  55. # 设置 $_COOKIE 变量,否则当前进程写完cookie后是无法立即读取到的。
  56. $_COOKIE[$key] = $value;
  57. return setcookie($key, $value, $expiration, $cookie_path, $cookie_domain, $secure, $httponly);
  58. }
  59. }