ThinkPHP的CSRF防护怎么做？ThinkPHP如何生成Token？-ThinkPHP-PHP中文网

ThinkPHP的CSRF防护怎么做？ThinkPHP如何生成Token？

小老鼠

发布： 2025-07-18 20:43:01

原创

215人浏览过

thinkphp的csrf防护通过生成并验证唯一令牌实现。具体步骤如下：1.启用会话，配置中间件以支持token存储；2.在视图中使用{{ token() }}生成隐藏域，自动添加__token__字段；3.后端自动验证post/put/delete请求中的token，不匹配则抛出异常；4.ajax请求需手动获取token并添加至请求头或请求体；5.thinkphp在会话中生成并管理token，确保其与用户会话绑定；6.应对页面缓存问题，避免缓存表单页或动态注入token；7.ajax中可通过meta标签存储token便于javascript读取；8.token过期或刷新时，采用双重提交或提示用户刷新页面；9.特定路由可通过csrf(false)豁免验证，但需确保其他安全措施；10.结合samesite cookie策略、referer检查、自定义请求头、双重提交cookie、用户交互确认及验证码等手段增强防护。这些机制共同保障应用免受csrf攻击。

ThinkPHP的CSRF防护怎么做？ThinkPHP如何生成Token？

ThinkPHP的CSRF防护，核心在于通过生成和验证一个唯一的、临时的令牌（Token）来确保请求的合法性。当你需要在表单提交或AJAX请求中防止跨站请求伪造攻击时，ThinkPHP提供了一套相对成熟且易于集成的机制。简单来说，就是前端页面带上一个服务器生成的秘密字符串，后端接收到请求时再验证这个字符串是否匹配。

ThinkPHP的CSRF防护怎么做？

要实现ThinkPHP的CSRF防护，你通常需要确保你的应用启用了会话（Session），因为Token是基于会话存储的。在ThinkPHP 6.0及以上版本中，通常通过middleware.php配置会话初始化中间件。一旦会话启用，你就可以在视图层和控制器层使用内置的方法来生成和验证Token。

立即学习“PHP免费学习笔记（深入）”；

在视图模板中，你只需要在表单内部添加一个隐藏域，ThinkPHP提供了非常便捷的模板函数{{ token() }}来自动生成这个隐藏域，它会包含一个名为__token__的输入框，其值为当前会话对应的CSRF Token。例如：

<form method="post" action="/submit_data">
    {{ token() }}
    <input type="text" name="data" value="">
    <button type="submit">提交</button>
</form>

登录后复制

当表单提交时，这个__token__字段会随表单数据一起发送到服务器。在后端，ThinkPHP会自动对POST、PUT、DELETE等请求方法进行CSRF Token的验证。如果你使用了Request对象来获取请求数据，并且没有手动关闭CSRF验证，那么当Token不匹配或缺失时，系统会自动抛出InvalidTokenException异常。

对于AJAX请求，情况稍微复杂一点。因为AJAX请求通常不直接提交表单，你需要手动获取Token并将其添加到请求头或请求体中。你可以通过JavaScript获取页面中隐藏的__token__值，或者通过一个专门的API接口来获取Token。获取到Token后，你可以将其作为请求头（例如X-CSRF-TOKEN）或者作为请求体中的一个参数发送。

例如，获取页面中的Token：

// 获取页面中的CSRF Token
const csrfToken = document.querySelector('input[name="__token__"]').value;

// 使用Fetch API发送AJAX请求
fetch('/api/submit_data', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-CSRF-TOKEN': csrfToken // 将Token添加到请求头
    },
    body: JSON.stringify({ data: 'your_data' })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

登录后复制

ThinkPHP如何生成Token？

ThinkPHP生成Token的过程是基于会话的。当你首次在模板中使用{{ token() }}函数，或者在控制器中调用Request::token()方法时，ThinkPHP会检查当前会话中是否存在一个有效的CSRF Token。如果不存在，它就会生成一个随机字符串，将其存储在当前用户的会话中，并返回这个字符串。这个字符串就是我们所说的CSRF Token。

具体来说，这个Token通常是一个经过哈希处理的随机字符串，并且与当前用户的会话ID相关联。这意味着每个用户的每个会话都会有一个独立的Token。当表单提交时，后端会从请求中获取__token__的值，然后与会话中存储的Token进行比对。如果两者一致，请求就被认为是合法的；否则，就被视为潜在的CSRF攻击。

ThinkPHP在内部管理着Token的生命周期，它会确保Token的唯一性和有效性。通常情况下，Token会跟随会话的生命周期，或者在某些配置下，每次请求后都会刷新。我个人认为，这种自动化的管理方式极大地简化了开发者的工作，你不需要手动去生成复杂的随机数并管理它们的存储。

CSRF防护的常见坑点与应对策略

实际操作中，CSRF防护虽然重要，但也会遇到一些让人头疼的问题，特别是那些不熟悉其工作原理的开发者。

uBrand Logo生成器

uBrand Logo生成器是一款强大的AI智能LOGO设计工具。

