bayfrontmedia/php-cookies

一个易于操作cookie的辅助类。

v2.0.0 2023-01-26 18:02 UTC

This package is auto-updated.

Last update: 2024-08-26 21:24:05 UTC


README

一个易于且安全地操作cookie的辅助类。

许可证

该项目是开源的,可在MIT许可证下获取。

作者

Bayfront Media

要求

  • PHP ^8.0

安装

composer require bayfrontmedia/php-cookies

使用

获取

描述

返回单个 $_COOKIE 数组键的值或整个数组,可选默认值。

参数

  • $key = NULL (string|null)
  • $default = NULL (mixed): 如果数组键不存在,则返回默认值

返回

  • (mixed)

示例

use Bayfront\Cookies\Cookie;

print_r(Cookie::get());

存在

描述

检查 $_COOKIE 数组键是否存在。

参数

  • $key (string)

返回

  • (bool)

示例

use Bayfront\Cookies\Cookie;

if (Cookie::has('cart_id')) {
    // Do something
}

设置

描述

创建一个cookie。

参见:https://php.ac.cn/manual/en/function.setcookie.php

参数

  • $name (string): Cookie名称
  • $value (string): Cookie值
  • $minutes = 0 (int): 从现在起直到cookie过期的时间(分钟)
  • $path = '/' (string): 服务器上的路径,在该路径中cookie将可用
  • $domain = '' (string): cookie可用的域名/子域名
  • $secure = true (bool): 仅通过安全的https连接传输cookie
  • $http_only = true (bool): 仅通过http协议访问
  • $same_site = 'Lax' (string): 可接受的值为 NoneLaxStrict

返回

  • (bool)

示例

use Bayfront\Cookies\Cookie;

Cookie::set('cart_id', 'abc123', 60);

忘记

描述

移除cookie的有效性。

参数

  • $name (string)

返回

  • (void)

示例

use Bayfront\Cookies\Cookie;

Cookie::forget('cart_id');

忘记所有

描述

移除所有cookie的有效性。

参数

返回

  • (void)

示例

use Bayfront\Cookies\Cookie;

Cookie::forgetAll();