后端电商前端【免费下载链接】CRMEBCRMEB开源商城免费开源多语言商城系统Tp6框架商城系统可商用包含小程序商城、H5商城、公众号商城、PC商城、App支持分销、拼团、砍价、秒杀、优惠券、积分、会员等级、小程序直播、页面DIY前后端分离方便二开更有详细使用文档、接口文档、数据字典、二开文档/视频教程欢迎大家提出宝贵意见和建议项目地址https://gitcode.com/gh_mirrors/cr/CRMEB点击查看免费下载本文以 CRMEB 仓库所携带的 Guzzle 3 文档cookie-plugin.rst为主体结合源码目录crmeb/vendor/guzzle/guzzle/src/Guzzle/Plugin/Cookie/下的真实实现系统讲解 Guzzle 3CookiePlugin的安装与使用、CookieJar 的持久化策略、Cookie 匹配与解析的底层逻辑以及按请求禁用 Cookie 的实战技巧。读完本文你可以完全掌握在 Guzzle 3 客户端中自动携带、接收和保存 Cookie从而无缝维护 HTTP 会话的完整方案并理解其源码级实现原理。插件的作用与适用场景某些 Web 服务需要依赖 Cookie 才能维持会话状态。例如登录后服务器通过Set-Cookie下发会话标识后续请求必须带上该标识才能访问受保护资源。Guzzle 3 提供的Guzzle\Plugin\Cookie\CookiePlugin正是为了解决这个问题它会在请求发出前自动将 CookieJar 中匹配的 Cookie 附加到请求头并在响应返回后自动从响应中解析Set-Cookie并写入 CookieJar。在 Guzzle 3 的插件体系中CookiePlugin与CachePlugin、OauthPlugin等一样通过事件订阅方式挂载到客户端或请求上属于典型的透明代理型插件——业务代码不需要手工拼接Cookie请求头也不需要手工解析Set-Cookie响应头。快速上手三个步骤完成会话保持以原文档crmeb/vendor/guzzle/guzzle/docs/plugins/cookie-plugin.rst给出的示例为基础完整用法如下use Guzzle\Http\Client; use Guzzle\Plugin\Cookie\CookiePlugin; use Guzzle\Plugin\Cookie\CookieJar\ArrayCookieJar; $cookiePlugin new CookiePlugin(new ArrayCookieJar()); // 将 cookie 插件挂载到客户端 $client new Client(http://www.test.com/); $client-addSubscriber($cookiePlugin); // 第一次请求不带任何 Cookie仅解析响应中的 Set-Cookie 存入 CookieJar $client-get(http://www.yahoo.com/)-send(); // 第二次请求CookieJar 中的 Cookie 已被自动附加到请求头 $request $client-get(http://www.yahoo.com/); $request-send(); echo $request;要点说明CookiePlugin的构造函数接收一个CookieJarInterface实例即上面代码中的new ArrayCookieJar()不传参数时默认也会创建一个ArrayCookieJar见CookiePlugin::__construct的默认值逻辑。addSubscriber()将插件注册为客户端的事件订阅者此后该客户端发起的所有请求都会自动经过 Cookie 的取出—发送—解析—存储流程。第二次请求打印出的$request中会带有Cookie: namevalue形式的请求头说明 Cookie 已自动生效。按请求禁用 CookieCookiePlugin 允许对单个请求关闭 Cookie 处理只需在该请求的 params 对象上设置cookies.disable为true$request-getParams()-set(cookies.disable, true);对应源码crmeb/vendor/guzzle/guzzle/src/Guzzle/Plugin/Cookie/CookiePlugin.php的onRequestBeforeSend中第一行判断即if (!$request-getParams()-get(cookies.disable)) { // 移除旧的 Cookie 头然后从 CookieJar 中取出匹配的 Cookie 重新写入 }也就是说cookies.disable仅在请求发送前这一环节生效用于这次请求不带 Cookie的场景例如匿名访问某些公开接口时避免泄露会话。源码级解析CookiePlugin 的事件驱动机制CookiePlugin实现自Symfony\Component\EventDispatcher\EventSubscriberInterface其核心是订阅两个事件事件处理方法优先级职责request.before_sendonRequestBeforeSend125请求发出前将 CookieJar 中匹配的 Cookie 写入请求头request.sentonRequestSent125请求完成后把响应的Set-Cookie解析并存入 CookieJaronRequestBeforeSend的处理逻辑CookiePlugin.php#L49-L59检查cookies.disable若为true则直接跳过先removeHeader(Cookie)移除请求上可能残留的旧 Cookie 头调用$this-cookieJar-getMatchingCookies($request)获取与当前请求匹配的 Cookie 集合逐个$request-addCookie($name, $value)写入。onRequestSent则极其简洁CookiePlugin.php#L66-L69把响应与请求一起交给 CookieJar$this-cookieJar-addCookiesFromResponse($event[response], $event[request]);因此插件的全部智慧其实都沉淀在 CookieJar 与 Cookie 对象中插件本身只是事件的桥梁。CookieJar 家族三种存储策略CookieJar 负责 Cookie 的增删改查、过期清理与匹配筛选。在crmeb/vendor/guzzle/guzzle/src/Guzzle/Plugin/Cookie/CookieJar/目录下共有三个文件CookieJarInterface——统一契约接口定义了持久化 Cookie 的完整能力CookieJarInterface.php主要方法如下方法作用remove($domain, $path, $name)按域、路径、名称精确删除三个参数均可不传不传则清空整个 CookieJarremoveTemporary()丢弃所有临时 Cookie无过期时间或带Discard标记的 CookieremoveExpired()删除所有已过期的 Cookieadd(Cookie $cookie)向 CookieJar 添加一个 Cookie非法时返回falseaddCookiesFromResponse(Response, Request)从响应中解析Set-Cookie并入库getMatchingCookies(Request)取回与请求匹配的 Cookie供插件写入请求头all($domain, $path, $name, $skipDiscardable, $skipExpired)按条件筛选全部 Cookie接口还继承了\Countable与\IteratorAggregate因此 CookieJar 可以直接count()统计数量或用foreach遍历。ArrayCookieJar——内存实现默认ArrayCookieJar是默认的、也是最常用的实现核心特性如下strictMode 严格模式构造函数__construct($strictMode false)默认为关闭。开启后向 CookieJar 添加非法 Cookie如名称为空、包含非法字符会抛出Guzzle\Plugin\Cookie\Exception\InvalidCookieException关闭时则静默忽略非法 Cookie 并返回false。同名冲突消解策略add()方法当新 Cookie 与已有 Cookie 的 path、domain、port、name 完全一致时依次按新 Cookie 非常量且旧的为常量则替换过期时间更靠后则替换值发生变化则替换三种规则决定是否覆盖避免 CookieJar 中堆积重复条目。序列化实现\Serializable接口serialize()只保留长期有效且未过期的 Cookie并以 JSON 格式输出便于持久化与进程间传递。FileCookieJar——文件持久化实现FileCookieJar继承自ArrayCookieJar把 Cookie 持久化到一个JSON 格式文件中构造函数接收文件路径构造时即调用load()从文件中恢复 Cookie__destruct()析构时调用persist()将 Cookie 写回文件非会话 Cookie长期 Cookie与未过期 Cookie 会被保留临时 Cookie 不会落盘。典型用法use Guzzle\Plugin\Cookie\CookieJar\FileCookieJar; // 首次运行时文件不存在或为空会被静默处理之后自动写回 $jar new FileCookieJar(/tmp/guzzle-cookies.json); $plugin new CookiePlugin($jar);这在 CLI 脚本或常驻进程中非常实用进程重启后无需重新登录Cookie 会话可以跨进程复用。需要注意的是文件读写失败权限不足等会抛出Guzzle\Common\Exception\RuntimeException。Cookie 对象数据结构与匹配规则Cookie类crmeb/vendor/guzzle/guzzle/src/Guzzle/Plugin/Cookie/Cookie.php是 CookieJar 中的最小存储单元其默认字段与含义如下字段默认值说明nameCookie 名称valueCookie 值domain所属域名path/生效路径expiresnull过期时间UNIX 时间戳max_age0最大存活秒数comment/comment_urlnull注释信息RFC 2965port[]允许使用的端口列表为空表示不限端口versionnullCookie 规范版本RFC 2965 为 1securefalse是否仅 HTTPS 传输discardfalse是否为会话 Cookie用户代理关闭即丢弃http_onlyfalse是否禁止脚本访问构造时存在两条自动处理规则Cookie.php#L64-L70若没有expires但有max_age则expires time() max_age若expires是非数字字符串则用strtotime()转成时间戳。关键匹配规则matchesPath($path)严格遵循 RFC 6265 的路径匹配——cookie-path 与请求路径完全相同、或 cookie-path 以/结尾且为请求路径前缀、或 cookie-path 是前缀且其后第一个字符为/均视为匹配。matchesDomain($domain)先去掉 cookie 域名前导的.域名为空或完全相等即匹配对 IP 地址直接拒绝子域匹配对普通域名则用正则校验请求域名是否以 cookie 域名为后缀Cookie.php#L450-L466。matchesPort($port)端口列表为空则匹配任意端口否则必须命中列表。isExpired()存在expires且当前时间大于过期时间即视为过期。validate()校验名称、值、域名为空或包含非法字符的情况。非法字符集合来自 RFC 2616 对 token 的定义包括 ASCII 0-32、127 及 ( ) , / : ; ? [ \ ] { }等分隔符Cookie.php#L29-L40。Set-Cookie 解析器响应头到 Cookie 对象的桥梁addCookiesFromResponse并不直接解析字符串而是借助Guzzle\Parser\ParserRegistry注册的 Cookie 解析器crmeb/vendor/guzzle/guzzle/src/Guzzle/Parser/Cookie/CookieParser.php完成转换。解析流程要点将Set-Cookie头按;拆分成多个片段第一个片段必须包含否则整条解析失败返回false后续片段逐一与已知属性名Domain、Path、Max-Age、Expires、Version、Secure、Port、Discard、Comment、Comment-Url、HttpOnly做大小写不敏感匹配命中的写入对应字段未命中的按其出现位置被归为 Cookie 本体或附加数据Port值会按逗号拆成数组Secure等无值片段被解析为布尔true若没有Expires但有Max-Age则expires time() Max-Age若Path缺失或首字符不是/则按 RFC 6265 的默认路径算法从请求 URI 路径推导如请求路径为空或仅含单个/则取/否则截取最后一个/之前的子串解析时若传入了请求的 host 与 path未显式声明Domain的 Cookie 会默认归属到请求域名$data[domain] $host。解析出的多值 Cookie 会被拆分成多个独立的Cookie对象入库见ArrayCookieJar::addCookiesFromResponse。测试用例验证仓库内置的单元测试crmeb/vendor/guzzle/guzzle/tests/Guzzle/Tests/Plugin/Cookie/CookiePluginTest.php从行为层面印证了文档描述的各项能力testExtractsAndStoresCookies验证request.sent事件确实调用 CookieJar 的addCookiesFromResponsetestAddsCookiesToRequests验证request.before_send时匹配到的 Cookie 会写入请求$request-getCookie(foo) bartestCookiesAreExtractedFromRedirectResponses用真实 mock 服务器模拟 302 重定向证明重定向请求与后续请求都会自动携带 Cookietest583551这是会话保持最典型的场景testCookiesAreNotAddedWhenParamIsSet设置cookies.disable true后请求不再携带 Cookie而默认情况下 Cookie 正常发送testProvidesCookieJar验证getCookieJar()能取回构造时注入的 CookieJar 实例。在当前仓库中的位置与版本注意该文档位于 CRMEB 仓库的crmeb/vendor/guzzle/guzzle/docs/plugins/cookie-plugin.rst属于随项目安装的依赖源码。从crmeb/vendor/guzzle/guzzle/composer.json可以看到这份代码对应Guzzle 3replace中声明了guzzle/plugin-cookie等同名包并且官方已明确标注 This library is deprecated in favor of guzzlehttp/guzzle。而 CRMEB 主项目crmeb/composer.json中实际依赖的是guzzlehttp/guzzle6.5.5现代命名空间GuzzleHttp说明vendor/guzzle/guzzle下的 Guzzle 3 组件主要是作为历史兼容依赖被携带进来属于被动安装的第三方代码。因此本文所述 API 适用于Guzzle 3 旧版类命名空间Guzzle\Plugin\Cookie\...在使用前应先确认你操作的是 Guzzle 3 还是 Guzzle 6若在 CRMEB 业务代码中调用 HTTP 请求实际走的是GuzzleHttp\ClientGuzzle 6的体系其 Cookie 机制由CookieJarInterface与CookieJar类位于guzzlehttp/guzzle的src/Cookie/目录提供但**请求前取出匹配 Cookie、响应后解析 Set-Cookie 存入**的设计思路与本文一致生产环境建议以项目composer.json锁定的 Guzzle 版本为准并留意 Guzzle 3 已停止维护的事实。小结CookiePlugin是 Guzzle 3 中维护 HTTP 会话的最简方案一行addSubscriber注册后续所有请求自动完成 Cookie 的取出、发送、解析与存储。其能力边界由三部分决定——CookiePlugin事件桥梁、CookieJar存储与筛选策略可选内存数组或 JSON 文件持久化、Cookie CookieParser数据结构与 Set-Cookie 解析。在具体项目中你既可以直接复用ArrayCookieJar完成进程内会话保持也可以通过FileCookieJar让会话跨越进程生命周期还可以用cookies.disable对单个请求精确关闭 Cookie 行为。赞分享后端电商前端【免费下载链接】CRMEBCRMEB开源商城免费开源多语言商城系统Tp6框架商城系统可商用包含小程序商城、H5商城、公众号商城、PC商城、App支持分销、拼团、砍价、秒杀、优惠券、积分、会员等级、小程序直播、页面DIY前后端分离方便二开更有详细使用文档、接口文档、数据字典、二开文档/视频教程欢迎大家提出宝贵意见和建议项目地址https://gitcode.com/gh_mirrors/cr/CRMEB点击查看免费下载相关推荐Guzzle cookie管理详解CookieJar与会话持久化方案Guzzle cookie管理详解CookieJar与会话持久化方案 在Web开发中HTTP Cookie小型文本文件扮演着维持用户会话、存储用户偏好设后端仓颉 stdx.net.http Cookie 实战基于 CookieJar 的自动会话状态管理仓颉 stdx.net.http Cookie 实战基于 CookieJar 的自动会话状态管理 导读 HTTP 协议本身是无状态的而 Web 应用中登录态标准库网络密码学并发编程企业级文档在线预览解决方案kkFileView技术架构与实施实践企业级文档在线预览解决方案kkFileView技术架构与实施实践 在数字化转型浪潮中企业面临着海量文档在线预览的技术挑战。传统方案存在格式兼容性差、部署复杂后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考