ThinkPHP怎么设置语言Cookie有效期-php教程-PHP中文网

thinkphp设置语言cookie需用cookie::set()明确传入过期时间（秒），推荐30天并设path='/'、secure/httponly为true；读取时用cookie::get()配合app()->setlocale()生效。

thinkphp怎么设置语言cookie有效期

ThinkPHP 设置语言 Cookie 的有效期，核心是用 Cookie::set() 方法并明确传入过期时间参数，同时确保语言标识值安全、路径和域名作用域合理。

直接设置带有效期的语言 Cookie

最常用写法是：

use think\facade\Cookie;

// 设置语言为 'zh-cn'，有效期 7 天（604800 秒）
Cookie::set('lang', 'zh-cn', 604800);

// 或使用数组方式，更清晰控制各项参数
Cookie::set('lang', 'en-us', [
    'expire' => 3600,      // 1 小时
    'path'   => '/',       // 全站有效
    'domain' => '.yourdomain.com', // 跨子域共享（注意开头的点）
    'secure' => true,       // 仅 HTTPS 传输（生产环境建议开启）
    'httponly' => true,     // 禁止 JS 访问，防 XSS
    'prefix' => 'tp_'       // 可选：避免与其他系统 Cookie 冲突
]);

关键细节说明

PHP

编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

过期时间单位是秒，不是时间戳。例如 86400 表示 1 天，time() + 86400 是错误写法（ThinkPHP 会自动处理，传整数秒即可）。
若不传有效期，默认为 会话级 Cookie（浏览器关闭即失效），不适合语言偏好持久化。
path 建议设为 '/'，否则可能在某些子路径下读不到语言设置。
domain 若需跨子域（如 admin.yourdomain.com 和 www.yourdomain.com 共享语言），必须写成 '.yourdomain.com'（开头带点）。
secure 和 httponly 在生产环境应设为 true，尤其当站点启用 HTTPS 时。

配合多语言切换的实际用法

// 用户点击切换语言时执行
public function setLang($lang = 'zh-cn')
{
    // 校验语言代码是否合法（如只允许 zh-cn / en-us / ja-jp）
    $allowed = ['zh-cn', 'en-us', 'ja-jp', 'ko-kr'];
    if (!in_array($lang, $allowed)) {
        $lang = 'zh-cn';
    }

    Cookie::set('lang', $lang, [
        'expire' => 86400 * 30, // 30 天
        'path'   => '/',
        'domain' => config('app.cookie_domain') ?: '',
        'secure' => request()->isSsl(),
        'httponly' => true,
        'samesite' => 'Lax'
    ]);

    return redirect()->back();
}

读取语言 Cookie 并应用到系统

// 在中间件或基础控制器中
$lang = Cookie::get('lang', '', 'tp_'); // 若用了 prefix，记得传第三个参数
if ($lang && in_array($lang, ['zh-cn', 'en-us'])) {
    app()->setLocale($lang);
}

不复杂但容易忽略。