chrmorandi\ldap\LdapUtils

Complexity

Total Complexity

12

Size/Duplication

Total Lines	88
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	1

Importance

Changes

0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	explodeDn()	0	10	4
A	implodeDn()	0	12	3
A	getRdnFromDn()	0	7	1
A	recursive_implode()	0	19	4

<?php
/**
 * This file is part of the LdapTools package.
 *
 * (c) Chad Sikorra <Chad.Sikorra@gmail.com>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace chrmorandi\ldap;


/**
 * Some common helper LDAP functions.
 *
 * @author Chad Sikorra <Chad.Sikorra@gmail.com>
 */
class LdapUtils
{
    
    /**
     * Converts a string distinguished name into its separate pieces.
     *
     * @param string $dn
     * @param int $withAttributes Set to 0 to get the attribute names along with the value.
     * @return array
     */
    public static function explodeDn($dn, $withAttributes = 1)
    {
        $pieces = ldap_explode_dn($dn, $withAttributes);

        if ($pieces === false || !isset($pieces['count']) || $pieces['count'] == 0) {
            throw new \yii\base\InvalidParamException(sprintf('Unable to parse DN "%s".', $dn));
        }
        unset($pieces['count']);
        return $pieces;
    }

    /**
     * Given a DN as an array in ['cn=Name', 'ou=Employees', 'dc=example', 'dc=com'] form, return it as its string
     * representation that is safe to pass back to a query or to save back to LDAP for a DN.
     *
     * @param array $dn
     * @return string
     */
    public static function implodeDn(array $dn)
    {
        foreach ($dn as $index => $piece) {
            $values = explode('=', $piece, 2);
            if (count($values) === 1) {
                throw new InvalidArgumentException(sprintf('Unable to parse DN piece "%s".', $values[0]));
            }
            $dn[$index] = $values[0].'='.$values[1];
        }

        return implode(',', $dn);
    }

    /**
     * Given a full escaped DN return the RDN in escaped form.
     *
     * @param string $dn
     * @return string
     */
    public static function getRdnFromDn($dn)
    {
        $rdn = self::explodeDn($dn, 0)[0];
        $rdn = explode('=', $rdn, 2);

        return $rdn[0].'='.$rdn[1];
    }
    
    /**
     * Recursively implodes an array with optional key inclusion
     * 
     * Example of $include_keys output: key, value, key, value, key, value
     * 
     * @access  public
     * @param   array   $array         multi-dimensional array to recursively implode
     * @param   string  $glue          value that glues elements together	
     * @param   bool    $include_keys  include keys before their values
     * @param   bool    $trim_all      trim ALL whitespace from string
     * @return  string  imploded array
     */ 
    public static function recursive_implode(array $array, $glue = ',', $include_keys = false, $trim_all = true)
    {
            $glued_string = '';

            // Recursively iterates array and adds key/value to glued string
            array_walk_recursive($array, function($value, $key) use ($glue, $include_keys, &$glued_string)
            {
                    $include_keys and $glued_string .= $key.$glue;

Using logical operators such as and instead of && is generally not recommended.

                    $glued_string .= $value.$glue;
            });

            // Removes last $glue from string
            strlen($glue) > 0 and $glued_string = substr($glued_string, 0, -strlen($glue));

Using logical operators such as and instead of && is generally not recommended.

            // Trim ALL whitespace
            $trim_all and $glued_string = preg_replace("/(\s)/ixsm", '', $glued_string);

Using logical operators such as and instead of && is generally not recommended.

            return (string) $glued_string;
    }

}