README

!! 招募维护者 !!

该项目不再积极维护！ 如果您想接管该项目，请在以下位置留言：https://github.com/rollerworks/RollerworksMultiUserBundle/issues/96

RollerworksMultiUserBundle通过使用FOSUserBundle支持多用户设置。它提供了对'fos_user'服务的完全兼容的替代品。

实际上，它是建立在FOSUserBundle之上的，并使用原始控制器、表单和UserManager。

功能包括

• 完全兼容已使用FOSUserBundle的现有软件包
• 无限的用户系统，每个系统都有自己的配置、存储引擎、模板、表单等。
• 轻松生成新的用户系统
• 单元测试

注意：此软件包的开发与FOSUserBundle的存储库同步。对于FOSUserBundle 2.0.x，您需要使用该软件包的1.0版本（或更低版本）。

由于FOSUserBundle 2.0尚未稳定，多用户支持被视为实验性的！

警告：此软件包不能与PUGXMultiUserBundle结合使用。如果已安装PUGXMultiUserBundle，请在继续之前将其删除。

文档

大部分文档存储在此软件包中的doc/index.md文件中

阅读master文档

安装

所有安装说明均位于文档中。

许可

此软件包在MIT许可下发布。有关详细信息，请参阅附带的LICENSE文件。

关于

RollerworksMultiUserBundle被设计为PUGXMultiUserBundle的替代品。

与PUGXMultiUserBundle的主要区别在于，RollerworksMultiUserBundle不使用Doctrine ORM联合实体继承，并提供了一组更丰富的功能。

报告问题或功能请求

问题和功能请求在Github问题跟踪器中跟踪。

在报告错误时，最好在基于Symfony标准版构建的基本项目中重现它，以便软件包的开发者可以通过简单地克隆它并遵循一些步骤来重现问题。

在提交PR时请使用Gush，以确保包含信息模板。

鸣谢

用户区分器的原始想法来自 PUGXMultiUserBundle。

与 PUGXMultiUserBundle 的主要区别在于，RollerworksMultiUserBundle 不使用 Doctrine ORM 连接实体继承，并且每个用户管理器都可以无“区分”地访问。

此捆绑包包含最初由 FOSUserBundle 开发者设计的源代码。

运行测试

在运行测试之前，您需要安装捆绑包依赖项。使用 composer 进行此操作

对于功能测试，需要 doctrine/mongodb-odm，但它默认未安装，因为一些自动代码分析器会失败。

$ php composer.phar composer require doctrine/mongodb-odm:"1.0.*@dev" --no-update
$ php composer.phar composer require doctrine/mongodb-odm-bundle:"3.0.*@dev" --no-update
$ php composer.phar --dev install

然后您可以启动 phpunit（确保已安装 https://github.com/sebastianbergmann/phpunit/#installation）

目前使用 Composer 版本的 PHPUnit 会失败，所以请确保使用 Phar 存档或 PEAR 版本。您至少需要 PHPUnit 的 3.6 版本和 MockObject 插件 1.0.8

$ phpunit -c phpunit.xml.dist

注意：默认情况下不运行功能测试，要运行所有测试，请确保已安装 PDO_SQLite 和 MongoDB 的 PHP 扩展，然后使用以下命令启动 phpunit

$ bin/phpunit -c phpunit.xml.dist --exclude-group ""

可选地，您可以跳过功能测试，因为这些测试在打开 Pull Request 时始终在 Travis-CI 上自动运行。