array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.ldap-set-option.php', 1 => 'ldap_set_option', ), 'up' => array ( 0 => 'ref.ldap.php', 1 => 'LDAP Funciones', ), 'prev' => array ( 0 => 'function.ldap-search.php', 1 => 'ldap_search', ), 'next' => array ( 0 => 'function.ldap-set-rebind-proc.php', 1 => 'ldap_set_rebind_proc', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/ldap/functions/ldap-set-option.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
ldap_set_option — Establecer el valor de la opción proporcionada
Establece el valor de la opción especificada a newval
.
link_identifier
Un identificador de enlace de LDAP, devuelto por ldap_connect().
option
El parámetro option
puede ser uno de estos:
LDAP_OPT_SERVER_CONTROLS
y
LDAP_OPT_CLIENT_CONTROLS
solicitan una lista de
controles, lo que significa que el valor debe ser un array de controles. Un
control consiste en un oid identificando el control,
un value opcional, y un indicador opcional representado por
criticality. En PHP un control es proporcionado por un
array que contiene un elemento con la clave oid,
una cadena de valor, y dos elementos opcionales. Los elementos
opcionales son la clave value con un valor de tipo cadena,
y la clave iscritical con un valor de tipo booleano.
El valor de la clave iscritical de forma predeterminada es false
si no es provisto. Vea » draft-ietf-ldapext-ldap-c-api-xx.txt
para más detalles. Vea también el segundo ejemplo a continuación.
newval
El nuevo valor para el option
especificado.
Ejemplo #1 Establecer la versión del protocolo
<?php
// $ds es un identificador de enlace válido para un servidor de directorio
if (ldap_set_option($ds, LDAP_OPT_PROTOCOL_VERSION, 3)) {
echo "Utilizando LDAPv3";
} else {
echo "Falló al establcer la versión 3 del protocolo";
}
?>
Ejemplo #2 Establecer controles del servidor
<?php
// $ds es un identificador de enlace válido para un servidor de directorio
// control sin valor
$ctrl1 = array("oid" => "1.2.752.58.10.1", "iscritical" => true);
// iscritical de forma predeterminada está en FALSE
$ctrl2 = array("oid" => "1.2.752.58.1.10", "value" => "magic");
// intentar establecer ambos controles
if (!ldap_set_option($ds, LDAP_OPT_SERVER_CONTROLS, array($ctrl1, $ctrl2))) {
echo "Falló al establecer los controles del servidor";
}
?>
Nota:
Esta función está disponible solamente cuando se utiliza OpenLDAP 2.x.x ó Netscape Directory SDK x.x.