README

由Evan Coury和ZF-Commons团队创建

介绍

ZfcUser是Zend Framework 2的用户注册和认证模块。默认情况下，ZfcUser与Zend\Db一起工作，但也可以安装其他存储适配器模块（见下文）。ZfcUser为在ZF2网站上添加用户认证和注册提供了基础。它设计得非常简单，易于扩展。

更多信息和示例请参见ZfcUser Wiki

存储适配器模块

默认情况下，ZfcUser支持使用Zend\Db持久化用户。然而，通过安装可选的替代存储适配器模块，您可以利用其他持久化用户的方法。

ZfcUserDoctrineORM - Doctrine2 ORM
ZfcUserDoctrineMongoODM - Doctrine2 MongoDB ODM

要求

Zend Framework 2 (最新master版本)
ZfcBase (最新master版本)。

特性/目标

通过用户名、电子邮件或两者（可以选择放弃用户名，仅使用电子邮件）进行认证[已完成]
用户注册[已完成]
表单防护CSRF[已完成]
默认支持Doctrine2 和 Zend\Db[已完成]
注册表单使用CAPTCHA进行保护[进行中]（需要更多选项）
强大的事件系统，允许扩展[进行中]
通过插件支持额外的认证机制（Google、Facebook、LDAP等）[未完成]
可选的电子邮件地址验证[未完成]
忘记密码[未完成]
提供ActionController插件和视图辅助工具[未完成]

安装

主要设置

通过克隆项目

通过克隆到./vendor/中安装ZfcBase ZF2模块。
将此项目克隆到您的./vendor/目录中。

使用composer

在您的composer.json中添加此项目和ZfcBase。

"require": {
    "zf-commons/zfc-user": "dev-master"
}

现在运行以下命令让composer下载ZfcUser：
```
$ php composer.phar update
```

安装后

在application.config.php文件中启用它。

<?php
return array(
    'modules' => array(
        // ...
        'ZfcBase',
        'ZfcUser',
    ),
    // ...
);

然后导入位于./vendor/zf-commons/zfc-user/data/schema.sql（如果您使用Composer安装）或./vendor/ZfcUser/data/schema.sql中的SQL模式。

安装后：Doctrine2 ORM

即将推出...

安装后：Doctrine2 MongoDB ODM

即将推出...

安装后：Zend\Db

如果您在服务管理器配置中没有有效的Zend\Db\Adapter\Adapter，请在./config/autoload/database.local.php中添加以下内容：

<?php
return array(
    'db' => array(
        'driver'    => 'PdoMysql',
        'hostname'  => 'changeme',
        'database'  => 'changeme',
        'username'  => 'changeme',
        'password'  => 'changeme',
    ),
    'service_manager' => array(
        'factories' => array(
            'Zend\Db\Adapter\Adapter' => 'Zend\Db\Adapter\AdapterServiceFactory',
        ),
    ),
);

导航到http://yourproject/user，您应该会进入登录页面。

密码安全性

不要更改密码哈希设置为其默认值，除非A）您已进行充分的研究并完全理解您正在更改的内容，并且B）您有非常具体的理由要从默认设置中偏离。

如果您计划更改默认密码哈希设置，请阅读以下内容：

密码哈希设置可以随时更改，而不会使现有用户帐户失效。现有用户密码将在下次成功登录时自动重新哈希。

警告：更改默认密码哈希设置可能会导致严重问题，例如使哈希密码更容易受到暴力破解攻击，或者使哈希变得非常昂贵，以至于用户登录和注册速度过慢，给服务器带来巨大负担。提供的默认设置在这两者之间提供了非常合理的平衡，适合2013年的计算能力。

选项

ZfcUser模块提供了一些选项，允许您快速自定义基本功能。安装ZfcUser后，将./vendor/zf-commons/zfc-user/config/zfcuser.global.php.dist复制到./config/autoload/zfcuser.global.php，并根据需要更改值。

以下选项可用：

user_entity_class - 要使用的实体类名称。如果您想使用自己的实体类而不是默认提供的类，则非常有用。默认值为ZfcUser\Entity\User。
enable_username - 布尔值，启用注册表单上的用户名字段。默认值为false。
auth_identity_fields - 数组值，指定用户在登录时可以使用的“身份”字段。可接受值：用户名、电子邮件。
enable_display_name - 布尔值，在注册表单上启用显示名称字段。默认值是false。
enable_registration - 布尔值，确定是否允许用户注册。默认值是true。
login_after_registration - 布尔值，在用户成功注册后自动登录。默认值是false。
use_registration_form_captcha - 布尔值，确定是否在用户注册表单上使用验证码。默认值是true。（注意，目前这仅使用弱Zend\Text\Figlet验证码，但我有计划使所有Zend\Captcha适配器都能工作。）
login_form_timeout - 整数值，指定登录表单的CSRF安全字段的超时时间（秒）。默认值是300秒。
user_form_timeout - 整数值，指定注册表单的CSRF安全字段的超时时间（秒）。默认值是300秒。
use_redirect_parameter_if_present - 布尔值，如果指定了重定向GET参数，则用户在认证成功后将被重定向到指定的URL（如果存在，则GET参数将覆盖下面指定的login_redirect_route）。
login_redirect_route 字符串值，指定在应用程序中用户成功登录后将被重定向到的路由名称。
logout_redirect_route 字符串值，指定在应用程序中用户注销后将被重定向到的路由名称。
password_cost - 应该是一个介于4和31之间的整数。该数字代表用于哈希的迭代计数的2为底的对数。默认值是10（在i5上约为每秒10次哈希）。
enable_user_state - 布尔值，启用用户状态使用。在注册/登录过程中是否应该使用用户的状态？
default_user_state - 整数值，注册时的默认用户状态。注册时用户应处于何种状态？
allowed_login_states - 数组值，允许用户登录的状态。当用户尝试登录时，他的/她的状态是否属于以下状态之一？如果要允许没有状态的用户登录，请包含null。

更改注册验证码元素

注意：这些说明目前已过时。

默认情况下，用户注册使用Figlet验证码引擎。这是因为它是唯一一个不需要API密钥的引擎。可以使用依赖注入（DI）来更改验证码引擎。例如，要切换到Recaptcha，您需要将以下内容添加到您的配置文件之一（global.config.php、module.config.php或专用的recaptcha.config.php）

<?php
// ./config/autoload/recaptcha.config.php
return array(
    'di'=> array(
        'instance'=>array(
            'alias'=>array(
                // OTHER ELEMENTS....
                'recaptcha_element' => 'Zend\Form\Element\Captcha',
            ),
            'recaptcha_element' => array(
                'parameters' => array(
                    'spec' => 'captcha',
                    'options'=>array(
                        'label'      => '',
                        'required'   => true,
                        'order'      => 500,
                        'captcha'    => array(
                            'captcha' => 'ReCaptcha',
                            'privkey' => RECAPTCHA_PRIVATE_KEY,
                            'pubkey'  => RECAPTCHA_PUBLIC_KEY,
                        ),
                    ),
                ),
            ),
            'ZfcUser\Form\Register' => array(
                'parameters' => array(
                    'captcha_element'=>'recaptcha_element',
                ),
            ),
        ),
    ),
);

proprietes-privees / zfc-user

维护者

详细信息