ldap_errno - PHP code example

PHP Function LDAP_ERRNO

PHP’s built-in support for LDAP makes it easy to use an LDAP directory server to store and retrieve user information. In this article, we’ll take a closer look at the steps involved in a basic LDAP session, and explore how php function ldap_errno makes it possible to record and display errors from LDAP commands.

What is a PHP Function?

A PHP function is a small piece of code that performs a specific task and can be reused in multiple contexts. A function is like a recipe, with a name and a set of parameters that determine how the code will work. The function is called when you need to use it. Arguments are the values that the function takes in, and they are passed by value to the function. You can pass as many arguments as you need, but they must be separated by commas. If you want to ensure that your function’s return value is of a certain type, you can enable PHP’s strict function declarations feature.

In the example above, we connect to an LDAP server with ldap_bind(), and then use the ldap_search() function to query the server for entry data. The first value that we need is the base DN of the entry – this is usually the DN of the person or group who owns the entry. The second value is the search filter, which will define the attributes that should be included in the result set.

ldap_errno example

    public function bind(string $dn = null, #[\SensitiveParameter] string $password = null)     {
        if (!$this->connection) {
            $this->connect();
        }

        if (false === @ldap_bind($this->connection, $dn, $password)) {
            $error = ldap_error($this->connection);
            switch (ldap_errno($this->connection)) {
                case self::LDAP_INVALID_CREDENTIALS:
                    throw new InvalidCredentialsException($error);
                case self::LDAP_TIMEOUT:
                    throw new ConnectionTimeoutException($error);
                case self::LDAP_ALREADY_EXISTS:
                    throw new AlreadyExistsException($error);
            }
            throw new ConnectionException($error);
        }

        $this->bound = true;
    }

if ($pageControl) {
                    $this->controlPagedResult($pageSize, true, $cookie);
                }
                $sizeLimit = $itemsLeft;
                if ($pageSize > 0 && $sizeLimit >= $pageSize) {
                    $sizeLimit = 0;
                }
                $search = @$func($con, $this->dn, $this->query, $this->options['filter'], $this->options['attrsOnly'], $sizeLimit, $this->options['timeout'], $this->options['deref'], $this->serverctrls);

                if (false === $search) {
                    $ldapError = '';
                    if ($errno = ldap_errno($con)) {
                        $ldapError = sprintf(' LDAP error was [%d] %s', $errno, ldap_error($con));
                    }
                    if ($pageControl) {
                        $this->resetPagination();
                    }

                    throw new LdapException(sprintf('Could not complete search with dn "%s", query "%s" and filters "%s".%s.', $this->dn, $this->query, implode(',', $this->options['filter']), $ldapError));
                }

                $this->results[] = $search;
                $itemsLeft -= min($itemsLeft, $pageSize);

{
    }

    /** * @return $this */
    public function add(Entry $entry)
    {
        $con = $this->getConnectionResource();

        if (!@ldap_add($con, $entry->getDn(), $entry->getAttributes())) {
            throw new LdapException(sprintf('Could not add entry "%s": ', $entry->getDn()).ldap_error($con), ldap_errno($con));
        }

        return $this;
    }

    /** * @return $this */
    public function update(Entry $entry)
    {
        $con = $this->getConnectionResource();