ldap_set_option

パラメータ

ldap

特定の接続に対してオプションを設定する場合は、 ldap_connect() が返す、 LDAP\Connection クラスのインスタンス。 オプションをグローバルに設定する場合は、 null を設定します。

option

パラメータ option は以下のいずれかとなります。

オプション	型	～以降で使用可能
LDAP_OPT_DEREF	int
LDAP_OPT_SIZELIMIT	int
LDAP_OPT_TIMELIMIT	int
LDAP_OPT_NETWORK_TIMEOUT	int
LDAP_OPT_PROTOCOL_VERSION	int
LDAP_OPT_ERROR_NUMBER	int
LDAP_OPT_REFERRALS	bool
LDAP_OPT_RESTART	bool
LDAP_OPT_HOST_NAME	string
LDAP_OPT_ERROR_STRING	string
LDAP_OPT_DIAGNOSTIC_MESSAGE	string
LDAP_OPT_MATCHED_DN	string
LDAP_OPT_SERVER_CONTROLS	array
LDAP_OPT_CLIENT_CONTROLS	array
LDAP_OPT_X_KEEPALIVE_IDLE	int	PHP 7.1.0
LDAP_OPT_X_KEEPALIVE_PROBES	int	PHP 7.1.0
LDAP_OPT_X_KEEPALIVE_INTERVAL	int	PHP 7.1.0
LDAP_OPT_X_TLS_CACERTDIR	string	PHP 7.1.0
LDAP_OPT_X_TLS_CACERTFILE	string	PHP 7.1.0
LDAP_OPT_X_TLS_CERTFILE	string	PHP 7.1.0
LDAP_OPT_X_TLS_CIPHER_SUITE	string	PHP 7.1.0
LDAP_OPT_X_TLS_CRLCHECK	int	PHP 7.1.0
LDAP_OPT_X_TLS_CRLFILE	string	PHP 7.1.0
LDAP_OPT_X_TLS_DHFILE	string	PHP 7.1.0
LDAP_OPT_X_TLS_KEYFILE	string	PHP 7.1.0
LDAP_OPT_X_TLS_PROTOCOL_MIN	int	PHP 7.1.0
LDAP_OPT_X_TLS_PROTOCOL_MAX	int	PHP 8.4.0
LDAP_OPT_X_TLS_RANDOM_FILE	string	PHP 7.1.0
LDAP_OPT_X_TLS_REQUIRE_CERT	int	PHP 7.0.5

LDAP_OPT_SERVER_CONTROLS および LDAP_OPT_CLIENT_CONTROLS はコントロールのリストが必要です。 つまり、値がコントロールの配列である必要があるということです。 コントロールは、そのコントロールの ID である oid、オプションの value、オプションのフラグ criticality からなります。PHP において、 コントロールはキーが oid で値が文字列、 二つのオプションの要素からなる配列で指定されます。オプションの要素は、 キーが value で値が文字列、そしてキーが iscritical で値が論理値となります。 iscritical を省略した場合のデフォルトは false です。詳細は » draft-ietf-ldapext-ldap-c-api-xx.txt を参照ください。また以下の二番目の例も参照ください。

注意:

全ての TLS オプションは、 LDAP 接続の場合 ldap_connect() を呼ぶ前か、 ldap_start_tls() を使用した接続の前に、 グローバルに設定する必要があります。

value

指定したオプション option の新しい値。