ldap_first_attribute(3) [php man page]

LDAP_FIRST_ATTRIBUTE(3) 						 1						   LDAP_FIRST_ATTRIBUTE(3)

ldap_first_attribute - Return first attribute

SYNOPSIS

       string ldap_first_attribute (resource  $link_identifier, resource  $result_entry_identifier)

DESCRIPTION

	Gets the first attribute in the given entry. Remaining attributes are retrieved by calling ldap_next_attribute(3) successively.

	Similar to reading entries, attributes are also read one by one from a particular entry.

PARAMETERS

	      o $link_identifier
		- An LDAP link identifier, returned by ldap_connect(3).

	      o $result_entry_identifier
		-

	      o $ber_identifier
		-$ber_identifier  is  the  identifier  to internal memory location pointer. It is passed by reference. The same $ber_identifier is
		passed to ldap_next_attribute(3) , which modifies that pointer.

	      Note

		      This parameter is no longer used as this is now handled automatically by PHP. For backwards compatibility PHP will not throw
		     an error if this parameter is passed.

RETURN VALUES

	Returns the first attribute in the entry on success and FALSE on error.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.2.4	|						    |
       |	|						    |
       |	|  The	$ber_identifier  was  removed.	This is now |
       |	| handled automatically by PHP. 		    |
       |	|						    |
       +--------+---------------------------------------------------+
SEE ALSO

       ldap_next_attribute(3), ldap_get_attributes(3).

PHP Documentation Group 												   LDAP_FIRST_ATTRIBUTE(3)

LDAP_GET_ATTRIBUTES(3)							 1						    LDAP_GET_ATTRIBUTES(3)

ldap_get_attributes - Get attributes from a search result entry

SYNOPSIS

       array ldap_get_attributes (resource  $link_identifier, resource	$result_entry_identifier)

DESCRIPTION

	Reads attributes and values from an entry in the search result.

	Having	located  a specific entry in the directory, you can find out what information is held for that entry by using this call. You would
       use this call for an application which "browses" directory entries and/or where you do not know the structure of the directory entries.	In
       many  applications  you will be searching for a specific attribute such as an email address or a surname, and won't care what other data is
       held.

       return_value["count"] = number of attributes in the entry
       return_value[0] = first attribute
       return_value[n] = nth attribute

       return_value["attribute"]["count"] = number of values for attribute
       return_value["attribute"][0] = first value of the attribute
       return_value["attribute"][i] = (i+1)th value of the attribute

PARAMETERS

	      o $link_identifier
		- An LDAP link identifier, returned by ldap_connect(3).

	      o $result_entry_identifier
		-

RETURN VALUES

	Returns a complete entry information in a multi-dimensional array on success and FALSE on error.

EXAMPLES

       Example #1

	       Show the list of attributes held for a particular directory entry

	      <?php
	      // $ds is the link identifier for the directory

	      // $sr is a valid search result from a prior call to
	      // one of the ldap directory search calls

	      $entry = ldap_first_entry($ds, $sr);

	      $attrs = ldap_get_attributes($ds, $entry);

	      echo $attrs["count"] . " attributes held for this entry:<p>";

	      for ($i=0; $i < $attrs["count"]; $i++) {
		  echo $attrs[$i] . "<br />";
	      }
	      ?>

SEE ALSO

       ldap_first_attribute(3), ldap_next_attribute(3).

PHP Documentation Group 												    LDAP_GET_ATTRIBUTES(3)