CakePHP 4版本中如何实现Cookie值全局使用？

现有代码错误点 #

• 设置Cookie时传错变量：实例化Cookie对象的变量为$cookies，但调用withCookie()时传入了未定义的$cookie，导致Cookie未被正确写入响应
• 重定向未携带修改后的响应对象：设置完Cookie的响应对象没有传入重定向方法，CakePHP会使用原始响应返回，Cookie直接丢失
• 读取Cookie时实例化了空的CookieCollection：Cookie需要从当前请求对象中读取，新实例化的集合没有任何现有Cookie数据
• 读取键名不匹配：设置的Cookie名称为AuthAdmin，后续读取时误写为Auth.Admin，无法匹配到对应值

修复后代码 #

use App\Controller\AppController;
use Cake\Http\Cookie\Cookie;
use DateTime;

class AdminController extends AppController
{
    public function index()
    {
        // 获取请求提交的表单数据，补充原代码缺失的数据源定义
        $requestData = $this->request->getData();
        $cookiePayload = [
            'admin_username' => $requestData['username'],
            'admin_password' => $requestData['password']
        ];
        // 实例化Cookie对象
        $authCookie = new Cookie('AuthAdmin', $cookiePayload, new DateTime('+1 weeks'));
        // 写入Cookie到响应
        $response = $this->response->withCookie($authCookie);
        // 重定向时携带响应对象，将Cookie返回给浏览器
        return $this->redirect('admin/viewusers', 302, $response);
    }

    public function viewusers()
    {
        // 直接从请求中读取指定Cookie，最简便的读取方式
        $authData = $this->request->getCookie('AuthAdmin');
        print_r($authData);

        // 若需要通过CookieCollection操作，从当前请求中获取已有集合
        $cookieCollection = $this->request->getCookieCollection();
        $authCookieObj = $cookieCollection->get('AuthAdmin');
        // 从Cookie对象中提取存储的数组数据
        print_r($authCookieObj?->getValue());
    }
}

安全与配置注意事项 #

• 禁止明文存储用户密码到Cookie，该操作存在极高安全风险，推荐直接使用CakePHP官方提供的Authentication组件实现后台登录校验
• 若项目全局配置了Cookie的有效域名、路径、加密规则，需保证实例化Cookie时传入的对应参数和全局配置一致，否则会出现跨域、跨路径无法读取的问题
• CakePHP默认开启Cookie自动加密，写入和读取无需手动处理加密解密逻辑

内容的提问来源于stack exchange，提问作者developer