略微加速

PHP官方手册 - 互联网笔记

PHP - Manual: ldap_sort

2024-11-15

ldap_sort

(PHP 4 >= 4.2.0, PHP 5, PHP 7)

ldap_sortSort LDAP result entries on the client side

警告

此函数自 PHP 7.0.0 起弃用且 PHP 8.0.0 起删除。强烈建议不要应用此特性。

说明

ldap_sort(resource $link, resource $result, string $sortfilter): bool

Sort the result of a LDAP search, returned by ldap_search().

As this function sorts the returned values on the client side it is possible that you might not get the expected results in case you reach the sizelimit either of the server or defined within ldap_search().

参数

link

An LDAP resource, returned by ldap_connect().

result

An search result identifier, returned by ldap_search().

sortfilter

The attribute to use as a key in the sort.

返回值

没有返回值。

更新日志

版本 说明
8.0.0 This function has been removed.

范例

Sorting the result of a search.

示例 #1 LDAP sort

<?php
     
// $ds is a valid link identifier (see ldap_connect)

     
$dn        'ou=example,dc=org';
     
$filter    '(|(sn=Doe*)(givenname=John*))';
     
$justthese = array('ou''sn''givenname''mail');

     
$sr ldap_search($ds$dn$filter$justthese);

     
// Sort
     
ldap_sort($ds$sr'sn');

     
// Retrieving the data
     
$info ldap_get_entries($ds$sr);
add a noteadd a note

User Contributed Notes 7 notes

up
5
zbaizman at yahoo dot com
17 years ago
This note may be self-evident, but the functionality of ldap_sort threw off this sometime user of relational databases.

The following code will NOT do what you expect:

<?php

// omitted calls to connect and and bind to LDAP server...

// attributes we want to retrieve from LDAP server
$ldap_attributes = array ( 'cn', 'o', 'mail' ) ;

// retrieve attributes from matching entries
$search_results = ldap_search ( $ldap_conn, 'dc=example,dc=org', '(objectclass=*)', 0, 500, 30 ) ;

// sort entries by last name ('sn')
ldap_sort ( $ldap_conn, $search_results, 'sn' ) ;

?>

The entries will NOT be sorted by last name. Why not? Because LDAP doesn't function like a RDBMS; you cannot sort a result set on an arbitrary field, regardless of whether you "selected" it. You must always include the attribute by which you want to sort your entries among the requested attributes (add 'sn' to $ldap_attributes, in this case).

Hope this is helpful to some other folks who scratched their heads when they tried to sort entries and it didn't work out...
up
2
askgopal at sify dot com
18 years ago
Here's a simple LDAP sort function I wrote:

<?php
function sort_ldap_entries($e, $fld, $order)
{
    for (
$i = 0; $i < $e['count']; $i++) {
        for (
$j = $i; $j < $e['count']; $j++) {
           
$d = strcasecmp($e[$i][$fld][0], $e[$j][$fld][0]);
            switch (
$order) {
            case
'A':
                if (
$d > 0)
                   
swap($e, $i, $j);
                break;
            case
'D':
                if (
$d < 0)
                   
swap($e, $i, $j);
                break;
            }
        }
    }
    return (
$e);
}

function
swap(&$ary, $i, $j)
{
   
$temp = $ary[$i];
   
$ary[$i] = $ary[$j];
   
$ary[$j] = $temp;
}
?>

so that it can be invoked like:

<?php
    $entries
= sort_ldap_entries($entries, 'mail', 'A'); // sort entries by ascending order of mail
?>

where,
    `$entries' is the array returned by ldap_get_entries() function.

This might be useful to those who still run older versions of PHP (<= 4.2.0) on their web servers :-)
up
1
thorben at kapp-hamburg dot de
11 years ago
I wondered how to sort after a dn, for just show a tree view. I tried to set $sortfilter = 'dn', but that didn't work. Than I tried with a blank string ''. That worked, the entries are sorted by dn.
up
1
ben at xsusio dot com
17 years ago
If you are wanting to sort by multiple attributes, for instance ordering by last name and then first name,  try this function. This is similar to "ORDER BY lastname, firstname"  in SQL.

This function uses an insertion sort algorithm, which is somewhat faster then the old-fashoned bubble sort.  The second argument is an array containing the attributes you want to sort by. (this functon won't do descending or ascending..  feel free to add it!)

<?php
/**
* @param array $entries
* @param array $attribs
* @desc Sort LDAP result entries by multiple attributes.
*/
function ldap_multi_sort(&$entries, $attribs){
    for (
$i=1; $i<$entries['count']; $i++){
       
$index = $entries[$i];
       
$j=$i;
        do {
           
//create comparison variables from attributes:
           
$a = $b = null;
            foreach(
$attribs as $attrib){
               
$a .= $entries[$j-1][$attrib][0];
               
$b .= $index[$attrib][0];
            }
           
// do the comparison
           
if ($a > $b){
               
$is_greater = true;
               
$entries[$j] = $entries[$j-1];
               
$j = $j-1;
            }else{
               
$is_greater = false;
            }
        } while (
$j>0 && $is_greater);
       
       
$entries[$j] = $index;
    }
    return
$entries;
}
?>
up
1
matthew dot j dot gray at uwrf dot edu
19 years ago
This function applies strcmp() to each attribute (given by sortfilter) in order to sort the entries returned by the server.  To order search results ascending by last name, try passing "sn" as the sortfilter argument.  This function does not play nice with multi-valued attributes.
up
0
jason dot sokolowski at rotork dot com
19 years ago
Something real simple i wrote to sort directory searches by a persons last name.

<?php
for($i=0;$i<$result["count"];$i++)
{

$lastname = $result[$i]["sn"][0];

$lnames["$i"]=$lastname;

}
//for i

@asort($lnames);
?>
up
-14
fbernardi at bbros dot it
6 years ago
In order to order by multiple fields you can order your array many times:
For example:

        ldap_sort($link, $result, 'givenname');
        ldap_sort($link, $result, 'sn');

官方地址:https://www.php.net/manual/en/function.ldap-sort.php

北京半月雨文化科技有限公司.版权所有 京ICP备12026184号-3