svn: /phpdoc/ru/trunk/reference/zip/ziparchive/ registercancelcallback.xml registerprogresscallback.xml replacefile.xml

Added: phpdoc/ru/trunk/reference/zip/ziparchive/registercancelcallback.xml
===================================================================
--- phpdoc/ru/trunk/reference/zip/ziparchive/registercancelcallback.xml	                        (rev 0)
+++ phpdoc/ru/trunk/reference/zip/ziparchive/registercancelcallback.xml	2020-05-17 21:33:42 UTC (rev 349904)
@@ -0,0 +1,107 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 349077 Maintainer: sergey Status: ready -->
+<!-- Reviewed: no -->
+
+<refentry xml:id="ziparchive.registercancelcallback" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>ZipArchive::registerCancelCallback</refname>
+  <refpurpose>Регистрирует callback-функцию для разрешения отмены во время закрытия архива</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type>
+   <methodname>ZipArchive::registerCancelCallback</methodname>
+   <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Регистрирует <parameter>callback</parameter>-функцию для разрешения отмены во время закрытия архива.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>callback</parameter></term>
+     <listitem>
+      <para>
+       Если функция вернет 0, операция продолжится, при другом значении она будет отменена.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    Функция доступна, если PHP скимпилирован с libzip ≥ 1.6.0.
+   </para>
+  </note>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+    <para>
+     В этом примере создается ZIP-архив
+     <filename>php.zip</filename> и отменяется
+     операция при некоторых условиях запуска.
+    </para>
+    <example>
+     <title>Архивация файла</title>
+     <programlisting role="php">
+<![CDATA[
+<?php
+$zip = new ZipArchive();
+if ($zip->open('php.zip', ZipArchive::CREATE | ZipArchive::OVERWRITE)) {
+    $zip->addFile(PHP_BINARY, 'php');
+    $zip->registerCancelCallback(function () {
+        return ($someruncondition ? -1 : 0);
+    });
+    $zip->close();
+}
+]]>
+     </programlisting>
+    </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><methodname>ZipArchive::registerProgressCallback</methodname></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/ru/trunk/reference/zip/ziparchive/registercancelcallback.xml
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property
Added: phpdoc/ru/trunk/reference/zip/ziparchive/registerprogresscallback.xml
===================================================================
--- phpdoc/ru/trunk/reference/zip/ziparchive/registerprogresscallback.xml	                        (rev 0)
+++ phpdoc/ru/trunk/reference/zip/ziparchive/registerprogresscallback.xml	2020-05-17 21:33:42 UTC (rev 349904)
@@ -0,0 +1,115 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 349078 Maintainer: sergey Status: ready -->
+<!-- Reviewed: no -->
+
+<refentry xml:id="ziparchive.registerprogresscallback" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>ZipArchive::registerProgressCallback</refname>
+  <refpurpose>Регистрирует callback-функцию для предоставления обновлений при закрытии архива</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type>
+   <methodname>ZipArchive::registerProgressCallback</methodname>
+   <methodparam><type>float</type><parameter>rate</parameter></methodparam>
+   <methodparam><type>callable</type><parameter>callback</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Регистрирует <parameter>callback</parameter>-функцию для предоставления обновлений при закрытии архива.
+  </para>
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>rate</parameter></term>
+     <listitem>
+      <para>
+       Изменение между каждым вызовом callback-функции (от 0,0 до 1,0).
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>callback</parameter></term>
+     <listitem>
+      <para>
+       Функция будет получать текущее состояние (<parameter>state</parameter>) в виде числа с плавающей запятой (<type>float</type>) (от 0,0 до 1,0).
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    Функция доступна, если PHP скимпилирован с libzip ≥ 1.6.0.
+   </para>
+  </note>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+    <para>
+     В этом примере создается ZIP-архив
+     <filename>php.zip</filename> и отображается
+     прогрессия.
+    </para>
+    <example>
+     <title>Архивация файла</title>
+     <programlisting role="php">
+<![CDATA[
+$zip = new ZipArchive();
+if ($zip->open('php.zip', ZipArchive::CREATE | ZipArchive::OVERWRITE)) {
+    $zip->addFile(PHP_BINARY, 'php');
+    $zip->registerProgressCallback(0.05, function ($r) {
+        printf("%d%%\n", $r * 100);
+    });
+    $zip->close();
+}
+]]>
+     </programlisting>
+    </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><methodname>ZipArchive::registerCancelCallback</methodname></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/ru/trunk/reference/zip/ziparchive/registerprogresscallback.xml
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property
Added: phpdoc/ru/trunk/reference/zip/ziparchive/replacefile.xml
===================================================================
--- phpdoc/ru/trunk/reference/zip/ziparchive/replacefile.xml	                        (rev 0)
+++ phpdoc/ru/trunk/reference/zip/ziparchive/replacefile.xml	2020-05-17 21:33:42 UTC (rev 349904)
@@ -0,0 +1,141 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 349360 Maintainer: sergey Status: ready -->
+<!-- Reviewed: no -->
+
+<refentry xml:id="ziparchive.replacefile" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>ZipArchive::replaceFile</refname>
+  <refpurpose>Заменяет файл в ZIP-архиве указанным путем</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>ZipArchive::replaceFile</methodname>
+   <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+   <methodparam><type>int</type><parameter>index</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>start</parameter><initializer>0</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>length</parameter><initializer>0</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>0</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   Заменяет файл в ZIP-архиве указанным путем.
+  </para>
+  &zip.filename.separator;
+ </refsect1>
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>filename</parameter></term>
+     <listitem>
+      <para>
+       Путь к файлу для добавления.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>index</parameter></term>
+     <listitem>
+      <para>
+       Индекс файла, подлежащего замене, его имя не изменяется.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>start</parameter></term>
+     <listitem>
+      <para>
+       Для частичного копирования начальная позиция.
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>length</parameter></term>
+     <listitem>
+      <para>
+       Для частичного копирования - длина, которую нужно скопировать, если 0 или -1, используется весь файл (начиная со <parameter>start</parameter>).
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>flags</parameter></term>
+     <listitem>
+      <para>
+       Битовая маска, состоящая из
+       <constant>ZipArchive::FL_ENC_GUESS</constant>,
+       <constant>ZipArchive::FL_ENC_UTF_8</constant>,
+       <constant>ZipArchive::FL_ENC_CP437</constant>.
+       Поведение этих констант описано на странице
+       <link linkend="zip.constants">Константы ZIP</link>.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+    <para>
+     В этом примере открывается ZIP-архив
+     <filename>test.zip</filename> и заменяется запись с индексом 1
+     на <filename>/path/to/index.txt</filename>.
+    </para>
+    <example>
+     <title>Открытие и замена</title>
+     <programlisting role="php">
+<![CDATA[
+<?php
+$zip = new ZipArchive;
+if ($zip->open('test.zip') === TRUE) {
+    $zip->replaceFile('/path/to/index.txt', 1);
+    $zip->close();
+    echo 'Ок';
+} else {
+    echo 'Ошибка';
+}
+?>
+]]>
+     </programlisting>
+    </example>
+   </refsect1>
+
+   <refsect1 role="seealso">
+    &reftitle.seealso;
+    <para>
+     <simplelist>
+      <member><methodname>ZipArchive::addFile</methodname></member>
+     </simplelist>
+    </para>
+   </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->


Property changes on: phpdoc/ru/trunk/reference/zip/ziparchive/replacefile.xml
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: svn:keywords
## -0,0 +1 ##
+Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL
\ No newline at end of property