Leaf PHP auth helper

v2.3.2 2023-10-06 17:53 UTC



Leaf Auth v2

Latest Stable Version Total Downloads License

Leaf auth is a simple but powerful module which comes with powerful functions for handling all your authentication needs.

v2 comes with tons of fixes, improvements and upgrades. Running on top of leaf db v2, it also has support for other database types like PostgreSQL, Sqlite and many more.


You can easily install Leaf using Composer.

composer require leafs/auth

Or with leaf db

leaf install auth

Basic Usage

After installing leaf auth, you need to connect to your database. v2 presents additional ways to achieve this.


The connect method allows you to pass in your database connection parameters directly to leaf auth.

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


This method creates a database connection using your env variables.


And call autoConnect in your app.


db connection (v2 only)

Leaf auth now allows you to directly pass a PDO connection into leaf auth. This allows you to share your connection with leaf auth and avoid multiple connections.

$auth = new Leaf\Auth;

This also means that you can share you leaf db v2 connection with leaf auth like this:

$auth = new Leaf\Auth;

Leaf db (auth v2 + leaf 3 only)

If you are using leaf auth in a leaf 3 app, you will have access to the auth global as shown in some of the above connections. Along with this, if you already have a leaf db connection, you no longer need to explicitly connect to your database. Leaf auth searches for a leaf db instance and connects to it automatically.

Note that this only works in a leaf 3 app and only if you already have a leaf db connection.


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

// you can use auth straight away without any connect

📚 Auth methods

After connecting your db, you can use any of the methods below.

WIP: This page will be updated

⚡️ Funtional Mode

When using leaf auth in a leaf 3 app, you will have access to the auth, guard, hasAuth and sessionUser globals.

💬 Stay In Touch

📓 Learning Leaf 3

  • Leaf has a very easy to understand documentation which contains information on all operations in Leaf.
  • You can also check out our youtube channel which has video tutorials on different topics
  • We are also working on codelabs which will bring hands-on tutorials you can follow and contribute to.

😇 Contributing

We are glad to have you. All contributions are welcome! To get started, familiarize yourself with our contribution guide and you'll be ready to make your first pull request 🚀.

To report a security vulnerability, you can reach out to @mychidarko or @leafphp on twitter. We will coordinate the fix and eventually commit the solution in this project.

🤩 Sponsoring Leaf

Your cash contributions go a long way to help us make Leaf even better for you. You can sponsor Leaf and any of our packages on open collective or check the contribution page for a list of ways to contribute.

And to all our existing cash/code contributors, we love you all ❤️

🤯 Links/Projects