查看详情

一个非常常见的“坑”是页面缓存问题。如果你的页面启用了静态缓存，而页面中又包含了{{ token() }}生成的Token，那么所有用户访问到的都可能是同一个过期的Token。当用户提交表单时，这个Token会因为与服务器会话中的Token不匹配而导致验证失败。应对这种问题，最直接的方法是不要缓存包含表单的页面。或者，如果你必须缓存，那么Token的生成需要动态化，比如通过AJAX请求一个独立的Token接口，或者在页面加载完成后用JavaScript动态注入Token。我通常倾向于前者，即不缓存表单页面，或者使用服务端渲染（SSR）确保Token的实时性。

AJAX请求中的Token管理也是一个痛点。正如前面提到的，你需要手动获取Token并将其添加到请求中。如果你的前端是单页应用（SPA），可能需要一个全局的机制来管理Token。一种常见的做法是在页面加载时将Token存储在JavaScript变量中，或者将其放在HTML的meta标签中，方便JavaScript读取。例如：

<meta name="csrf-token" content="{{ token() }}">

登录后复制

然后JavaScript可以这样获取：

const csrfToken = document.querySelector('meta[name="csrf-token"]').getAttribute('content');

登录后复制

Token的过期或刷新机制也值得关注。默认情况下，ThinkPHP的Token通常与会话生命周期绑定。如果用户长时间不操作，会话过期，Token自然失效。但更复杂的情况是，如果用户在多个浏览器标签页中打开了同一个表单，当其中一个标签页提交成功后，服务器可能会刷新Token，导致其他标签页中的Token失效。这会导致用户在其他标签页提交时遇到“Token过期”的错误。对于这种场景，ThinkPHP通常采用的是“双重提交”或“单次使用Token”策略。对于单次使用Token，你可以考虑在Token验证失败时，给用户一个友好的提示，并引导他们刷新页面。我个人觉得，对于用户体验来说，在Token失效时提供清晰的反馈比直接抛出错误更重要。

最后，特定路由的CSRF豁免。有些API接口，特别是那些期望接收JSON数据而不是表单数据的接口，或者第三方服务回调接口，可能不需要CSRF防护。在ThinkPHP中，你可以通过在路由定义时指定csrf(false)来关闭特定路由的CSRF验证，或者在中间件配置中排除某些路径。但这里要特别小心，确保你真正理解关闭CSRF的风险，并且该接口有其他安全措施（如API密钥、签名验证等）。

除了Token，还有哪些增强CSRF防护的手段？

虽然Token是CSRF防护的核心，但它并非唯一的解决方案。结合其他策略，可以构建更坚固的防线。

SameSite Cookie策略是一个非常重要的补充。这是浏览器层面的安全机制，通过设置Cookie的SameSite属性（如Lax或Strict），可以限制第三方网站发送带有你的网站Cookie的请求。当设置为Strict时，只有同站请求才会发送Cookie，这几乎完全阻止了CSRF攻击，但可能会影响一些跨站链接跳转时的用户体验。Lax模式则是一个更平衡的选择，它允许顶级导航和GET请求发送Cookie，而POST请求则会被阻止。我个人建议，在ThinkPHP中，确保你的会话Cookie设置了合适的SameSite属性，这在现代浏览器中已经成为标配，并且能显著提升安全性。

Referer头部检查虽然不是绝对可靠，但可以作为辅助手段。通过检查HTTP请求的Referer头部，判断请求是否来源于你的网站。但请注意，Referer头部可以被伪造，或者在某些隐私设置下不发送，所以它不能作为唯一的防护手段。但作为一道额外的屏障，它仍然有其价值。

自定义请求头或双重提交Cookie对于API接口来说尤其有用。除了Token，你可以在AJAX请求中添加一个自定义的HTTP头部，例如X-Requested-With: XMLHttpRequest，并在后端验证这个头部。虽然这不能完全阻止CSRF，但可以增加攻击难度。更高级的做法是“双重提交Cookie”模式，即Token不存储在服务器会话中，而是由客户端生成并存储在Cookie中，同时在请求体中也包含这个Token，服务器只比对这两个Token是否一致。这种方式对于无状态的API尤其适用。

对于高风险操作，例如修改密码、绑定银行卡等，可以考虑增加用户交互确认。比如，在提交前要求用户重新输入密码，或者通过短信/邮件验证码进行二次确认。这虽然会增加用户操作步骤，但对于敏感操作来说，是值得的。

最后，验证码（CAPTCHA/reCAPTCHA）也是一种有效的辅助手段，尤其是在用户登录或进行关键操作时。它增加了攻击的自动化难度，但同样会影响用户体验。在我看来，应该根据操作的敏感程度来权衡是否使用验证码。

将这些方法结合起来，可以为你的ThinkPHP应用提供多层次的CSRF防护，让你的应用在面对各种潜在威胁时更加健壮。

以上就是ThinkPHP的CSRF防护怎么做？ThinkPHP如何生成Token？的详细内容，更多请关注php中文网其它相关文章！