PHPackages                             2amigos/yii2-usuario - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Authentication &amp; Authorization](/categories/authentication)
4. /
5. 2amigos/yii2-usuario

ActiveYii2-extension[Authentication &amp; Authorization](/categories/authentication)

2amigos/yii2-usuario
====================

Highly customizable and extensible user management, authentication, and authorization Yii2 extension

1.6.3(2y ago)297285.0k↓47.4%146[103 issues](https://github.com/2amigos/yii2-usuario/issues)[12 PRs](https://github.com/2amigos/yii2-usuario/pulls)14BSD-3-ClausePHPPHP &gt;=5.5CI passing

Since Jun 13Pushed 10mo ago45 watchersCompare

[ Source](https://github.com/2amigos/yii2-usuario)[ Packagist](https://packagist.org/packages/2amigos/yii2-usuario)[ RSS](/packages/2amigos-yii2-usuario/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (8)Dependencies (18)Versions (35)Used By (14)

Yii 2 Usuario Extension
=======================

[](#yii-2-usuario-extension)

[![Documentation Status](https://camo.githubusercontent.com/2fcb5caaa49f8e65d2234319fce8dd54f577be56b1d4c1b4b42f493b7de11ace/68747470733a2f2f72656164746865646f63732e6f72672f70726f6a656374732f796969322d7573756172696f2f62616467652f3f76657273696f6e3d6c6174657374)](http://yii2-usuario.readthedocs.io/en/latest/?badge=latest)[![Join the chat at https://gitter.im/2amigos/yii2-usuario](https://camo.githubusercontent.com/8644f8366fad1edb32d1d7140cf7bd5bd0e07590b671dc9b3480049209893796/68747470733a2f2f6261646765732e6769747465722e696d2f32616d69676f732f796969322d7573756172696f2e737667)](https://gitter.im/2amigos/yii2-usuario?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)[![Packagist Version](https://camo.githubusercontent.com/a8a5e168033198e573735f6028c4138b55b5ca40b8cc0c04c1a1104e2e8ec720/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f32616d69676f732f796969322d7573756172696f2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/2amigos/yii2-usuario)[![Latest Stable Version](https://camo.githubusercontent.com/d42c61f9520beb426e8fb5fdf49ef6f14e10d2441b0be9ad667a99b593a08abd/68747470733a2f2f706f7365722e707567782e6f72672f32616d69676f732f796969322d7573756172696f2f76657273696f6e)](https://packagist.org/packages/2amigos/yii2-usuario)[![Total Downloads](https://camo.githubusercontent.com/1f324600aa285859f6b4c3eda2857cdc93043f1ab223d4c19fcb3a370d69d94e/68747470733a2f2f706f7365722e707567782e6f72672f32616d69676f732f796969322d7573756172696f2f646f776e6c6f616473)](https://packagist.org/packages/2amigos/yii2-usuario)[![Build Status](https://github.com/2amigos/yii2-usuario/actions/workflows/php.yml/badge.svg)](https://github.com/2amigos/yii2-usuario/actions/)[![Latest Unstable Version](https://camo.githubusercontent.com/d38913805cf92270e68cb8d8ca482a368b4b5f632b15b0dd64df699187b9339c/68747470733a2f2f706f7365722e707567782e6f72672f32616d69676f732f796969322d7573756172696f2f762f756e737461626c65)](//packagist.org/packages/2amigos/yii2-usuario)
[![Scrutinizer Code Quality](https://camo.githubusercontent.com/ff0b00236b08b53aa78dab04a4a44ad6033e5320baa9e007c198bd7e068b627b/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f32616d69676f732f796969322d7573756172696f2f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/2amigos/yii2-usuario/?branch=master)

Yii 2 usuario is a highly customizable and extensible user management, RBAC management, authentication, and authorization Yii2 module extension.

It works extensively with Yii's Container making it really easy to override absolutely anything within its core. The module is built to work out of the box with some minor config tweaks and it comes with the following features:

- Backend user/profile/account management
- Backend RBAC management
- Login via username/email + password process
- Login via social network process
- Password recovery process
- Two-Factor authentication process
- Google reCaptcha

We considered that RBAC was essential to be included into any user management module, even if you simply use one user with `admin` role, its much better to actually work with RBAC just in case your application scales in the future.

Boostrap 4 and 5 support
------------------------

[](#boostrap-4-and-5-support)

With the release of 1.6, contributors started implementing changes for supporting newer versions of the Boostrap library, being Usuario stuck at 3.

Up until around May 2023, the `master` branch will remain stable, so devs who in these years relied on it for deployment can have time to migrate to a stable version. BS5 development is ongoing on branch [`2.0.0-dev`](https://github.com/2amigos/yii2-usuario/tree/v2.0.0-dev), which will eventually be merged in `master` around May.

You can check issues #476, #488, #500 for updates, or the [branch itself](https://github.com/2amigos/yii2-usuario/tree/v2.0.0-dev).

Documentation
-------------

[](#documentation)

You can read the latest docs on

Need Help?
----------

[](#need-help)

If you have issues, please use the Gitter room of this repository . Please, remember that we may not be online all the time. We expect that we can build a community around the users of this module

Contributing
------------

[](#contributing)

Please, read our [CONTRIBUTION guidelines](CONTRIBUTING.md).

Credits
-------

[](#credits)

This module is highly inspired by the excellent work of [Dektrium](https://dektrium.com/) on both of its modules:

- [Yii 2 User](https://github.com/dektrium/yii2-user)
- [Yii 2 RBAC](https://github.com/dektrium/yii2-rbac)

In fact, we have used some of its processes, commands, views, and some of its attribute names to somehow standardize the modules and make it easier for our developers to swap from [Dektrium's](https://dektrium.com) modules to our own.

> [![2amigOS!](https://camo.githubusercontent.com/cda3de646752adf411381e6bbb880b7e0d4a8a5a42e610d1f5bb513e59e57dff/68747470733a2f2f732e67726176617461722e636f6d2f6176617461722f35353336333339346437323934356666376564333132353536656330343165303f733d3830)](http://www.2amigos.us)
> *Beyond Software*
> [www.2amigos.us](http://www.2amigos.us)

###  Health Score

53

—

FairBetter than 96% of packages

Maintenance33

Infrequent updates — may be unmaintained

Popularity56

Moderate usage in the ecosystem

Community44

Growing community involvement

Maturity70

Established project with proven stability

 Bus Factor4

4 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~91 days

Recently: every ~111 days

Total

28

Last Release

838d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/566016?v=4)[Antonio Ramirez](/maintainers/tonydspaniard)[@tonydspaniard](https://github.com/tonydspaniard)

---

Top Contributors

[![maxxer](https://avatars.githubusercontent.com/u/240201?v=4)](https://github.com/maxxer "maxxer (146 commits)")[![TonisOrmisson](https://avatars.githubusercontent.com/u/6357451?v=4)](https://github.com/TonisOrmisson "TonisOrmisson (63 commits)")[![resurtm](https://avatars.githubusercontent.com/u/100198?v=4)](https://github.com/resurtm "resurtm (58 commits)")[![bscheshirwork](https://avatars.githubusercontent.com/u/5769211?v=4)](https://github.com/bscheshirwork "bscheshirwork (35 commits)")[![tonydspaniard](https://avatars.githubusercontent.com/u/566016?v=4)](https://github.com/tonydspaniard "tonydspaniard (35 commits)")[![Eseperio](https://avatars.githubusercontent.com/u/5459366?v=4)](https://github.com/Eseperio "Eseperio (32 commits)")[![eluhr](https://avatars.githubusercontent.com/u/13000805?v=4)](https://github.com/eluhr "eluhr (20 commits)")[![ajmedway](https://avatars.githubusercontent.com/u/1861604?v=4)](https://github.com/ajmedway "ajmedway (19 commits)")[![WeeSee](https://avatars.githubusercontent.com/u/3421590?v=4)](https://github.com/WeeSee "WeeSee (14 commits)")[![Dezinger](https://avatars.githubusercontent.com/u/432272?v=4)](https://github.com/Dezinger "Dezinger (14 commits)")[![pappfer](https://avatars.githubusercontent.com/u/738623?v=4)](https://github.com/pappfer "pappfer (13 commits)")[![kartik-v](https://avatars.githubusercontent.com/u/3592619?v=4)](https://github.com/kartik-v "kartik-v (11 commits)")[![faenir](https://avatars.githubusercontent.com/u/5931594?v=4)](https://github.com/faenir "faenir (11 commits)")[![MatteoF96](https://avatars.githubusercontent.com/u/38226754?v=4)](https://github.com/MatteoF96 "MatteoF96 (7 commits)")[![MaksimKiselev](https://avatars.githubusercontent.com/u/4495801?v=4)](https://github.com/MaksimKiselev "MaksimKiselev (7 commits)")[![Wautvda](https://avatars.githubusercontent.com/u/1712579?v=4)](https://github.com/Wautvda "Wautvda (7 commits)")[![Julian-B90](https://avatars.githubusercontent.com/u/4377396?v=4)](https://github.com/Julian-B90 "Julian-B90 (7 commits)")[![niciz](https://avatars.githubusercontent.com/u/7879049?v=4)](https://github.com/niciz "niciz (7 commits)")[![squio](https://avatars.githubusercontent.com/u/169410?v=4)](https://github.com/squio "squio (6 commits)")[![mrbig00](https://avatars.githubusercontent.com/u/1911197?v=4)](https://github.com/mrbig00 "mrbig00 (6 commits)")

---

Tags

2amigosauthorizationbackendrbacrbac-managementyii2useraccessaclrbacyii2yiiUser managementbackendyii2-useryii 22amigosyii framework

###  Code Quality

TestsCodeception

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/2amigos-yii2-usuario/health.svg)

```
[![Health](https://phpackages.com/badges/2amigos-yii2-usuario/health.svg)](https://phpackages.com/packages/2amigos-yii2-usuario)
```

###  Alternatives

[dektrium/yii2-user

Flexible user registration and authentication module for Yii2

928815.9k38](/packages/dektrium-yii2-user)[saeven/zf3-circlical-user

Complete user entity, rights, and access module for Laminas

3719.0k](/packages/saeven-zf3-circlical-user)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
