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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.