Docs For Class Net

Net_LDAP (Constructor) [line 187]

void Net_LDAP(
[array
$config = array()])

Net_LDAP constructor

Sets the config array

Please note that the usual way of getting Net_LDAP to work is to call something like:

$ldap = Net_LDAP::connect($ldap_config);

See: $_config
Access: protected

Parameters:

array $config — Configuration array

[ Top ]

add [line 521]

Net_LDAP_Error|true add(
Net_LDAP_Entry
&$entry)

Add a new entryobject to a directory.

Use add to add a new Net_LDAP_Entry object to the directory. This also links the entry to the connection used for the add, if it was a fresh entry (Net_LDAP_Entry::createFresh())

Return: Net_LDAP_Error object or true

Parameters:

Net_LDAP_Entry &$entry — Net_LDAP_Entry

[ Top ]

bind [line 270]

Net_LDAP_Error|true bind(
[string
$dn = null], [string
$password = null])

Bind or rebind to the ldap-server

This function binds with the given dn and password to the server. In case no connection has been made yet, it will be startet and startTLS issued if appropiate.

The internal bind configuration is not being updated, so if you call bind() without parameters, you can rebind with the credentials provided at first connecting to the server.

Return: Net_LDAP_Error object or true
Access: public

Parameters:

string	`$dn`	—	Distinguished name for binding
string	`$password`	—	Password for binding

[ Top ]

checkLDAPExtension [line 1235]

Net_LDAP_Error|true checkLDAPExtension(
)

Checks if phps ldap-extension is loaded

If it is not loaded, it tries to load it manually using PHPs dl(). It knows both windows-dll and *nix-so.

[ Top ]

connect [line 152]

Net_LDAP_Error|Net_LDAP &connect(
[array
$config = array()])

Creates the initial ldap-object

Static function that returns either an error object or the new Net_LDAP object. Something like a factory. Takes a config array with the needed parameters.

Return: Net_LDAP_Error or Net_LDAP object
Access: public

Parameters:

array $config — Configuration array

[ Top ]

copy [line 994]

Net_LDAP_Error|Net_LDAP_Entry &copy(
string|Net_LDAP_Entry
&$entry, string
$newdn)

Copy an entry to a new location

The entry will be immediately copied. If you pass an Net_LDAP_Entry object, the source entry is not required to be existent on this LDAP server, which can be used to copy between directory servers.

Return: Error Message or reference to the copied entry

Parameters:

string\|Net_LDAP_Entry	`&$entry`	—	Entry DN or Entry object
string	`$newdn`	—	New location

[ Top ]

delete [line 553]

Net_LDAP_Error|true delete(
string|Net_LDAP_Entry
$dn, [boolean
$recursive = false])

Delete an entry from the directory

The object may either be a string representing the dn or a Net_LDAP_Entry object. When the boolean paramter recursive is set, all subentries of the entry will be deleted as well.

Return: Net_LDAP_Error object or true
Access: public

Parameters:

string\|Net_LDAP_Entry	`$dn`	—	DN-string or Net_LDAP_Entry
boolean	`$recursive`	—	Should we delete all children recursive as well?

[ Top ]

dnExists [line 870]

boolean dnExists(
string
$dn)

Tell if a DN does exist in the directory

Parameters:

string $dn — The DN of the object to test

[ Top ]

done [line 495]

void done(
)

Close LDAP connection.

Closes the connection. Use this when the session is over.

[ Top ]

errorMessage [line 1026]

string errorMessage(
int
$errorcode)

Returns the string for an ldap errorcode.

Made to be able to make better errorhandling Function based on DB::errorMessage() Tip: The best description of the errorcodes is found here: http://www.directory-info.com/LDAP/LDAPErrorCodes.html

Return: The errorstring for the error.

Parameters:

int $errorcode — Error code

[ Top ]

getEntry [line 909]

Net_LDAP_Entry|Net_LDAP_Error &getEntry(
string
$dn, [array
$attr = array()])

Get a specific entry based on the DN

Return: Reference to a Net_LDAP_Entry object or Net_LDAP_Error object
Todo: Maybe check against the shema should be done to be sure the attribute type exists

