README

Leaf Auth v2

Leaf auth 是一个简单但功能强大的模块，包含处理所有认证需求的功能。

v2 包含大量的修复、改进和升级。在 leaf db v2 上运行，还支持其他数据库类型，如 PostgreSQL、Sqlite 等。

安装

您可以使用 Composer 轻松安装 Leaf。

composer require leafs/auth

或者使用 leaf db

leaf install auth

基本用法

安装 leaf auth 后，您需要连接到数据库。v2 提供了多种方法来实现这一点。

connect

connect 方法允许您直接将数据库连接参数传递给 leaf auth。

auth()->connect('127.0.0.1', 'dbname', 'username', 'password');

autoConnect

此方法使用您的环境变量创建数据库连接。

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=LEAF_DB_NAME
DB_USERNAME=LEAF_DB_USERNAME
DB_PASSWORD=

然后在您的应用程序中调用 autoConnect。

auth()->autoConnect();

数据库连接 (v2 仅限)

Leaf auth 现在允许您直接将 PDO 连接传递给 leaf auth。这允许您与 leaf auth 共享连接并避免多个连接。

$auth = new Leaf\Auth;
$auth->dbConnection($pdoConnecction);

这意味着您还可以像这样与 leaf db v2 连接共享 leaf auth

$auth = new Leaf\Auth;
$auth->dbConnection($db->connection());

Leaf db (auth v2 + leaf 3 仅限)

如果您在 leaf 3 应用程序中使用 leaf auth，您将能够访问上面一些连接中显示的 auth 全局变量。此外，如果您已经有一个 leaf db 连接，您不再需要显式连接到数据库。Leaf auth 会搜索 leaf db 实例并将其自动连接。

请注意，这只能在 leaf 3 应用程序中使用，并且只有当您已经有一个 leaf db 连接时才有效。

<?php

db()->connect('127.0.0.1', 'dbname', 'username', 'password');

// you can use auth straight away without any connect
auth()->login(...);

📚 认证方法

连接您的数据库后，您可以使用以下任何方法。

WIP：此页面将更新

⚡️ 功能模式

在 leaf 3 应用程序中使用 leaf auth 时，您将能够访问 auth、guard、hasAuth 和 sessionUser 全局变量。

💬 保持联系

📓 学习 Leaf 3

Leaf 有一个易于理解的文档，其中包含有关 Leaf 中所有操作的信息。
您还可以查看我们的 YouTube 频道，其中包含不同主题的视频教程。
我们还在开发 codelabs，这将带来您可以遵循和贡献的实践教程。

😇 贡献

我们很高兴有您的参与。所有贡献都受欢迎！要开始，请熟悉我们的贡献指南，您就可以准备好提交第一个 pull request 🚀。

要报告安全漏洞，您可以通过 @mychidarko 或 @leafphp 在推特上联系我们。我们将协调修复，并最终在此项目中提交解决方案。

🤩 赞助 Leaf

您的现金捐助对我们来说意义重大，帮助我们使Leaf为您变得更好。您可以在 open collective 上赞助Leaf和我们的任何包，或者查看捐助页面了解多种捐助方式。

对所有现有的现金/代码捐助者，我们都爱你们❤️

leafs / auth

维护者

详情