PHPackages                             thecsea/users-management - 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 & Authorization](/categories/authentication)
4. /
5. thecsea/users-management

ActiveLibrary[Authentication & Authorization](/categories/authentication)

thecsea/users-management
========================

The most powerful and the simplest library to add a customizable users management system

v1.1.2(10y ago)018GPL-2.0PHPPHP >=5.3.0

Since Sep 16Pushed 10y ago1 watchersCompare

[ Source](https://github.com/thecsea/users-management)[ Packagist](https://packagist.org/packages/thecsea/users-management)[ Docs](http://www.thecsea.it)[ RSS](/packages/thecsea-users-management/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (8)Dependencies (3)Versions (9)Used By (0)

users-management
================

[](#users-management)

Build status: [![Build Status](https://camo.githubusercontent.com/85b35d52feab84f3b0ffa06e4c255c35a727e7abb84917cb915c0831711ee854/68747470733a2f2f7472617669732d63692e6f72672f746865637365612f75736572732d6d616e6167656d656e742e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/thecsea/users-management) [![Scrutinizer Code Quality](https://camo.githubusercontent.com/7435b16ee7ef5fa0f1a737bd999205634d52d8e2e8283b7afe23e0672ce32f8a/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f746865637365612f75736572732d6d616e6167656d656e742f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/thecsea/users-management/?branch=master) [![Code Coverage](https://camo.githubusercontent.com/902c1d00d170ca2cf31b6b1eb2a75389037f144f29f14d475110fff145cd3ae5/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f746865637365612f75736572732d6d616e6167656d656e742f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/thecsea/users-management/?branch=master) [![Build Status](https://camo.githubusercontent.com/9920b0e1c8be01881c8eb604fdeda3cb86aeaef5d2c18a82913132d11c7ca2a6/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f746865637365612f75736572732d6d616e6167656d656e742f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/thecsea/users-management/build-status/master) [![Latest Stable Version](https://camo.githubusercontent.com/99c74c644c7a96ca761019153cc553f91218d5a29c25d43bd3d348cee0f18440/68747470733a2f2f706f7365722e707567782e6f72672f746865637365612f75736572732d6d616e6167656d656e742f762f737461626c65)](https://packagist.org/packages/thecsea/users-management) [![Total Downloads](https://camo.githubusercontent.com/bd8a59ea4386d134b0a0e3222eab5cf28b476a64265071791d529726cbb4290f/68747470733a2f2f706f7365722e707567782e6f72672f746865637365612f75736572732d6d616e6167656d656e742f646f776e6c6f616473)](https://packagist.org/packages/thecsea/users-management) [![Latest Unstable Version](https://camo.githubusercontent.com/35826f88f970123896004dbffb7b4e9d400e992f9b32f466d85d3f2384092d86/68747470733a2f2f706f7365722e707567782e6f72672f746865637365612f75736572732d6d616e6167656d656e742f762f756e737461626c65)](https://packagist.org/packages/thecsea/users-management) [![License](https://camo.githubusercontent.com/d3332a59bec238c1eb06d3f59e16efcc07f6fce5e413f1e1c3dff55f15c8ac87/68747470733a2f2f706f7365722e707567782e6f72672f746865637365612f75736572732d6d616e6167656d656e742f6c6963656e7365)](https://packagist.org/packages/thecsea/users-management)

The most powerful and the simplest library to add a customizable users management system

- Password stored with hash (MD5)
- Object oriented: every user is an object
- Very simply, only two object: User (single user) and UsersManagement (environment)
- Integrated with [mysqltcs](https://github.com/thecsea/mysqltcs)
- Use an already established database connection (mysqltcs connection)
- ApiKey support
- Enabled user support
- Salt support (more security)
- Expendable

\#Download ##Get/update composer This library require composer (download composer here )

Update composer

`php composer.phar self-update`

\##Download

Download via composer require (we suggest to create a dedicated directory for this)

`php composer.phar require thecsea/users-management`

or insert library as dependency in your composer project

`thecsea/users-management": "1.0.*`

in the last case you have to install or update you project

`php composer.phar install`

or

`php composer.phar update`

**N.B. If you don't have access to server terminal you can perform installation on your pc and upload all via ftp**

\##Update users-management

You can update *users-management* (according to version limit set in `composer.json`)

`php composer.phar update`

\#Use

The examples are not implemented yet, although you can see how to use the library looking the `tests`

\##Firt use

You have to import the sql structure `tests/usersManagement.sql`

\##Simple example

```

```

N.B. config.php is a file that contains the mysql connection data as array.

**N.B. you have to include composer autoload to use the library**

\##How it works This library is fully object oriented so you have tostring, equals (user), clone and so on

\###Exception This library use exception to show error, every method can throw two exception:

- `UsersManagementException` thrown on logic error (for example wrong password)
- `Mysqltcsexception` thrown on mysql error (for example db permission problem)

\###Methods and documentation The user contains other useful method, you can see how to use method looking the phpdoc

\###Salt This library has support to salt, for more security, you can specify it via construct or via setter, or you can ignore it and use the default salt "thecsea"

\###Extra features This library include extra features like apiKey string and enabled flag for each user, you can use these information as you want, this class provide only the insert and update methods for these information

N.B. this class create an unique apiKey for each user (default behavior)

\###Db access You can obviously access to db, but we suggest to don't modify the structure.

\#Test

This library is tested, you can find tests under `tests`, coverage: [![Code Coverage](https://camo.githubusercontent.com/902c1d00d170ca2cf31b6b1eb2a75389037f144f29f14d475110fff145cd3ae5/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f746865637365612f75736572732d6d616e6167656d656e742f6261646765732f636f7665726167652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/thecsea/users-management/?branch=master)

Credits
=======

[](#credits)

- [Mysqltcs](https://github.com/thecsea/mysqltcs): php library to connect to a mysql database

By [thecsea.it](http://www.thecsea.it)
======================================

[](#by-thecseait)

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~2 days

Total

8

Last Release

3878d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/280e8cda025e47f1005450604314ec83a21dc771a405e64c071c9f4f5f822224?d=identicon)[carduz](/maintainers/carduz)

---

Top Contributors

[![carduz](https://avatars.githubusercontent.com/u/10631614?v=4)](https://github.com/carduz "carduz (43 commits)")

---

Tags

SimplemanagementUserspowerfulcustomizable

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/thecsea-users-management/health.svg)

```
[![Health](https://phpackages.com/badges/thecsea-users-management/health.svg)](https://phpackages.com/packages/thecsea-users-management)
```

###  Alternatives

[tomatophp/filament-users

Manage your users with a highly customizable user resource for FilamentPHP with integration of filament-shield and filament-impersonate

90102.0k7](/packages/tomatophp-filament-users)[jotaelesalinas/laravel-adminless-ldap-auth

Authenticate users in Laravel against an adminless LDAP server

2105.1k](/packages/jotaelesalinas-laravel-adminless-ldap-auth)[budyaga/yii2-users

Module for manage users and their rights with the support of registration through social services and assigned to each user more than one social service.

409.1k](/packages/budyaga-yii2-users)[arcanedev/laravel-auth

Laravel Authorization package.

294.8k1](/packages/arcanedev-laravel-auth)

PHPackages © 2026

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