Parameters:

string	`$dn`	—	DN of the entry that should be fetched
array	`$attr`	—	Array of Attributes to select

[ Top ]

getLDAPVersion [line 837]

int getLDAPVersion(
)

Get the LDAP_PROTOCOL_VERSION that is used on the connection.

A lot of ldap functionality is defined by what protocol version the ldap server speaks. This might be 2 or 3.

[ Top ]

getLink [line 1336]

resource &getLink(
)

Get the LDAP link

Return: LDAP link
Access: public

[ Top ]

getOption [line 805]

Net_LDAP_Error|string getOption(
string
$option)

Get an LDAP option value

Return: Net_LDAP_Error or option value
Access: public

Parameters:

string $option — Option to get

[ Top ]

getVersion [line 135]

string getVersion(
)

Returns the Net_LDAP Release version, may be called statically

Return: Net_LDAP version

[ Top ]

isError [line 1106]

boolean isError(
mixed
$var)

Tell whether variable is a Net_LDAP_Error or not

Access: public

Parameters:

mixed $var — A variable, most commonly some Net_LDAP* object

[ Top ]

modify [line 621]

Net_LDAP_Error|true modify(
string|Net_LDAP_Entry
&$entry, [array
$parms = array()])

Modify an ldapentry directly on the server

This one takes the DN or a Net_LDAP_Entry object and an array of actions. This array should be something like this:

