PHP

您所在的位置:网站首页 目录服务器中的OU代表什么 PHP

PHP

2023-07-04 21:41| 来源: 网络整理| 查看: 265

ldap_search

(PHP 4, PHP 5, PHP 7, PHP 8)

ldap_search-搜索LDAP树

Description ldap_search( LDAP\Connection|array $ldap, array|string $base, array|string $filter, array $attributes = [], int $attributes_only = 0, int $sizelimit = -1, int $timelimit = -1, int $deref = LDAP_DEREF_NEVER, ?array $controls = null ): LDAP\Result|array|false

在 LDAP_SCOPE_SUBTREE 范围内的目录上执行指定过滤器的搜索。这等效于搜索整个目录。

从4.0.5开始,还可以进行并行搜索。为此,您可以使用一个链接标识符数组而不是单个标识符作为第一个参数。如果您不想为所有搜索使用相同的基本DN和相同的过滤器,则还可以使用基本DN的数组和/或过滤器的数组。这些数组的大小必须与链接标识符数组的大小相同,因为该数组的第一个条目用于一个搜索,第二个条目用于另一个搜索,依此类推。并行搜索时,将返回搜索结果标识符数组,除非出现错误,否则与搜索相对应的条目将为 false 。这非常类似于通常返回的值,除了在进行搜索时始终返回结果标识符。在极少数情况下,正常搜索返回 false ,而并行搜索返回标识符。

Parameters ldap

一个LDAP \连接例如,通过返回ldap_connect() 。

base

目录的基础DN。

filter

搜索过滤器可以是简单的或高级的,使用 LDAP 文档中描述的格式的布尔运算符(有关过滤器的完整信息,请参阅» Netscape Directory SDK或» RFC4515)。

attributes

所需属性的数组,例如 array("mail", "sn", "cn") 。请注意,无论请求哪种属性类型,始终都会返回“ dn”。

使用这个参数比默认操作(即返回所有属性及其相关的值)更有效率。因此,使用这个参数应该被认为是良好的做法。

attributes_only

如果只想获取属性类型,应该设置为1,如果设置为0,则会同时获取属性类型和属性值,这是默认行为。如果设置为0,则会同时获取属性类型和属性值,这是默认行为。

sizelimit

可用于限制获取的条目数。设置为0表示没有限制。

Note:

这个参数不能覆盖服务器端预设的大小限制。但您可以将其设置得更低。

一些目录服务器主机将被配置为只返回不超过预设数量的条目。如果发生这种情况,服务器将表明它只返回了部分结果集。如果使用此参数来限制获取的条目数,也会出现这种情况。

timelimit

设置搜索时间的秒数。设置为0表示没有限制。

Note:

这个参数不能覆盖服务器端预设的时间限制。但您可以将其设置得更低。

deref

指定在搜索过程中如何处理别名。它可以是下列之一:

LDAP_DEREF_NEVER -(默认)别名从不取消引用。 LDAP_DEREF_SEARCHING -别名应在搜索过程中取消引用,但在查找搜索的基础对象时则应取消引用。 LDAP_DEREF_FINDING -在查找基础对象时(而不是在搜索过程中)应取消引用别名。 LDAP_DEREF_ALWAYS -别名应始终取消引用。 controls

与请求一起发送的LDAP控件数组。

Return Values

返回LDAP\Result实例,失败时返回 false 。

Changelog Version Description 8.1.0 的 ldap 参数期望的LDAP \连接现在实例; 以前,需要资源。 8.1.0 现在返回一个LDAP\Result实例;之前,返回了一个资源。 8.0.0 controls 现在可以为空;以前,它默认为 [] 。 7.3 支持添加 controls Examples

下面的示例检索“我的公司”中所有人员的组织单位,姓氏,给定名称和电子邮件地址,其中姓氏或给定名称包含子字符串 $person 。本示例使用布尔过滤器告诉服务器在多个属性中查找信息。

Example#1 LDAP搜索



【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3