tomkyle/cookies

1.1.9 2014-04-18 13:03 UTC

This package is auto-updated.

Last update: 2024-09-11 17:47:07 UTC


README

#Cookies

一个轻量级且简单的PHP库,用于处理cookies。

Build Status Scrutinizer Code Quality Coverage Status

##设置cookie

<?php
use \tomkyle\Cookies\Cookie;
use \tomkyle\Cookies\SendCookie;
use \tomkyle\Cookies\UnsetCookie;

// Most simple
$c1 = new Cookie( "foo", "bar" );

// Optionally set expiration:
$c1->setExpiration( new \DateTime( "14day" ));

// Fire cookie:
new SendCookie( $c1 );

// Another example
$c2 = new Cookie( "any", "val", new \DateTime( "tomorrow" ) );
new SendCookie( $c2 );

// Delete from HTTP and $_COOKIE:
new UnsetCookie( $c2 );

##检索cookie

<?php
use \tomkyle\Cookies\Cookie;
use \tomkyle\Cookies\RequestCookie;
use \tomkyle\Cookies\SendCookie;

// Fire cookie:
new SendCookie( new Cookie( "foo", "bar" ) );

// Retrieve cookie from next request:
$rc = new RequestCookie("foo");
echo $rc; // outputs "bar"
echo $rc->getValue(); // outputs "bar"

##通过Composer安装

此库没有依赖。可以通过命令行或composer.json文件进行安装

#####命令行

composer require tomkyle/cookies

#####composer.json "require": { "tomkyle/cookies": "dev-master" }

##类概述

  • 接口 CookieInterface
  • 抽象 CookieAbstract
  • Cookie 继承自 CookieAbstract
  • RequestCookie 继承自 CookieAbstract
  • SendCookie
  • UnsetCookie

##支持的属性

  • Cookie名称
  • Cookie值
  • 过期/有效期
  • 不支持: 路径
  • 不支持: 域名
  • 不支持: 安全(仅HTTPS)
  • 不支持: http-only保护

PHP文档关于setcookie的说明

##测试

简单地执行phpunit来运行测试套件;可能需要先执行composer update