array('add' => array('attribute1' => array('val1', 'val2'), 'attribute2' => array('val1')), 'delete' => array('attribute1'), 'replace' => array('attribute1' => array('val1')), 'changes' => array('add' => ..., 'replace' => ..., 'delete' => array('attribute1', 'attribute2' => array('val1')))

The changes array is there so the order of operations can be influenced (the operations are done in order of appearance). The order of execution is as following:

adds from 'add' array
deletes from 'delete' array
replaces from 'replace' array
changes (add, replace, delete) in order of appearance

All subarrays (add, replace, delete, changes) may be given at the same time.

The function calls the corresponding functions of an Net_LDAP_Entry object. A detailed description of array structures can be found there.

Unlike the modification methods provided by the Net_LDAP_Entry object, this method will instantly carry out an update() after each operation, thus modifying "directly" on the server.

Return: Net_LDAP_Error object or true
Access: public

Parameters:

string\|Net_LDAP_Entry	`&$entry`	—	DN-string or Net_LDAP_Entry
array	`$parms`	—	Array of changes

[ Top ]

move [line 943]

Net_LDAP_Error|true move(
string|Net_LDAP_Entry
&$entry, string
$newdn, [Net_LDAP
$target_ldap = null])

Rename or move an entry

This method will instantly carry out an update() after the move, so the entry is moved instantly. You can pass an optional Net_LDAP object. In this case, a cross directory move will be performed which deletes the entry in the source (THIS) directory and adds it in the directory $target_ldap.

Parameters:

string\|Net_LDAP_Entry	`&$entry`	—	Entry DN or Entry object
string	`$newdn`	—	New location
Net_LDAP	`$target_ldap`	—	(optional) Target directory for cross server move; should be passed via reference

[ Top ]

rootDse [line 1120]

Net_LDAP_Error|Net_LDAP_RootDSE &rootDse(
[array
$attrs = null])

Gets a rootDSE object

Return: Net_LDAP_Error or Net_LDAP_RootDSE object
Author: Jan Wagner <wagner@netsols.de>
Access: public

Parameters:

array $attrs — Array of attributes to search for

[ Top ]

root_dse [line 1152]

Net_LDAP_Error|Net_LDAP_RootDSE &root_dse(
)

Alias function of rootDse() for perl-ldap interface

See: Net_LDAP::rootDse()
Access: public

[ Top ]

schema [line 1167]

Net_LDAP_Schema|Net_LDAP_Error &schema(
[string
$dn = null])

Get a schema object

Return: Net_LDAP_Schema or Net_LDAP_Error object
Author: Jan Wagner <wagner@netsols.de>
Access: public

Parameters:

string $dn — Subschema entry dn

[ Top ]

search [line 693]

Net_LDAP_Search|Net_LDAP_Error search(
[string
$base = null], [string|Net_LDAP_Filter
$filter = null], [array
$params = array()])

Run a ldap query

Search is used to query the ldap-database. $base and $filter may be ommitted.The one from config will then be used. Params may contain:

scope: The scope which will be used for searching base - Just one entry sub - The whole tree one - Immediately below $base sizelimit: Limit the number of entries returned (default: 0 = unlimited), timelimit: Limit the time spent for searching (default: 0 = unlimited), attrsonly: If true, the search will only return the attribute names, attributes: Array of attribute names, which the entry should contain. It is good practice to limit this to just the ones you need. [NOT IMPLEMENTED] deref: By default aliases are dereferenced to locate the base object for the search, but not when searching subordinates of the base object. This may be changed by specifying one of the following values:

never - Do not dereference aliases in searching or in locating the base object of the search. search - Dereference aliases in subordinates of the base object in searching, but not in locating the base object of the search. find always

Return: Net_LDAP_Search object or Net_LDAP_Error object
Access: public

Parameters:

string	`$base`	—	LDAP searchbase
string\|Net_LDAP_Filter	`$filter`	—	LDAP search filter or a Net_LDAP_Filter object
array	`$params`	—	Array of options

[ Top ]

setLDAPVersion [line 854]

Net_LDAP_Error|true setLDAPVersion(
[int
$version = 0])

Set the LDAP_PROTOCOL_VERSION that is used on the connection.

Return: Net_LDAP_Error object or true

Parameters:

int $version — LDAP-version that should be used

[ Top ]

setOption [line 773]

Net_LDAP_Error|true setOption(
string
$option, mixed
$value)

Set an LDAP option

Return: Net_LDAP_Error object or true
Access: public

Parameters:

string	`$option`	—	Option to set
mixed	`$value`	—	Value to set Option to

[ Top ]

startTLS [line 466]

Net_LDAP_Error|true startTLS(
)

Starts an encrypted session

Return: Net_LDAP_Error object or true
Access: public

[ Top ]

start_tls [line 482]

void start_tls(
)

alias function of startTLS() for perl-ldap interface

See: Net_LDAP::startTLS()

[ Top ]

utf8Decode [line 1269]

array utf8Decode(
array
$attributes)

Decodes the given attribute values

Return: Array with decoded attribute values
Access: public

Parameters:

array $attributes — Array of attributes

[ Top ]

utf8Encode [line 1256]

array utf8Encode(
array
$attributes)

Encodes given attributes to UTF8 if needed

This function takes attributes in an array and then checks against the schema if they need UTF8 encoding. If that is so, they will be encoded. An encoded array will be returned and can be used for adding or modifying.

Return: Array of UTF8 encoded attributes
Access: public

Parameters:

array $attributes — Array of attributes

[ Top ]

Class: Net_LDAP

Class Overview

Author(s):

Version:

Copyright:

Methods

Inherited Variables

Inherited Methods

Class Details

Method Detail

Net_LDAP (Constructor) [line 187]

Parameters:

add [line 521]

Parameters:

bind [line 270]

Parameters:

checkLDAPExtension [line 1235]

connect [line 152]

Parameters:

copy [line 994]

Parameters:

delete [line 553]

Parameters:

dnExists [line 870]

Parameters:

done [line 495]

errorMessage [line 1026]

Parameters:

getEntry [line 909]

Parameters:

getLDAPVersion [line 837]

getLink [line 1336]

getOption [line 805]

Parameters:

getVersion [line 135]

isError [line 1106]

Parameters:

modify [line 621]

Parameters:

move [line 943]

Parameters:

rootDse [line 1120]

Parameters:

root_dse [line 1152]

schema [line 1167]

Parameters:

search [line 693]

Parameters:

setLDAPVersion [line 854]

Parameters:

setOption [line 773]

Parameters:

startTLS [line 466]

start_tls [line 482]

utf8Decode [line 1269]

Parameters:

utf8Encode [line 1256]

Parameters: