README

Athens/CSRF

轻松防御 CSRF 攻击。

此库已在packagist上发布。要使用Composer安装，请将 "athens/csrf": "0.1.*" 行添加到您的 "require" 依赖项中

{
    "require": {
        ...
        "athens/csrf": "1.*",
        ...
    }
}

当然，如果您不使用Composer，则可以通过右侧的 下载ZIP 按钮下载仓库。

使用此包只需要两行代码

    // Import the CSRF class
    use Athens\CSRF\CSRF;
    
    // Intialize
    CSRF::init();

::init() 方法将自动将隐藏的CSRF令牌字段插入到您的表单中

    <!--output html-->
    ...
    <form>
        <input type=hidden name=csrf_token value=37328bc2cac3e73623bc38ab0f4068ee7fa1>
    ...

此令牌将自动包含在任何表单提交中。

如果您通过AJAX执行表单提交，::init() 还会在您的javascript中插入一个 CSRF_TOKEN 变量

    <!--output html-->
    ...
    <head>
        <script>var CSRFTOKEN = '37328bc2cac3e73623bc38ab0f4068ee7fa1';</script>
    ...

此令牌不会自动包含在您的AJAX请求中，但您可以通过在提交脚本中引用 CSRFTOKEN 变量来手动包含它。

请参阅GitHub 问题跟踪器。

请随意提交pull请求或问题。 GitHub 是此项目的规范位置。

以下是代码贡献的一般顺序