ldap_rename

(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

ldap_renameModifica o nome de uma entrada

Descrição

ldap_rename(
    LDAP\Connection $ldap,
    string $dn,
    string $new_rdn,
    string $new_parent,
    bool $delete_old_rdn,
    ?array $controls = null
): bool

A entrada especificada por dn é renomeada/movida.

Parâmetros

ldap

Uma instância de LDAP\Connection, retornada por ldap_connect().

dn

O nome distinto de uma entidade LDAP.

new_rdn

O novo RDN.

new_parent

A nova entrada superior na hierarquia.

delete_old_rdn

Se for igual a true, os valores antigos da RDN são removidos, caso contrário os valores antigos da RDN são retidos como valores não distintos da entrada.

controls

Array de Controles LDAP a enviar com a requisição.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro ldap agora espera uma instância de LDAP\Connection; anteriormente, um resource ldap link válido era esperado.
8.0.0 O parâmetro controls agora pode ser nulo; anteriormente, o padrão era [].
7.3.0 Adicionado suporte para controls.

Notas

Note:

Esta função atualmente só funciona com LDAPv3. Pode ser necessário usar ldap_set_option() antes de realizar a ligação para usar LDAPv3. Esta função só está disponível ao usar OpenLDAP 2.x.x OU Netscape Directory SDK x.x.

Veja Também