[prev in list] [next in list] [prev in thread] [next in thread] 

List:       php-doc-cvs
Subject:    [DOC-CVS] [doc-en] master: Add note to ZipArchive:extractTo() about permission not being restored (#
From:       Remi Collet via GitHub <noreply () php ! net>
Date:       2023-11-28 12:31:34
Message-ID: L2o6UqZYwiEOeDC1QJa99cQBIQ9jKYfBVxPyPGw4E6M () main ! php ! net
[Download RAW message or body]

Author: Remi Collet (remicollet)
Committer: GitHub (web-flow)
Pusher: Girgias
Date: 2023-11-28T12:17:56Z

Commit: https://github.com/php/doc-en/commit/b61758269e3619194047cb5d6d4962734372c0a6
Raw diff: https://github.com/php/doc-en/commit/b61758269e3619194047cb5d6d4962734372c0a6.diff


Add note to ZipArchive:extractTo() about permission not being restored (#2973)

Changed paths:
  M  reference/zip/ziparchive/extractto.xml
  M  reference/zip/ziparchive/getexternalattributesindex.xml


Diff:

diff --git a/reference/zip/ziparchive/extractto.xml \
b/reference/zip/ziparchive/extractto.xml index 6b0e60c4da5..5680b9e09de 100644
--- a/reference/zip/ziparchive/extractto.xml
+++ b/reference/zip/ziparchive/extractto.xml
@@ -23,6 +23,12 @@
     by setting the current umask, which can be changed using
     <function>umask</function>.
    </para>
+   <para>
+    For security reasons, the original permissions are not restored.
+    For an example of how to restore them, see the
+    <link linkend="ziparchive.getexternalattributesindex.examples.perms">code \
sample</link> +    on the \
<methodname>ZipArchive::getExternalAttributesIndex</methodname> page. +   </para>
   </warning>
  </refsect1>
  <refsect1 role="parameters">
diff --git a/reference/zip/ziparchive/getexternalattributesindex.xml \
b/reference/zip/ziparchive/getexternalattributesindex.xml index \
                0bc3d68a850..479b413b6a5 100644
--- a/reference/zip/ziparchive/getexternalattributesindex.xml
+++ b/reference/zip/ziparchive/getexternalattributesindex.xml
@@ -71,7 +71,7 @@
       archive <filename>test.zip</filename> and 
       set the Unix rights from external attributes.
     </para>
-    <example>
+    <example xml:id="ziparchive.getexternalattributesindex.examples.perms">
      <title>Extract all entries with Unix rights</title>
      <programlisting role="php">
 <![CDATA[

-- 
PHP Documentation Commits Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php


[prev in list] [next in list] [prev in thread] [next in thread]