URI::ldap(3)

💅 URI::ldap — LDAP Uniform Resource Locators 🦋

Okay bestie, so this is the URI::ldap page from the Perl manual (that's URI::ldap(3), from perl v5.42.0) and it's literally the whole scoop on getting LDAP URLs to behave. LDAP Uniform Resource Locators, no cap. Let's get into it ✨

---

🌸 NAME 🌸

URI::ldap — LDAP Uniform Resource Locators. That's the vibe. That's the whole thing. 👑

---

✨ SYNOPSIS ✨

Here's how you actually touch it, copy-paste ready:

  use URI;

  $uri = URI->new("ldap:$uri_string");
  $dn     = $uri->dn;
  $filter = $uri->filter;
  @attr   = $uri->attributes;
  $scope  = $uri->scope;
  %extn   = $uri->extensions;

  $uri = URI->new("ldap:");  # start empty
  $uri->host("ldap.itd.umich.edu");
  $uri->dn("o=University of Michigan,c=US");
  $uri->attributes(qw(postalAddress));
  $uri->scope('sub');
  $uri->filter('(cn=Babs Jensen)');
  print $uri->as_string,"\n";

Like, you can parse one that already exists, or you can start from an empty "ldap:" and build the whole thing up piece by piece. Main character energy either way 💖

---

🎀 DESCRIPTION 🎀

URI::ldap hands you an interface to parse an LDAP URI into its constituent parts — and also to build a URI from scratch, exactly as described in RFC 2255. Both directions. Iconic. 🫶

---

💅 METHODS 💅

URI::ldap supports all the generic and server methods defined by URI, plus the following ones down here. Slay.

Each of these methods can be used to set or get the value in the URI. The values are passed in unescaped form (important!!). None of these return undefined values, but heads up: elements without a default can be empty. If arguments are given, then a new value is set for the given part of the URI. Simple as that 🦋

• $uri->dn( [$new_dn] ) — Sets or gets the Distinguished Name part of the URI. The DN identifies the base object of the LDAP search. It's giving "where do I even start looking" 💫
• $uri->attributes( [@new_attrs] ) — Sets or gets the list of attribute names which are returned by the search. Like your lil shopping list of what comes back 🍓
• $uri->scope( [$new_scope] ) — Sets or gets the scope to be used by the search. The value can be one of "base", "one" or "sub". If none is given in the URI then the return value defaults to "base". Defaults! We love a safety net ✨
• $uri->_scope( [$new_scope] ) — Same as scope(), but does not default to anything. Raw. Unfiltered. (Well, unscoped 😭)
• $uri->filter( [$new_filter] ) — Sets or gets the filter to be used by the search. If none is given in the URI then the return value defaults to "(objectClass=*)". That's the fallback queen right there 👑
• $uri->_filter( [$new_filter] ) — Same as filter(), but does not default to anything. No net, no defaults, just vibes 💀
• $uri->extensions( [$etype => $evalue,...] ) — Sets or gets the extensions used for the search. The list passed should be in the form etype1 => evalue1, etype2 => evalue2,... — and ngl, that's also the form of list that gets returned. Symmetry, we stan 🌈

---

🔥 SEE ALSO 🔥

The RFC herself, go read it bestie: <http://tools.ietf.org/html/rfc2255>

---

🌟 AUTHOR 🌟

Graham Barr <gbarr@pobox.com> — original icon 👑

Slightly modified by Gisle Aas to fit into the URI distribution. Teamwork fr fr 🫶

---

🧚 COPYRIGHT 🧚

Copyright (c) 1998 Graham Barr. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

Quick reminder bestie: values go in unescaped, scope() and filter() have defaults, and the underscore versions (_scope, _filter) do not. Don't mix 'em up 💅

---

And that's the page! 🎀 Source: perl v5.42.0, dated 2026-09-02 — that's URI::ldap(3), from the User Contributed Perl Documentation, mwah 💋