VladPolskiy/php-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2025-08-15 23:42:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update to En ldap-get-values.xml

Browse Source
This commit is contained in:
Mikhail Alferov
2024-09-13 18:02:28 +03:00
committed by GitHub
parent fb89f1de64
commit cc67801499
1 changed files with 23 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
reference/ldap/functions/ldap-get-values.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: bc90525a5a5ebcf8412ef34b8355d2de12166fff Maintainer: bfl Status: ready -->
<!-- EN-Revision: e50e79746736dbdfbabe9bd3566793b3ddf38f58 Maintainer: bfl Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.ldap-get-values" xmlns="http://docbook.org/ns/docbook">
@ -17,19 +17,17 @@
<methodparam><type>string</type><parameter>attribute</parameter></methodparam>
</methodsynopsis>
<para>
Читает все значения атрибута в записи результата.
Функция Считывает все значения атрибута в записи результата.
</para>
<para>
Эта функция требует <parameter>entry</parameter>,
а следовательно, перед ней должны быть запущена одна из функций
ldap поиска и один из результатов их вызова для получения отдельной
записи.
Для вызова функции требуется запись <parameter>entry</parameter>,
поэтому перед вызовом требуется запустить функцию
LDAP-поиска и вызывать функцию, которая получит отдельную запись.
</para>
<para>
В создаваемом приложении необходимо будет использовать сложные конструкции
для поиска определённых атрибутов (таких как "фамилия" или "почта")
или необходимо будет использовать функцию <function>ldap_get_attributes</function>,
чтобы разобрать, какие атрибуты существуют для данной записи.
Приложение либо будет жестко запрограммировано на поиск конкретных атрибутов
наподобие "surname" или "mail", либо придётся вызывать функцию <function>ldap_get_attributes</function>,
чтобы разобрать, какие атрибуты существуют для записи.
</para>
</refsect1>
@ -67,17 +65,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает массив значений для атрибута в случае успешного выполнения или &false;
в случае возникновения ошибки. Число значений может быть найдено по индексу
"count" в результирующем массиве. Отдельные значения могут быть
Функция возвращает массив значений для атрибута в случае успешного выполнения или &false;,
если возникла ошибка. Число значений находят по индексу
"count" в результирующем массиве. Отдельные значения
доступны по целочисленным индексам в массиве.
Первый индекс 0.
Значение первого индекса равно 0.
</para>
<para>
LDAP позволяет хранить больше чем одну запись для атрибута, таким
образом, можно, например, сохранить много адресов электронной почты
для записи каталога одного человека, все маркированные атрибутом
"mail"
LDAP-сервер разрешает хранить больше одной записи для атрибута, поэтому
разрешается, например, сохранить много адресов электронной почты
для записи каталога одного человека, каждый из которых маркирован атрибутом
"mail".
<informalexample>
<literallayout>
return_value["count"] = число значений атрибута
@ -114,20 +112,22 @@
<programlisting role="php">
<![CDATA[
<?php
// $ds допустимый экземпляр LDAP\Connection
// $sr верный результат поиска в директории ldap
// Переменная $ds — допустимый экземпляр класса LDAP\Connection
// $entry верный идентификатор записи из вызова функции
// вернувшей запись директории
// Переменная $sr — правильный результат поиска в LDAP-директории
// Переменная $entry — правильный идентификатор записи из вызова функции,
// которая вернула запись директории
$values = ldap_get_values($ds, $entry, "mail");
echo $values["count"] . " адреса email для этой записи.<br />";
echo "Количество адресов эл. почты для этой записи: " . $values["count"] . "<br />";
for ($i=0; $i < $values["count"]; $i++) {
echo $values[$i] . "<br />";
}
?>
]]>
</programlisting>