NewYour coding agent can read the release notes before it upgrades.Set up the MCP server β
Packagist, #1917 most downloaded on Packagist
A fully-featured LDAP ORM.
Latest stable
v4.1.1
Last release 1 months ago
08 Oct 2026
Ships fairly regularly
a new release about every 5 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
175 releases Β· first in 2019
Drag across the ruler to compare, or tap a release to open it.
Revert use of static instances for Container::$logger and Container::$dispatcher - 0114d97, 965fee7
Container::$logger and Container::$dispatcher - 0114d97, 965fee7Container::flush() method for resetting the current container instance - 965fee7DirectoryFake::tearDown() for resetting the Container instance during unit tests - 965fee7, 41048fbLDAP logging - https://github.com/DirectoryTree/LdapRecord-Laravel/issues/228 - 626a6aa
Deleting non-leaf nodes/objects will now property delete all leaf nodes/objects of different types - 32bcde0
Your coding agent can read these notes before it upgrades. Set up the MCP server β
ActiveDirectory\Group::members relationship not including primary group members - #223 - e670d50
ActiveDirectory\Group::members relationship not including primary group members - #223 - e670d50Dates that have timezones are now correctly handled - #193 - 3ad2287
Pagination limit issue causing no more than one page of results to be returned
limit issue causing no more than one page of results to be returned
FreeIPA models - #203 - 3ed5682, 8f3fc21, 5d239cb
Guid::getHex() method to retrieve hexadecimal string value of a GUID - 0cf2ae1Relation::exists() method returning true when null or false is inserted as an argument
Support for Laravel 8.0 - bb84369, a0a3ef0
Automatically populate models new distinguished name upon $model->rename() - #187 - 7d302d2
$model->rename() - #187 - 7d302d2$model->getFirstAttribute() - #182 - 8f392f0null - #183 - 983f5f1hasAttribute() method - #189 - 7c57ed2$original attributes upon a $model->rename() #190 - e24ca23...8f8829cExchangeServer and ExchangeDatabase Active Directory models - #177 - bcc1a1c...51f9f9f, 5424fde...d99a872DistinguishedName objects - dedd6efDetaching from large groups exceeding 2000+ members
scope, i.e. scopeExhangeUsers - a652a85User::whereHasMailbox() query scope - Thanks to @grantholle - 1e281c2$relation->contains() method to determine if a relationship contains a model, distinguished name or common name i.e. <br/>$user->groups()->contains('Accounting'). You may also pass an array of any combination of the above to determine if the relation contains any of the given.
$relation->exists() method can now accept a distinguished name and common name, where it previously only accepted a Model instance. You may now also pass an array of any combination of the above to determine if the relation contains all of the given.Accidental breaking change with finally call in try/catch block
finally call in try/catch block
Conflicting variable names in Relation method - #162 - ad4909f - Thanks to @AlexH269
Relation method - #162 - ad4909f - Thanks to @AlexH269Primary groups will now be included with AD Computer groups relation results - e0d081c
Computer groups relation results - e0d081cDetailedError's are now accessible on all LdapRecord exceptions - 3216211LdapRecord\Exceptions\AlreadyExistsExceptionLdapRecord\Exceptions\InsufficientAccessExceptionLdapRecord\Exceptions\ConstraintViolationException$objectClasses property
-1, 0) can now be properly set on model attributes, such as pwdlastset
Active Directory User primary groups are now merged with their groups() relation results - #139 - 421819b
User primary groups are now merged with their groups() relation results - #139 - 421819bProperly use LDAP_MOD_BATCH_ADD and LDAP_MOD_BATCH_REMOVE when adding / removing values to prevent always issuing an LDAP_MOD_BATCH_REPLACE
LDAP_MOD_BATCH_ADD and LDAP_MOD_BATCH_REMOVE when adding / removing values to prevent always issuing an LDAP_MOD_BATCH_REPLACE
$model->encodeAttributes() method - 9178caeModel::isAncestorOf and Model::isDescendantOf now properly checks recursively - #127 - 1d7109d
Model::isAncestorOf and Model::isDescendantOf now properly checks recursively - #127 - 1d7109dModel::isChildOf and Model::isParentOf have been added to determine immediate ascendant or descendant models - 1d7109dModels\Attributes\DistinguishedName class has been added to perform comparison operations on Distinguished Names - 1d7109dRollback #116 due to #125 - 09e572d
Operations that fail due to a lost LDAP connection will now be retried on the primary server before failing over to secondary servers
members relationship
OneToMany relationships can now be merged with other relation results - #119 - f226b40Relation query results now properly use the parent models connection
Properly create OpenLDAP OrganizationalUnit RDNS - a49ccee, 342daf8 - #115
OrganizationalUnit RDNS - a49ccee, 342daf8 - #115This is fully backwards compatible -- no breaking changes have been introduced with this implementation.
Connection::attempted() to retrieve hosts that LdapRecord failed connecting to - 81eb729HasMany::paginate() method to prevent pagination calls being forwarded to the underlying query which will return incorrect results.HasMany::setPageSize() method to allow customization of the relation query pagination sizeProperly query recursive model relations when other model objects are included - 9b42d5b - #108
recursive() calls - faa7f14 - #108Properly ignore values that cannot be converted to dates for JSON serialization - 5e249ed
HasMany relation queries - 3c44500
AccountControl::doesntHave method - 7e73e81
$ac->doesntHave(AccountControl::ACCOUNTDISABLE)Properly type cast escaped values to strings - 0b1c695
entryUUID is always selected when using OpenLDAP models - 97bf904Ability to hide / show attributes for serialization (ported from Eloquent) - e956b96, e942a34 - https://github.com/DirectoryTree/LdapRecord-Laravel/is
Properly escape values when creating distinguished names
Models\Attributes\EscapedValue class for easily escaping LDAP values - e5baf5cEscapesValues trait - e5baf5cModel::escape method - e5baf5cModel::setFirstAttribute now properly sets entire attribute value - 2954b88 - #102
Model::setFirstAttribute now properly sets entire attribute value - 2954b88 - #102Model::addAttributeValue to be able to add unique values to existing attributes - 2954b88Cache is now set properly on new queries - 341175c - #99
DateTimeInterface and DateInterval instances to seconds - 5ee1834, 41cd199 - #99Query\ArrayCacheStore - ac8bfcbBuilder::getCache method - ed79f13Model scopes are now properly removed on relation queries - 9cc0b22, 24ad4da- #97
Relation::getRelationQuery method has been made public - ea6a4dfAccountControl::PASSWD_CANT_CHANGE constant is now properly available - 14a2aa6, 04ff34e - #91, #90 - Thanks to @ellisonpatterson
AccountControl::PASSWD_CANT_CHANGE constant is now properly available - 14a2aa6, 04ff34e - #91, #90 - Thanks to @ellisonpattersonObjects can now be created without a common name (such as Organizational Units) - 0141357 - #88 - Thanks to @aleksanderalright
Container::getDefaultConnectionName on instance - 50b0554
Container::getDefaultConnectionName on instance - 50b0554Class based listeners - #86 - 50e2ef9, 622e56b
Store logger in the Container singleton instance rather than statically - 4728354 - https://github.com/DirectoryTree/LdapRecord-Laravel/issues/77
Container singleton instance rather than statically - 4728354 - https://github.com/DirectoryTree/LdapRecord-Laravel/issues/77Connection::getCache method - 5e5780e
Connection::getCache method - 5e5780e## Added - Laravel 7.0 support
ErrorException thrown when null is given to Builder::setDn(null) - 22baa36
ErrorException thrown when null is given to Builder::setDn(null) - 22baa36Model::getName($dn), Model::getRdn($dn) methods - 90b2d13Model::getParentDn(null) will now return the models parent DN- 90b2d13Batch modifications being stacked on multiple Model::getModifications() calls - 0684b1b - #81
Model::getModifications() calls - 0684b1b - #81Model::getQuery() calls - 2d4ce50 - #82Always wrap selected columns in an array - 590b22d
Ability to restore deleted LDAP objects (ActiveDirectory only) - 39e2dcc
Renaming and Renamed events when models are being renamed / moved - 95c3bc7find - cb8da53Connection auth testing utilities - 0a47aac, 23c1357
Properly allow statically called Model::create calls - 955f59d
Model::create calls - 955f59dGlobal scopes not being applied to paginate requests - b4abe94, - 96c9570 https://github.com/DirectoryTree/LdapRecord-Laravel/issues/35
paginate requests - b4abe94, - 96c9570 https://github.com/DirectoryTree/LdapRecord-Laravel/issues/35hasOne relation values - 18bf3ecUse server controls for pagination in PHP >= 7.3 - f52d9e3eb513771967594d6bca09029ae1bb6752 - #59
Ldap::getOption now properly supports a null value - a0cf71524bbe25848370597b5c54767b53cb9d50critical pagination flag - 814bcece45c2f1c7c2764f90af589d5faa44d71fProperly set $objectClasses to public in OpenLdap\OrganizationalUnit - b3f2603
$objectClasses to public in OpenLdap\OrganizationalUnit - b3f2603Properly configure connections before initialization - #57 - ccc18b9
Models now have a boot method that can be overridden for adding global scopes and other logic
boot method that can be overridden for adding global scopes and other logicActiveDirectory\User model search results via built-in scope: RejectComputerObjectClassModel::newInstance() method - 5225c65
Model::newInstance() method - 5225c65Attempt reconnecting if an operations error occurs - 213bbc8
Handle pagination warnings from servers that don't support it - 8ba554f
Nothing published for this version
getName() method on model to easily retrieve the name of the object - 688ca1f
getName() method on model to easily retrieve the name of the object - 688ca1fadd() or remove() flags on AccountControl objects - ca496e8AccountrControl flag extraction - 03932fdAbility to get all filters on a query via Builder::getFilters() - e103300
Builder::getFilters() - e103300Allow using illuminate/contracts > 6.* - 3823317
illuminate/contracts > 6.* - 3823317## π First Release π ### Quick Start - Documentation
One column per quarter.