NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2296 most downloaded on Packagist
LDAP Authentication & Management for Laravel.
Latest stable
v4.0.5
Last release 3 months ago
10 Aug 2026
Release timing varies
gaps range from 2 weeks to 9 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
86 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Preserve directory emulator connections during isolated chunks - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/711
Detect whether a password mutator is set via PHP attribute - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/707
Correctly identify LDAP error code from login failure diagnostic message - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/706
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Use float type hint for $start parameter in getElapsedTime() by @NiklasSchmitt - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/705
float type hint for $start parameter in getElapsedTime() by @NiklasSchmitt - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/705Ensure all logging adheres to channel defined in config by @Grimthorr - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/704
https://ldaprecord.com/docs/laravel/v4/release-notes
https://ldaprecord.com/docs/laravel/v4/release-notes
https://ldaprecord.com/docs/laravel/v4/upgrading
We're excited to announce the release of LdapRecord-Laravel v4.0.0! This major version brings compatibility with LdapRecord v4 , featuring improved SSL/TLS configuration naming, enhanced query builder internals, and updated testing tools. Please review the following release notes to understand the new features and changes.
LdapRecord-Laravel v4 now requires LdapRecord v4 to take advantage of:
Clearer SSL/TLS configuration naming
New filter object system
Improved query builder architecture
Standardized parameter names
Better type safety and error handling
Be sure to review the LdapRecord Core v4 upgrade guide for details on breaking changes that may affect your application.
The SSL/TLS configuration options have been renamed to better reflect their actual functionality:
Old Name (v3) New Name (v4) Purpose
use_ssl / LDAP_SSL use_tls / LDAP_TLS LDAPS connection (port 636)
use_tls / LDAP_TLS use_starttls / LDAP_STARTTLS STARTTLS upgrade (port 389)
This change eliminates confusion between LDAPS (SSL/TLS) and STARTTLS, making your configuration more explicit and easier to understand.
Example configuration update:
// config/ldap.php 'connections' => [ 'default' => [ 'use_tls' => env ( 'LDAP_TLS' , false ), // For LDAPS 'use_starttls' => env ( 'LDAP_STARTTLS' , false ), // For STARTTLS ] , ] , Copy Copied!
The Directory Emulator has been updated to work seamlessly with LdapRecord v4's new architecture:
Updated query internals : Now works with the new LdapRecord\Query\Filter objects
Parameter rename : findOrFail() now accepts $selects instead of $columns
Model builder updates : Constructor now accepts the model and query instance together
Array returns : Base query results now return arrays for consistency with v4
Most applications using DirectoryEmulator::setup() should not require changes, as the public API remains compatible.
The EscapedValue class has moved from LdapRecord\Models\Attributes\EscapedValue to LdapRecord\Query\EscapedValue , reflecting its role in query building rather than model attributes.
The testing UnescapedValue helper has been updated accordingly and will continue to work without changes in most cases.
For detailed upgrade instructions, please see the upgrade guide .
Most applications will only need to:
Update their composer.json to require ^4.0
Update SSL/TLS configuration option names
Review any custom Directory Emulator extensions
Laravel 13 compatibility - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/698
Add $description to ldap:browse command - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/690
$description to ldap:browse command - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/690Properly use deleted_at date format from Eloquent model during import when using --delete-missing option - https://github.com/DirectoryTree/LdapRecord
deleted_at date format from Eloquent model during import when using --delete-missing option - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/687Laravel 12 support - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/681
Removed debug calls in LdapUserSynchronizerTest - effb96b
LdapUserSynchronizerTest - effb96bOnly register wildcard event listeners for loggable events when LDAP logging is enabled - 7ab3565 - #655
Directory Emulator orWhereNotHas / orFilter + whereNotHas unexpected behaviour - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/665
orWhereNotHas / orFilter + whereNotHas unexpected behaviour - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/665Don't rehash passwords if password_column is set to false - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/647 - https://github.com/Director
password_column is set to false - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/647 - https://github.com/DirectoryTree/LdapRecord-Laravel/issues/645Added newly required rehashPasswordIfRequired method to auth providers - 34bcf9f - https://github.com/DirectoryTree/LdapRecord-Laravel/issues/638
rehashPasswordIfRequired method to auth providers - 34bcf9f - https://github.com/DirectoryTree/LdapRecord-Laravel/issues/638## Added - Laravel 11 compatibility
Always call LogManager::channel() when registering logging by @spawnia - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/636
LogManager::channel() when registering logging by @spawnia - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/636Replace deprecated utf8_encode method with mb_convert_encoding - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/634
utf8_encode method with mb_convert_encoding - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/634RulePassed and RuleFailed authentication events - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/626
RulePassed and RuleFailed authentication events - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/626Directory Emulator compatibility with recent LdapRecord base DN substitution update - https://github.com/DirectoryTree/LdapRecord-Laravel/commit/aaaa1
Bug 602 - LoginController::causedByInvalidCredentials(): Argument DirectoryTree/LdapRecord#2 ($diagnosticMessage) must be of type string - https://git
LoginController::causedByInvalidCredentials(): Argument DirectoryTree/LdapRecord#2 ($diagnosticMessage) must be of type string - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/603Made Logging Level configurable via logging.level config option by @nilskretschmer - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/600
logging.level config option by @nilskretschmer - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/600Nothing published for this version
Custom connection is not used with certain query methods in Directory Emulator - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/592 - #590
Detaching related models in Directory Emulator by @cheesegrits - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/560
memberof virtual attribute in Directory Emulator - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/584Properly retrieve base DN from query when running the ldap:browse command - f7c43fa
ldap:browse command - f7c43faMissing return values - 13bf7ce
Allow invokable classes and closures to be used in attribute handlers by @grantholle - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/544
LdapRecord version constraint in composer.json - https://github.com/DirectoryTree/LdapRecord-Laravel/commit/86d2b81ede3090f34d2aa6ec5eb1b1c6d1825499
composer.json - https://github.com/DirectoryTree/LdapRecord-Laravel/commit/86d2b81ede3090f34d2aa6ec5eb1b1c6d1825499EmulatesModelQueries trait method incompatibility - https://github.com/DirectoryTree/LdapRecord-Laravel/commit/0732c5a316f245a30b40e9eb67755bdfecd5a34
EmulatesModelQueries trait method incompatibility - https://github.com/DirectoryTree/LdapRecord-Laravel/commit/0732c5a316f245a30b40e9eb67755bdfecd5a34bldap:browse command should use new Query::list() method - by @Cbrad24 - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/542
ldap:browse command should use new Query::list() method - by @Cbrad24 - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/542Don't execute an LDAP query when Eloquent model guid is null - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/539
guid is null - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/539https://ldaprecord.com/docs/laravel/v3/release-notes
https://ldaprecord.com/docs/laravel/v3/release-notes
https://ldaprecord.com/docs/laravel/v3/upgrading
Ability to set a logging channel - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/510
In advance support for Laravel v10 by @hihuangwei - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/508
Support SQL Server unique indexes - #481, #478
Ability to add query scopes to LdapImporter and ldap:import command - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/474
LdapImporter and ldap:import command - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/474
artisan ldap:rootdse command for retrieving details about the connected LDAP server, such as base DN and other important information
artisan ldap:rootdse command for retrieving details about the connected LDAP server, such as base DN and other important informationDon't process models twice in emulated query by @ksassnowski in https://github.com/DirectoryTree/LdapRecord-Laravel/pull/432
Connections configured via .env are now properly cacheable by Laravel via php artisan optimize/config:cache - https://github.com/DirectoryTree/LdapRec
.env are now properly cacheable by Laravel via php artisan optimize/config:cache - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/417 - c2b3945196a2846216badd19ff6d8be6cb4258cc...c9c28be318e6c1b95d29b1d82c30118ac92d2f6aLaravel 9 support - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/391
Use Config\Repository contract interface for resolving configuration - 364444fb70162a7919ded922f8dbe3ac63d2eeae - https://github.com/DirectoryTree/Lda
Config\Repository contract interface for resolving configuration - 364444fb70162a7919ded922f8dbe3ac63d2eeae - https://github.com/DirectoryTree/LdapRecord-Laravel/pull/384 - Thanks to @aneipPHP 8.1 support - d3b7c46030b2e4f6ea421486f4c879e202e4a57e...2b90e868e3bb263841cc5db466ed51c1f96b8ef0 - https://github.com/DirectoryTree/LdapRecord-La
Emulated LDAP queries were case-sensitive. They are now case-insensitive to mirror LDAP functionality - #361 - d9ea8db7752a743bfd6d9134bb872a0d66bfd4e
Ability to import LDAP users by chunk, preventing out-of-memory issues
Drop support for PHP 7.2 - 95355b4
.env for setting up LDAP connections and custom options (publishing config is no longer required) - 626cc79, 416c0a6Properly bypass all exceptions when fallback credentials have been given - 0ea1567 - #287
BindFailureListener - 81f4d8aProperly emulate deleting LDAP attributes with the Directory Emulator - 06244ce - https://github.com/DirectoryTree/LdapRecord/issues/291
Ability to set a fallback callback or class to resolve users with if the WindowsAuthenticate query fails using WindowsAuthenticate::fallback($callback
WindowsAuthenticate query fails using WindowsAuthenticate::fallback($callback)
Exceptions that occur during the user query while authenticating users with the WindowsAuthenticate middleware are now caught by default
WindowsAuthenticate middleware are now caught by default
LdapRecord\Laravel\LdapRecord::failLoudly() - 692965c - #277report($e) Laravel helperWindowsAuthenticate SSO domain verification and extraction - 0476b48...1a35553 - #276
LdapRecord\Laravel\LdapRecord::failLoudly()report($e) Laravel helperldap:browse command missing LdapRecord\Models\Entry PHP import - c84b7a1 - #264
ldap:browse command missing LdapRecord\Models\Entry PHP import - c84b7a1 - #264Forward missing method calls on DatabaseUserProvider to EloquentUserProvider - 8dab566 - #258
DatabaseUserProvider to EloquentUserProvider - 8dab566 - #258Bump minimum LdapRecord core version to v2.3.0 - 8e2d0f3
v2.3.0 - 8e2d0f3Query::setBaseDn() method in Testing\EmulatedBuilder - 9395d43Type-hints in ldap:import and ldap:browse commands requiring LdapRecord\Models\Entry class have been properly updated to use the base LdapRecord\Model
ldap:import and ldap:browse commands requiring LdapRecord\Models\Entry class have been properly updated to use the base LdapRecord\Models\Model class instead.
.env variables.
sync_existing attribute array.
Compatibility with LdapRecord Core v2.2.0 - c75c6bb
Missing ramsey/uuid composer package requirement for use with older Laravel & Lumen versions that do not require it - debf5d3
ramsey/uuid composer package requirement for use with older Laravel & Lumen versions that do not require it - debf5d3Deprecate MultiDomainAuthentication trait - fc3e09a
MultiDomainAuthentication trait - fc3e09aldap:test command when no connections have been defined - 86b1c7cUse email as the default input field when throwing validation exceptions while listening for bind failures - 1801a69
email as the default input field when throwing validation exceptions while listening for bind failures - 1801a69DatabaseUserProvider and NoDatabaseUserProvider to ensure validation exceptions aren't caught - 9458526, 3d75a0dPlease view the upgrade guide to view any notable changes that may have affected your application.
Please view the upgrade guide to view any notable changes that may have affected your application.
Bumped core LdapRecord requirement to v2.*
All authentication events have been moved to a new namespace and renamed:
Events\Authenticating to Events\Auth\BindingEvents\Authenticated to Events\Auth\BoundEvents\AuthenticationFailed to Events\Auth\BindFailedEvents\AuthenticationRejected to Events\Auth\RejectedEvents\AuthenticatedWithWindows to Events\Auth\CompletedWithWindowsEvents\AuthenticatedModelTrashed to Events\Auth\EloquentUserTrashedEvents\DiscoveredWithCredentials to Events\Auth\DiscoveredWithCredentialsNearly all authentication events now have the same public properties ($object, $eloquent) for consistency and ease of implementation:
Auth\BindingAuth\BoundAuth\BindFailedAuth\CompletedAuth\RejectedAuth\CompletedWithWindowsAuth\EloquentUserTrashedAll previous import events have been moved into a new namespace:
Events\Imported to: Events\Import\ImportedEvents\Importing to: Events\Import\ImportingEvents\Synchronized to: Events\Import\SynchronizedEvents\Synchronizing to: Events\Import\SynchronizingEvents\DeletedMissing to: Events\Import\DeletedMissingNearly all import events now have the same public properties ($object, $eloquent) for consistency and ease of implementation:
Events\Import\ImportedEvents\Import\ImportingEvents\Import\SynchronizedEvents\Import\SynchronizingEvents\Import\DeletedMissingDirectory Emulator must now be torn down manually while running tests using DirectoryEmulator::tearDown():
protected function tearDown(): void
{
DirectoryEmulator::teardown();
parent::tearDown();
}
ldap:browse commandLdapRecord\Laravel\Import\Importer classImport\SavedImport\StartedImport\CompletedImport\DeletedImport\DeletedMissingImport\ImportFailedImport\RestoredAuth\Completed event,EloquentHydrator to: Import\EloquentHydratorEloquentUserHydrator to: Import\EloquentUserHydratorHydrators\Hydrator to: Import\Hydrators\HydratorHydrators\GuidHydrator to: Import\Hydrators\GuidHydratorHydrators\DomainHydrator to: Import\Hydrators\DomainHydratorHydrators\PasswordHydrator to: Import\Hydrators\PasswordHydratorHydrators\AttributeHydrator to: Import\Hydrators\AttributeHydratorLdapImporter has been renamed moved into a new namespace:
LdapImporter to Import\SynchronizerLdapUserImporter has been renamed and moved into a new namespace:
LdapUserImporter to: Import\UserSynchronizerUse email as the default input field when throwing validation exceptions while listening for bind failures - 41445c7
email as the default input field when throwing validation exceptions while listening for bind failures - 41445c7DatabaseUserProvider and NoDatabaseUserProvider to ensure validation exceptions aren't caught - b265cb7, 352673eOne column per quarter.