Skip to content

Commit 3f0223e

Browse files
lacatoirelacatoire
authored
Обновление до английской версии (#1373)
1 parent d084e46 commit 3f0223e

2 files changed

Lines changed: 146 additions & 124 deletions

File tree

‎reference/ldap/functions/ldap-exop-sync.xml‎

Lines changed: 78 additions & 67 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: db22a7cfcbc3af221f67e228336ac3e2d62aaf2c Maintainer: sergey Status: ready -->
2+
<!-- EN-Revision: 9faf0215daa7a2b5d84525d7d2b3d6b066cc85ec Maintainer: sergey Status: ready -->
33
<!-- Reviewed: no -->
44
<refentry xml:id="function.ldap-exop-sync" xmlns="http://docbook.org/ns/docbook">
55
<refnamediv>
@@ -18,84 +18,95 @@
1818
<methodparam choice="opt"><type>string</type><parameter role="reference">response_data</parameter><initializer>&null;</initializer></methodparam>
1919
<methodparam choice="opt"><type>string</type><parameter role="reference">response_oid</parameter><initializer>&null;</initializer></methodparam>
2020
</methodsynopsis>
21-
<para>
22-
23-
</para>
24-
25-
&warn.undocumented.func;
26-
21+
<simpara>
22+
Выполняет расширенную операцию для заданного соединения <parameter>ldap</parameter> с
23+
<acronym>OID</acronym> операции <parameter>request_oid</parameter> и данными
24+
<parameter>request_data</parameter>.
25+
</simpara>
2726
</refsect1>
2827

2928
<refsect1 role="parameters">
3029
&reftitle.parameters;
31-
<para>
32-
<variablelist>
33-
<varlistentry>
34-
<term><parameter>ldap</parameter></term>
35-
<listitem>
36-
<para>
37-
&ldap.parameter.ldap;
38-
</para>
39-
</listitem>
40-
</varlistentry>
41-
<varlistentry>
42-
<term><parameter>request_oid</parameter></term>
43-
<listitem>
44-
<para>
45-
46-
</para>
47-
</listitem>
48-
</varlistentry>
49-
<varlistentry>
50-
<term><parameter>request_data</parameter></term>
51-
<listitem>
52-
<para>
53-
54-
</para>
55-
</listitem>
56-
</varlistentry>
57-
<varlistentry>
58-
<term><parameter>controls</parameter></term>
59-
<listitem>
60-
<para>
61-
62-
</para>
63-
</listitem>
64-
</varlistentry>
65-
<varlistentry>
66-
<term><parameter>response_data</parameter></term>
67-
<listitem>
68-
<para>
69-
70-
</para>
71-
</listitem>
72-
</varlistentry>
73-
<varlistentry>
74-
<term><parameter>response_oid</parameter></term>
75-
<listitem>
76-
<para>
77-
78-
</para>
79-
</listitem>
80-
</varlistentry>
81-
</variablelist>
82-
</para>
30+
<variablelist>
31+
<varlistentry>
32+
<term><parameter>ldap</parameter></term>
33+
<listitem>
34+
<simpara>
35+
&ldap.parameter.ldap;
36+
</simpara>
37+
</listitem>
38+
</varlistentry>
39+
<varlistentry>
40+
<term><parameter>request_oid</parameter></term>
41+
<listitem>
42+
<simpara>
43+
<acronym>OID</acronym> запроса расширенной операции.
44+
Может быть одной из констант
45+
<constant>LDAP_EXOP_<replaceable>*</replaceable></constant>
46+
или строкой с <acronym>OID</acronym> операции.
47+
</simpara>
48+
</listitem>
49+
</varlistentry>
50+
<varlistentry>
51+
<term><parameter>request_data</parameter></term>
52+
<listitem>
53+
<simpara>
54+
Данные запроса расширенной операции.
55+
Может быть &null; для некоторых операций, например <constant>LDAP_EXOP_WHO_AM_I</constant>;
56+
также может потребоваться кодирование в <acronym>BER</acronym>.
57+
</simpara>
58+
</listitem>
59+
</varlistentry>
60+
<varlistentry>
61+
<term><parameter>controls</parameter></term>
62+
<listitem>
63+
<simpara>
64+
Массив <link linkend="ldap.controls">управляющих объектов протокола LDAP</link> для отправки в запросе.
65+
</simpara>
66+
</listitem>
67+
</varlistentry>
68+
<varlistentry>
69+
<term><parameter>response_data</parameter></term>
70+
<listitem>
71+
<simpara>
72+
Функция заполнит параметр данными расширенного ответа на операцию,
73+
если параметр задали. Если параметр не задали, получить данные
74+
можно вызовом на результирующем объекте функции <function>ldap_parse_exop</function> позже.
75+
</simpara>
76+
</listitem>
77+
</varlistentry>
78+
<varlistentry>
79+
<term><parameter>response_oid</parameter></term>
80+
<listitem>
81+
<simpara>
82+
Функция заполнит параметр значением идентификатора <acronym>OID</acronym> ответа,
83+
который обычно совпадает с <acronym>OID</acronym> запроса, если параметр задали.
84+
</simpara>
85+
</listitem>
86+
</varlistentry>
87+
</variablelist>
8388
</refsect1>
8489

8590
<refsect1 role="returnvalues">
8691
&reftitle.returnvalues;
87-
<para>
88-
89-
</para>
92+
<simpara>
93+
Функция возвращает &true; или &false;, если функцию вызвали
94+
с параметром <parameter>response_data</parameter>. Функция возвращает
95+
идентификатор ресурса или &false;, если функцию вызвали без параметра
96+
<parameter>response_data</parameter>.
97+
</simpara>
9098
</refsect1>
9199

92100
<refsect1 role="seealso">
93101
&reftitle.seealso;
94-
<para>
95-
<simplelist>
96-
<member><function>ldap_exop</function></member>
97-
</simplelist>
98-
</para>
102+
<simplelist>
103+
<member><function>ldap_exop</function></member>
104+
<member><function>ldap_exop_whoami</function></member>
105+
<member><function>ldap_exop_refresh</function></member>
106+
<member><function>ldap_exop_passwd</function></member>
107+
<member><function>ldap_parse_result</function></member>
108+
<member><function>ldap_parse_exop</function></member>
109+
</simplelist>
99110
</refsect1>
100111

101112
</refentry>

‎reference/ldap/functions/ldap-exop.xml‎

Lines changed: 68 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: b37727abaf0e731a05c516fd85b44e86f4bf5c75 Maintainer: rjhdby Status: ready -->
2+
<!-- EN-Revision: 9faf0215daa7a2b5d84525d7d2b3d6b066cc85ec Maintainer: rjhdby Status: ready -->
33
<!-- Reviewed: yes Maintainer: sergey -->
44
<refentry xml:id="function.ldap-exop" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
55
<refnamediv>
@@ -18,11 +18,17 @@
1818
<methodparam choice="opt"><type>string</type><parameter role="reference">response_data</parameter></methodparam>
1919
<methodparam choice="opt"><type>string</type><parameter role="reference">response_oid</parameter></methodparam>
2020
</methodsynopsis>
21-
<para>
22-
Выполняет расширенную операцию для заданного соединения <parameter>ldap</parameter> с OID
21+
<simpara>
22+
Выполняет расширенную операцию для заданного соединения <parameter>ldap</parameter> с <acronym>OID</acronym>
2323
операции <parameter>request_oid</parameter> и данными
2424
<parameter>request_data</parameter>.
25-
</para>
25+
</simpara>
26+
<warning>
27+
<simpara>
28+
Использование более 4 параметров объявлено устаревшим,
29+
используйте вместо этого <function>ldap_exop_sync</function>.
30+
</simpara>
31+
</warning>
2632
</refsect1>
2733

2834
<refsect1 role="parameters">
@@ -31,97 +37,104 @@
3137
<varlistentry>
3238
<term><parameter>ldap</parameter></term>
3339
<listitem>
34-
<para>
40+
<simpara>
3541
&ldap.parameter.ldap;
36-
</para>
42+
</simpara>
3743
</listitem>
3844
</varlistentry>
3945
<varlistentry>
4046
<term><parameter>request_oid</parameter></term>
4147
<listitem>
42-
<para>
43-
Идентификатор расширенной операции OID. Можно использовать одну из констант <constant>LDAP_EXOP_START_TLS</constant>, <constant>LDAP_EXOP_MODIFY_PASSWD</constant>, <constant>LDAP_EXOP_REFRESH</constant>, <constant>LDAP_EXOP_WHO_AM_I</constant>, <constant>LDAP_EXOP_TURN</constant> или строку с OID необходимой операции.
44-
</para>
48+
<simpara>
49+
<acronym>OID</acronym> запроса расширенной операции.
50+
Может быть одной из констант
51+
<constant>LDAP_EXOP_<replaceable>*</replaceable></constant>
52+
или строкой с <acronym>OID</acronym> операции.
53+
</simpara>
4554
</listitem>
4655
</varlistentry>
4756
<varlistentry>
4857
<term><parameter>request_data</parameter></term>
4958
<listitem>
50-
<para>
59+
<simpara>
5160
Данные для запроса расширенной операции. Может быть &null; для операций типа
52-
<constant>LDAP_EXOP_WHO_AM_I</constant>. Может потребоваться закодировать BER.
53-
</para>
61+
<constant>LDAP_EXOP_WHO_AM_I</constant>. Может потребоваться закодировать <acronym>BER</acronym>.
62+
</simpara>
5463
</listitem>
5564
</varlistentry>
5665
<varlistentry>
5766
<term><parameter>controls</parameter></term>
5867
<listitem>
59-
<para>
68+
<simpara>
6069
Массив <link linkend="ldap.controls">управляющих объектов протокола LDAP</link> для отправки в запросе.
61-
</para>
70+
</simpara>
6271
</listitem>
6372
</varlistentry>
6473
<varlistentry>
6574
<term><parameter>response_data</parameter></term>
6675
<listitem>
67-
<para>
76+
<simpara>
6877
Функция заполнит параметр данными расширенного ответа на операцию,
6978
если параметр задали. Если параметр не задали, получить данные
70-
можно вызовом на результирующем объекте функции ldap_parse_exop позже.
71-
</para>
79+
можно вызовом на результирующем объекте функции <function>ldap_parse_exop</function> позже.
80+
</simpara>
7281
</listitem>
7382
</varlistentry>
7483
<varlistentry>
75-
<term><parameter>retoid</parameter></term>
84+
<term><parameter>response_oid</parameter></term>
7685
<listitem>
77-
<para>
78-
Функция заполнит параметр значением идентификатора OID ответа,
79-
который обычно совпадает с OID запроса, если параметр задали.
80-
</para>
86+
<simpara>
87+
Функция заполнит параметр значением идентификатора <acronym>OID</acronym> ответа,
88+
который обычно совпадает с <acronym>OID</acronym> запроса, если параметр задали.
89+
</simpara>
8190
</listitem>
8291
</varlistentry>
8392
</variablelist>
8493
</refsect1>
8594

8695
<refsect1 role="returnvalues">
8796
&reftitle.returnvalues;
88-
<para>
97+
<simpara>
8998
Функция возвращает &true; или &false;, если функцию вызвали
9099
с параметром <parameter>response_data</parameter>. Функция возвращает
91100
идентификатор ресурса или &false;, если функцию вызвали без параметра
92101
<parameter>response_data</parameter>.
93-
</para>
102+
</simpara>
94103
</refsect1>
95104

96105
<refsect1 role="changelog">
97106
&reftitle.changelog;
98-
<para>
99-
<informaltable>
100-
<tgroup cols="2">
101-
<thead>
102-
<row>
103-
<entry>&Version;</entry>
104-
<entry>&Description;</entry>
105-
</row>
106-
</thead>
107-
<tbody>
108-
&ldap.changelog.ldap-object;
109-
<row>
110-
<entry>7.3.0</entry>
111-
<entry>
112-
Добавлена поддержка параметра <parameter>controls</parameter>.
113-
</entry>
114-
</row>
115-
</tbody>
116-
</tgroup>
117-
</informaltable>
118-
</para>
107+
<informaltable>
108+
<tgroup cols="2">
109+
<thead>
110+
<row>
111+
<entry>&Version;</entry>
112+
<entry>&Description;</entry>
113+
</row>
114+
</thead>
115+
<tbody>
116+
<row>
117+
<entry>8.4.0</entry>
118+
<entry>
119+
Использование более 4 параметров объявлено устаревшим,
120+
используйте вместо этого <function>ldap_exop_sync</function>.
121+
</entry>
122+
</row>
123+
&ldap.changelog.ldap-object;
124+
<row>
125+
<entry>7.3.0</entry>
126+
<entry>
127+
Добавлена поддержка параметра <parameter>controls</parameter>.
128+
</entry>
129+
</row>
130+
</tbody>
131+
</tgroup>
132+
</informaltable>
119133
</refsect1>
120134

121135
<refsect1 role="examples">
122136
&reftitle.examples;
123-
<para>
124-
<example>
137+
<example>
125138
<title>Расширенная операция Whoami</title>
126139
<programlisting role="php">
127140
<![CDATA[
@@ -160,20 +173,18 @@ if ($ds) {
160173
]]>
161174
</programlisting>
162175
</example>
163-
</para>
164176
</refsect1>
165177

166178
<refsect1 role="seealso">
167179
&reftitle.seealso;
168-
<para>
169-
<simplelist>
170-
<member><function>ldap_parse_result</function></member>
171-
<member><function>ldap_parse_exop</function></member>
172-
<member><function>ldap_exop_whoami</function></member>
173-
<member><function>ldap_exop_refresh</function></member>
174-
<member><function>ldap_exop_passwd</function></member>
175-
</simplelist>
176-
</para>
180+
<simplelist>
181+
<member><function>ldap_exop_sync</function></member>
182+
<member><function>ldap_exop_whoami</function></member>
183+
<member><function>ldap_exop_refresh</function></member>
184+
<member><function>ldap_exop_passwd</function></member>
185+
<member><function>ldap_parse_result</function></member>
186+
<member><function>ldap_parse_exop</function></member>
187+
</simplelist>
177188
</refsect1>
178189

179190
</refentry>

0 commit comments

Comments
 (0)