svn: /phpdoc/ru/trunk/reference/ curl/functions/curl-setopt.xml zip/ziparchive/open.xml
[email protected] (Sergey Panteleev)
| Newsgroups | php.doc.ru |
|---|---|
| Message-ID | <[email protected]> |
sergey Sat, 21 Mar 2020 10:13:48 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=349507
Log:
docs(ru): Updated to English revision
Changed paths:
U phpdoc/ru/trunk/reference/curl/functions/curl-setopt.xml
U phpdoc/ru/trunk/reference/zip/ziparchive/open.xml
svn-diffs-349507.txt
(text/x-diff, 14.3 KB)
Modified: phpdoc/ru/trunk/reference/curl/functions/curl-setopt.xml
===================================================================
--- phpdoc/ru/trunk/reference/curl/functions/curl-setopt.xml 2020-03-21 09:16:46 UTC (rev 349506)
+++ phpdoc/ru/trunk/reference/curl/functions/curl-setopt.xml 2020-03-21 10:13:48 UTC (rev 349507)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 349396 Maintainer: rjhdby Status: ready -->
+<!-- EN-Revision: 349505 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xml:id="function.curl-setopt" xmlns="http://docbook.org/ns/docbook">
@@ -191,7 +191,7 @@
<entry valign="top"><constant>CURLOPT_FILETIME</constant></entry>
<entry valign="top">
&true; для попытки получения даты модификации удаленного документа.
- Это значение может быть получено с помощью параметра <parameter>CURLINFO_FILETIME</parameter>
+ Это значение может быть получено с помощью параметра <constant>CURLINFO_FILETIME</constant>
из функции <function>curl_getinfo</function>.
</entry>
<entry valign="top">
@@ -748,13 +748,13 @@
<row>
<entry valign="top"><constant>CURLOPT_HTTP_VERSION</constant></entry>
<entry valign="top">
- <parameter>CURL_HTTP_VERSION_NONE</parameter> (по умолчанию CURL сам
- выбирает используемую версию), <parameter>CURL_HTTP_VERSION_1_0</parameter>
- (принудительное использование HTTP/1.0), <parameter>CURL_HTTP_VERSION_1_1</parameter>
- (принудительное использование HTTP/1.1), <parameter>CURL_HTTP_VERSION_2_0</parameter>
- (принудительное использование HTTP/2.0, доступно с PHP 5.5), <parameter>CURL_HTTP_VERSION_2</parameter>
- (принудительное использование HTTP/2.0, доступно с PHP 7.0, алиас CURL_HTTP_VERSION_2_0), <parameter>CURL_HTTP_VERSION_2TLS</parameter>
- (принудительное использование HTTP/2.0 только по TLS (HTTPS), доступно с PHP 7.0), <parameter>CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE</parameter>
+ <constant>CURL_HTTP_VERSION_NONE</constant> (по умолчанию CURL сам
+ выбирает используемую версию), <constant>CURL_HTTP_VERSION_1_0</constant>
+ (принудительное использование HTTP/1.0), <constant>CURL_HTTP_VERSION_1_1</constant>
+ (принудительное использование HTTP/1.1), <constant>CURL_HTTP_VERSION_2_0</constant>
+ (принудительное использование HTTP/2.0, доступно с PHP 5.5), <constant>CURL_HTTP_VERSION_2</constant>
+ (принудительное использование HTTP/2.0, доступно с PHP 7.0, алиас <constant>CURL_HTTP_VERSION_2_0</constant>), <constant>CURL_HTTP_VERSION_2TLS</constant>
+ (принудительное использование HTTP/2.0 только по TLS (HTTPS), доступно с PHP 7.0), <constant>CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE</constant>
(принудительное использование HTTP/2.0 HTTP запросы без TLS, доступно с PHP 7.0).
</entry>
<entry valign="top">
@@ -765,12 +765,12 @@
<entry valign="top">
<para>
Используемые HTTP-методы авторизации. Используемые параметры:
- <parameter>CURLAUTH_BASIC</parameter>,
- <parameter>CURLAUTH_DIGEST</parameter>,
- <parameter>CURLAUTH_GSSNEGOTIATE</parameter>,
- <parameter>CURLAUTH_NTLM</parameter>,
- <parameter>CURLAUTH_ANY</parameter> и
- <parameter>CURLAUTH_ANYSAFE</parameter>.
+ <constant>CURLAUTH_BASIC</constant>,
+ <constant>CURLAUTH_DIGEST</constant>,
+ <constant>CURLAUTH_GSSNEGOTIATE</constant>,
+ <constant>CURLAUTH_NTLM</constant>,
+ <constant>CURLAUTH_ANY</constant> и
+ <constant>CURLAUTH_ANYSAFE</constant>.
</para>
<para>
Можно использовать побитовый оператор <literal>|</literal> (или) для комбинации
@@ -778,11 +778,11 @@
поддерживаемых методов авторизации и выберет лучший из них.
</para>
<para>
- <parameter>CURLAUTH_ANY</parameter> - это псевдоним
+ <constant>CURLAUTH_ANY</constant> - это псевдоним
<literal>CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>.
</para>
<para>
- <parameter>CURLAUTH_ANYSAFE</parameter> - это псевдоним
+ <constant>CURLAUTH_ANYSAFE</constant> - это псевдоним
<literal>CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM</literal>.
</para>
</entry>
@@ -872,19 +872,19 @@
</para>
<para>
Корректные значения протоколов:
- <parameter>CURLPROTO_HTTP</parameter>,
- <parameter>CURLPROTO_HTTPS</parameter>,
- <parameter>CURLPROTO_FTP</parameter>,
- <parameter>CURLPROTO_FTPS</parameter>,
- <parameter>CURLPROTO_SCP</parameter>,
- <parameter>CURLPROTO_SFTP</parameter>,
- <parameter>CURLPROTO_TELNET</parameter>,
- <parameter>CURLPROTO_LDAP</parameter>,
- <parameter>CURLPROTO_LDAPS</parameter>,
- <parameter>CURLPROTO_DICT</parameter>,
- <parameter>CURLPROTO_FILE</parameter>,
- <parameter>CURLPROTO_TFTP</parameter>,
- <parameter>CURLPROTO_ALL</parameter>
+ <constant>CURLPROTO_HTTP</constant>,
+ <constant>CURLPROTO_HTTPS</constant>,
+ <constant>CURLPROTO_FTP</constant>,
+ <constant>CURLPROTO_FTPS</constant>,
+ <constant>CURLPROTO_SCP</constant>,
+ <constant>CURLPROTO_SFTP</constant>,
+ <constant>CURLPROTO_TELNET</constant>,
+ <constant>CURLPROTO_LDAP</constant>,
+ <constant>CURLPROTO_LDAPS</constant>,
+ <constant>CURLPROTO_DICT</constant>,
+ <constant>CURLPROTO_FILE</constant>,
+ <constant>CURLPROTO_TFTP</constant>,
+ <constant>CURLPROTO_ALL</constant>
</para>
</entry>
<entry valign="top">
@@ -897,8 +897,8 @@
Методы авторизации HTTP, используемые при соединении с прокси-сервером.
Используйте те же самые битовые маски, которые были описаны у параметра
<constant>CURLOPT_HTTPAUTH</constant>. В данный момент для авторизации прокси
- поддерживаются только <parameter>CURLAUTH_BASIC</parameter> и
- <parameter>CURLAUTH_NTLM</parameter>.
+ поддерживаются только <constant>CURLAUTH_BASIC</constant> и
+ <constant>CURLAUTH_NTLM</constant>.
</entry>
<entry valign="top">
Добавлен в версии cURL 7.10.7.
@@ -958,9 +958,9 @@
<entry valign="top">
<para>
Метод аутентификации SOCKS5, который нужно использовать. Варианты:
- <parameter>CURLAUTH_BASIC</parameter>,
- <parameter>CURLAUTH_GSSAPI</parameter>,
- <parameter>CURLAUTH_NONE</parameter>.
+ <constant>CURLAUTH_BASIC</constant>,
+ <constant>CURLAUTH_GSSAPI</constant>,
+ <constant>CURLAUTH_NONE</constant>.
</para>
<para>
Побитовый оператор <literal>|</literal> (или) можно использовать для объединения
@@ -968,13 +968,13 @@
какие методы он поддерживает, и выбрать налучший.
</para>
<para>
- <parameter>CURLAUTH_BASIC</parameter> разрешает аутентификацию по имени пользователя/пароля.
+ <constant>CURLAUTH_BASIC</constant> разрешает аутентификацию по constant пользователя/пароля.
</para>
<para>
- <parameter>CURLAUTH_GSSAPI</parameter> разрешает аутентификацию GSS-API.
+ <constant>CURLAUTH_GSSAPI</constant> разрешает аутентификацию GSS-API.
</para>
<para>
- <parameter>CURLAUTH_NONE</parameter> не разрешает аутентификацию.
+ <constant>CURLAUTH_NONE</constant> не разрешает аутентификацию.
</para>
<para>
По умолчанию <literal>CURLAUTH_BASIC|CURLAUTH_GSSAPI</literal>.
@@ -1154,15 +1154,15 @@
<entry valign="top"><constant>CURLOPT_TIMECONDITION</constant></entry>
<entry valign="top">
Способ трактовки параметра <constant>CURLOPT_TIMEVALUE</constant>.
- Используйте <parameter>CURL_TIMECOND_IFMODSINCE</parameter> для
+ Используйте <constant>CURL_TIMECOND_IFMODSINCE</constant> для
возвращения страницы, только если она была изменена со времени,
указанного в параметре <constant>CURLOPT_TIMEVALUE</constant>.
Если страница не была изменена, вернется заголовок
<literal>"304 Not Modified"</literal>, подразумевая, что
параметр<constant>CURLOPT_HEADER</constant> установлен в &true;.
- Используйте <parameter>CURL_TIMECOND_IFUNMODSINCE</parameter>
+ Используйте <constant>CURL_TIMECOND_IFUNMODSINCE</constant>
для обратного эффекта. По умолчанию используется
- <parameter>CURL_TIMECOND_IFMODSINCE</parameter>.
+ <constant>CURL_TIMECOND_IFMODSINCE</constant>.
</entry>
<entry valign="top">
</entry>
@@ -1198,7 +1198,7 @@
будет использовано параметром
<constant>CURLOPT_TIMECONDITION</constant>. По умолчанию,
используется параметр
- <parameter>CURL_TIMECOND_IFMODSINCE</parameter>.
+ <constant>CURL_TIMECOND_IFMODSINCE</constant>.
</entry>
<entry valign="top">
</entry>
Modified: phpdoc/ru/trunk/reference/zip/ziparchive/open.xml
===================================================================
--- phpdoc/ru/trunk/reference/zip/ziparchive/open.xml 2020-03-21 09:16:46 UTC (rev 349506)
+++ phpdoc/ru/trunk/reference/zip/ziparchive/open.xml 2020-03-21 10:13:48 UTC (rev 349507)
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 349472 Maintainer: mch Status: ready -->
+<!-- EN-Revision: 349502 Maintainer: mch Status: ready -->
<!-- $Revision$ -->
<!-- Reviewed: yes -->
<refentry xml:id="ziparchive.open" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -15,8 +15,11 @@
<methodparam choice="opt"><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
- Открывает новый ZIP-архив для чтения, записи или изменения.
+ Открывает новый или существующий ZIP-архив для чтения, записи или изменения.
</para>
+ <para>
+ Начиная с libzip 1.6.0, пустой файл больше не является корректным архивом.
+ </para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
@@ -74,7 +77,7 @@
<variablelist>
<varlistentry>
<term><parameter>Коды ошибок</parameter></term>
- <listitem>
+ <listitem>
<para>
Возвращает &true; при успешном завершении или код ошибки.
<itemizedlist>
@@ -151,7 +154,7 @@
</para>
</listitem>
</itemizedlist>
- </para>
+ </para>
</listitem>
</varlistentry>
</variablelist>
@@ -159,9 +162,9 @@
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
- <example>
- <title>Открытие и извлечение</title>
- <programlisting role="php">
+ <example>
+ <title>Открытие и извлечение</title>
+ <programlisting role="php">
<![CDATA[
<?php
$zip = new ZipArchive;
@@ -176,10 +179,10 @@
?>
]]>
</programlisting>
- </example>
- <example>
- <title>Создание архива</title>
- <programlisting role="php">
+ </example>
+ <example>
+ <title>Создание архива</title>
+ <programlisting role="php">
<![CDATA[
<?php
$zip = new ZipArchive;
@@ -195,8 +198,27 @@
?>
]]>
</programlisting>
+ </example>
+ <example>
+ <title>Создать временный архив</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$name = tempnam(sys_get_temp_dir(), "FOO");
+$zip = new ZipArchive;
+$res = $zip->open($name, ZipArchive::OVERWRITE); /* усечение, поскольку пустой файл недопустим */
+if ($res === TRUE) {
+ $zip->addFile('data.txt', 'entryname.txt');
+ $zip->close();
+ echo 'готово';
+} else {
+ echo 'ошибка';
+}
+?>
+]]>
+ </programlisting>
</example>
- </refsect1>
+ </refsect1>
</refentry>
<!-- Keep this comment at the end of the file