PHPackages syardumi/my-eloquent-ldap - 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. [Database & ORM](/categories/database) 4. / 5. syardumi/my-eloquent-ldap ActiveLibrary[Database & ORM](/categories/database) syardumi/my-eloquent-ldap ========================= A Laravel package that first tries to log the user against the internal database if that fails, it tries against the configured LDAP/AD server. 0.1.4(10y ago)110GPLv3PHPPHP >=5.5.9 Since Aug 7Pushed 10y ago1 watchersCompare [ Source](https://github.com/syardumi/my-eloquent-ldap)[ Packagist](https://packagist.org/packages/syardumi/my-eloquent-ldap)[ Docs](https://github.com/syardumi/my-eloquent-ldap)[ RSS](/packages/syardumi-my-eloquent-ldap/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (4)Versions (6)Used By (0) my-eloquent-ldap ================ [](#my-eloquent-ldap) [![Latest Version on Packagist](https://camo.githubusercontent.com/0ce8301178df481dde62210ca25c2de41ffc4b658f330aaef4eb783f5eb0c075/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7061636b61676973742d76302e312e322d6f72616e67652e737667)](https://packagist.org/packages/sroutier/eloquent-ldap)[![Software License](https://camo.githubusercontent.com/593d3efeb74012dc6de7db89d2833a5ec1621c3e236d115ca4c25d0b2410a324/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e63652d47504c76332d627269676874677265656e2e737667)](LICENSE.md) A Laravel package that first tries to log the user against the internal database, if that fails, it tries against the configured LDAP/AD server. Optionally it will create a local user record on first login of an LDAP user, as well as grant that user permissions to local groups that have matching names of the LDAP groups that the user is a member of. Install ------- [](#install) Via Composer ``` $ composer require syardumi/my-eloquent-ldap ``` Publish assets -------------- [](#publish-assets) To publish the assets, config file and migration scripts, run this command: ``` $ php artisan vendor:publish --provider="Syardumi\EloquentLDAP\Providers\EloquentLDAPServiceProvider" ``` This will publish a config file and a migration file. Migration --------- [](#migration) The migration script will add a new column 'auth\_type' to the schema of the 'users' table, and one column 'resync\_on\_login' to the 'groups' table. You should already have both tables, but if you do not or if you want to use different tables for those purposes, the migration to create those tables is provided as an example, but commented out. You will want to review the migration script and adjust according to your scenario. Once ready, run the migration script with this command: ``` $ php artisan migrate ``` Configure --------- [](#configure) The recommended way to configure this package is by defining the following variables in you '.env' file and adjusting the values there. For a detailed explanation of each setting, refer to the config file that you published above. ``` LDAP_ENABLED=false LDAP_CREATE_ACCOUNTS=true LDAP_REPLICATE_GROUP_MEMBERSHIP=true LDAP_RESYNC_ON_LOGIN=true LDAP_GROUP_MODEL=App\Models\Group LDAP_LABEL_INTERNAL=internal LDAP_LABEL_LDAP=ldap LDAP_ACCOUNT_SUFFIX=@company.com LDAP_BASE_DN=DC=department,DC=company,DC=com LDAP_SERVER=ldapsrv01.company.com LDAP_PORT=389 LDAP_USER_NAME=ldap_reader LDAP_PASSWORD=PaSsWoRd LDAP_RETURN_REAL_PRIMARY_GROUP=true LDAP_SECURED=false LDAP_SECURED_PORT=636 LDAP_RECURSIVE_GROUPS=true LDAP_SSO=false LDAP_USERNAME_FIELD=samaccountname LDAP_EMAIL_FIELD=userprincipalname LDAP_FIRST_NAME_FIELD=givenname LDAP_LAST_NAME_FIELD=sn LDAP_USER_FILTER=(&(objectcategory=person)(samaccountname=%username)) ``` Usage ----- [](#usage) The 'users' table/model must have the following columns/attributes named 'username', 'first\_name', 'last\_name' and 'email'. The migration script provided with this package has an example of how to create such a table but it is commented out. The user model must have the 'auth-type' attribute added to its 'fillable' array to allow setting the column in the database. Also your login view and 'AuthController' must accept a user name and password. They can accept other fields if you want, such as email, security token, etc... But the first time a new user tries to log in, since he will not be found in the local database, the package will need the user name to authenticate against the LDAP server. Example ------- [](#example) For a concrete example of this package used in an active project, see [sroutier/laravel-5.1-enterprise-starter-kit](https://github.com/sroutier/laravel-5.1-enterprise-starter-kit). Note that in that project this package is used in combination with [Zizaco/entrust](https://github.com/zizaco/entrust) to provide role based authorization, therefore there is no group model, but instead a role model. Change log ---------- [](#change-log) Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently. Contributing ------------ [](#contributing) Please see [CONTRIBUTING](CONTRIBUTING.md) for details. Security -------- [](#security) If you discover any security related issues, please email instead of using the issue tracker. Credits ------- [](#credits) - [Sebastien Routier](https://github.com/sroutier) - [All Contributors](https://github.com/sroutier/eloquent-ldap/graphs/contributors) License ------- [](#license) The GNU General Public License Version 3 (GPLv3). Please see [License File](LICENSE.md) for more information. ### Health Score 24 — LowBetter than 32% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity7 Limited adoption so far Community9 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 76.9% 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 ~17 days Total 5 Last Release 3869d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/6fb5fb6c7898a6c339ba02aaee1187bd97a73ceda3e3e82c5aac62eb583b69fb?d=identicon)[syardumi](/maintainers/syardumi) --- Top Contributors [![sroutier](https://avatars.githubusercontent.com/u/3011606?v=4)](https://github.com/sroutier "sroutier (10 commits)")[![syardumi](https://avatars.githubusercontent.com/u/2123996?v=4)](https://github.com/syardumi "syardumi (3 commits)") --- Tags laravelauthAuthenticationeloquentldapactive directoryadldap-eloquent ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/syardumi-my-eloquent-ldap/health.svg) ``` [![Health](https://phpackages.com/badges/syardumi-my-eloquent-ldap/health.svg)](https://phpackages.com/packages/syardumi-my-eloquent-ldap) ``` ### Alternatives [sroutier/eloquent-ldap A Laravel package that first tries to log the user against the internal database if that fails, it tries against the configured LDAP/AD server. 228.7k1](/packages/sroutier-eloquent-ldap)[watson/validating Eloquent model validating trait. 9723.3M47](/packages/watson-validating)[kodeine/laravel-acl Light-weight role-based permissions for Laravel 5 built in Auth system. 782354.8k5](/packages/kodeine-laravel-acl)[cybercog/laravel-love Make Laravel Eloquent models reactable with any type of emotions in a minutes! 1.2k302.7k1](/packages/cybercog-laravel-love)[cviebrock/eloquent-taggable Easy ability to tag your Eloquent models in Laravel. 567694.8k3](/packages/cviebrock-eloquent-taggable)[reedware/laravel-relation-joins Adds the ability to join on a relationship by name. 2121.2M13](/packages/reedware-laravel-relation-joins) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)