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()也会将CSRF_TOKEN变量插入到您的javascript中

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

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

请参阅GitHub 问题跟踪器。

请随时提交拉取请求或问题。 GitHub 是此项目的官方位置。

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