archived-doc-zh/reference/zip/constants.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8afee82662753fe5ed0c3b8003b14118f00547ef Maintainer: dallas Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<appendix xml:id="zip.constants" xmlns="http://docbook.org/ns/docbook">
 &reftitle.constants;
 &extension.constants;
 
 <para>
  <classname>ZipArchive</classname> 使用类常量。有各种类型的常量，主要有：Flag（以 <literal>FL_</literal>
  为前缀）、全局 Flag（以 <literal>AFL_</literal> 为前缀）、错误（以 <literal>ER_</literal> 为前缀）以及模式（没有前缀）。
 </para>
 
 <variablelist xml:id="ziparchive.constants.mode">
  <title>归档打开模式</title>
  <varlistentry xml:id="ziparchive.constants.create">
   <term>
    <constant>ZIPARCHIVE::CREATE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     如果不存在则创建归档。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.overwrite">
   <term>
    <constant>ZIPARCHIVE::OVERWRITE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     如果归档存在，则忽略其当前内容。换句话说，处理方式与空归档相同。
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ziparchive.constants.excl">
   <term>
    <constant>ZIPARCHIVE::EXCL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     如果归档已经存在，则出错。
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ziparchive.constants.rdonly">
   <term>
    <constant>ZipArchive::RDONLY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     只读模式打开归档。
     在 PHP 7.4.3 和 PECL zip 1.17.1 中可用，前提是编译时使用的 libzip 版本大于等于 1.0.0。
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ziparchive.constants.checkcons">
   <term>
    <constant>ZIPARCHIVE::CHECKCONS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     对归档执行额外的一致性检查，如果失败则显示错误。
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist xml:id="ziparchive.constants.afl">
  <title>归档全局 flag</title>
  <varlistentry xml:id="ziparchive.constants.afl-rdonly">
   <term>
    <constant>ZipArchive::AFL_RDONLY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     归档只读，无法清除。如果构建时使用的是 libzip ≥ 1.10.0，分别在 PHP 8.3.0 和 PECL zip 1.22.0 中可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.afl-is-torrentzip">
   <term>
    <constant>ZipArchive::AFL_IS_TORRENTZIP</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     当前归档是 torrentzipped（使用 BitTorrent 压缩）。如果构建时使用的是 libzip ≥ 1.10.0，分别在 PHP 8.3.0 和 PECL zip 1.22.0 中可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.afl-want-torrentzip">
   <term>
    <constant>ZipArchive::AFL_WANT_TORRENTZIP</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     使用 torrentzip 格式写入归档。如果构建时使用的是 libzip ≥ 1.10.0，分别在 PHP 8.3.0 和 PECL zip 1.22.0 中可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.afl-create-or-keep-file-for-empty-archive">
   <term>
    <constant>ZipArchive::AFL_CREATE_OR_KEEP_FILE_FOR_EMPTY_ARCHIVE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     归档为空时不要删除文件。如果构建时使用的是 libzip ≥ 1.10.0，分别在 PHP 8.3.0 和 PECL zip 1.22.0 中可用。
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist xml:id="ziparchive.constants.fl">
  <title>归档 flag</title>
  <varlistentry xml:id="ziparchive.constants.fl-nocase">
   <term>
    <constant>ZIPARCHIVE::FL_NOCASE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     名称查找时忽略大小写。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.fl-nodir">
   <term>
    <constant>ZIPARCHIVE::FL_NODIR</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     忽略目录部分
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.fl-compressed">
   <term>
    <constant>ZIPARCHIVE::FL_COMPRESSED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     读取压缩数据
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ziparchive.constants.fl-unchanged">
   <term>
    <constant>ZIPARCHIVE::FL_UNCHANGED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     使用原始数据，忽略更改。
    </simpara>
   </listitem>
  </varlistentry>

  <varlistentry xml:id="ziparchive.constants.fl-recompress">
   <term>
    <constant>ZipArchive::FL_RECOMPRESS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     强制重新压缩数据。
     PHP 8.0.0 和 PECL zip 1.18.0 起可以使用。
     从 PHP 8.3.0 和 PECL zip 1.22.1 起已被弃用，
     将在 libzip 的未来版本中被删除。
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ziparchive.constants.fl-encrypted">
   <term>
    <constant>ZipArchive::FL_ENCRYPTED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     读取加密数据（意味着 FL_COMPRESSED）。
     PHP 8.0.0 和 PECL zip 1.18.0 起可以使用。
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ziparchive.constants.fl-overwrite">
   <term>
    <constant>ZipArchive::FL_OVERWRITE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     如果文件名称存在，重写（覆盖）它。
     PHP 8.0.0 和 PECL zip 1.18.0 起可以使用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.fl-local">
   <term>
    <constant>ZipArchive::FL_LOCAL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     在本地 header 中。
     PHP 8.0.0 和 PECL zip 1.18.0 起可以使用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.fl-central">
   <term>
    <constant>ZipArchive::FL_CENTRAL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     In central directory.
     PHP 8.0.0 和 PECL zip 1.18.0 起可以使用。
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ziparchive.constants.fl-enc-guess">
   <term>
    <constant>ZipArchive::FL_ENC_GUESS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     猜测字符串编码（默认情况）。从 PHP 7.0.8 起可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.fl-enc-raw">
   <term>
    <constant>ZipArchive::FL_ENC_RAW</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     获取未修改的字符串。从 PHP 7.0.8 起可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.fl-enc-strict">
   <term>
    <constant>ZipArchive::FL_ENC_STRICT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     严格遵循规范要求。从 PHP 7.0.8 起可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.fl-enc-utf-8">
   <term>
    <constant>ZipArchive::FL_ENC_UTF_8</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     字符串是 UTF-8 编码。从 PHP 7.0.8 起可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.fl-enc-cp437">
   <term>
    <constant>ZipArchive::FL_ENC_CP437</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     字符串是 CP437 编码。从 PHP 7.0.8 起可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.fl-open-file-now">
   <term>
    <constant>ZipArchive::FL_OPEN_FILE_NOW</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     在添加文件，而不是等待归档关闭时打开文件。需要注意文件描述符消耗的情况。
     从 PHP 8.3.0 和 PECL zip 1.22.1 起可用。
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist xml:id="ziparchive.constants.cm">
  <title>压缩模式</title>
  <varlistentry xml:id="ziparchive.constants.cm-default">
   <term>
    <constant>ZIPARCHIVE::CM_DEFAULT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     更好的压缩或存储。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-store">
   <term>
    <constant>ZIPARCHIVE::CM_STORE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     存储（不压缩）。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-shrink">
   <term>
    <constant>ZIPARCHIVE::CM_SHRINK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     收缩
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-reduce-1">
   <term>
    <constant>ZIPARCHIVE::CM_REDUCE_1</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     用因子 1 换算
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-reduce-2">
   <term>
    <constant>ZIPARCHIVE::CM_REDUCE_2</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     用因子 2 换算
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-reduce-3">
   <term>
    <constant>ZIPARCHIVE::CM_REDUCE_3</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     用因子 3 换算
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-reduce-4">
   <term>
    <constant>ZIPARCHIVE::CM_REDUCE_4</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     用因子 4 换算
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-implode">
   <term>
    <constant>ZIPARCHIVE::CM_IMPLODE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     聚爆
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-deflate">
   <term>
    <constant>ZIPARCHIVE::CM_DEFLATE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     deflated
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-deflate64">
   <term>
    <constant>ZIPARCHIVE::CM_DEFLATE64</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     deflate64
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-pkware-implode">
   <term>
    <constant>ZIPARCHIVE::CM_PKWARE_IMPLODE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     PKWARE imploding
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-bzip2">
   <term>
    <constant>ZIPARCHIVE::CM_BZIP2</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     BZIP2 算法
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ziparchive.constants.cm-lzma">
   <term>
    <constant>ZipArchive::CM_LZMA</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     LZMA 算法
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ziparchive.constants.cm-lzma2">
   <term>
    <constant>ZipArchive::CM_LZMA2</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     LZMA2 algorithm.
     Available as of PHP 7.4.3 and PECL zip 1.16.0, respectively,
     if built against libzip ≥ 1.6.0.
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-zstd">
   <term>
    <constant>ZipArchive::CM_ZSTD</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Zstandard（zstd）压缩算法。如果针对 libzip ≥ 1.8.0 编译，则分别从 PHP 8.0.0 和 PECL zip 1.19.1 开始可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-xz">
   <term>
    <constant>ZipArchive::CM_XZ</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     XZ 算法。
     在 PHP 7.4.3 和 PECL zip 1.16.1 中可用，前提是编译时使用的 libzip 版本大于等于 1.6.0。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-terse">
   <term>
    <constant>ZipArchive::CM_TERSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-lz77">
   <term>
    <constant>ZipArchive::CM_LZ77</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-wavpack">
   <term>
    <constant>ZipArchive::CM_WAVPACK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.cm-ppmd">
   <term>
    <constant>ZipArchive::CM_PPMD</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist xml:id="ziparchive.constants.er">
  <title>错误</title>
  <varlistentry xml:id="ziparchive.constants.er-ok">
   <term>
    <constant>ZIPARCHIVE::ER_OK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     没有错误。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-multidisk">
   <term>
    <constant>ZIPARCHIVE::ER_MULTIDISK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     不支持多磁盘 zip 归档。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-rename">
   <term>
    <constant>ZIPARCHIVE::ER_RENAME</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     重命名临时文件失败。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-close">
   <term>
    <constant>ZIPARCHIVE::ER_CLOSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     关闭 zip 归档失败
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-seek">
   <term>
    <constant>ZIPARCHIVE::ER_SEEK</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     寻址错误
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-read">
   <term>
    <constant>ZIPARCHIVE::ER_READ</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     读取错误
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ziparchive.constants.er-write">
   <term>
    <constant>ZIPARCHIVE::ER_WRITE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     写入错误
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-crc">
   <term>
    <constant>ZIPARCHIVE::ER_CRC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     CRC校验失败
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-zipclosed">
   <term>
    <constant>ZIPARCHIVE::ER_ZIPCLOSED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     zip 归档已关闭
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-noent">
   <term>
    <constant>ZIPARCHIVE::ER_NOENT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     没有文件
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-exists">
   <term>
    <constant>ZIPARCHIVE::ER_EXISTS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     文件已经存在
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-open">
   <term>
    <constant>ZIPARCHIVE::ER_OPEN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     不能打开文件
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-tmpopen">
   <term>
    <constant>ZIPARCHIVE::ER_TMPOPEN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     创建临时文件失败
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-zlib">
   <term>
    <constant>ZIPARCHIVE::ER_ZLIB</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Zlib错误
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ziparchive.constants.er-memory">
   <term>
    <constant>ZIPARCHIVE::ER_MEMORY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     内存分配失败
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ziparchive.constants.er-changed">
   <term>
    <constant>ZIPARCHIVE::ER_CHANGED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     条目已被改变
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ziparchive.constants.er-compnotsupp">
   <term>
    <constant>ZIPARCHIVE::ER_COMPNOTSUPP</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     不支持的压缩方式
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-eof">
   <term>
    <constant>ZIPARCHIVE::ER_EOF</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     过早的EOF
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-inval">
   <term>
    <constant>ZIPARCHIVE::ER_INVAL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     无效的参数
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-nozip">
   <term>
    <constant>ZIPARCHIVE::ER_NOZIP</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     不是 zip 归档
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-internal">
   <term>
    <constant>ZIPARCHIVE::ER_INTERNAL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     内部错误
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-incons">
   <term>
    <constant>ZIPARCHIVE::ER_INCONS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Zip 归档不一致
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-remove">
   <term>
    <constant>ZIPARCHIVE::ER_REMOVE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     不能移除文件
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-deleted">
   <term>
    <constant>ZIPARCHIVE::ER_DELETED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     条目已删除
    </simpara>
   </listitem>
  </varlistentry>
  
  <varlistentry xml:id="ziparchive.constants.er-encrnotsupp">
   <term>
    <constant>ZipArchive::ER_ENCRNOTSUPP</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     不支持的压缩方式。
     PHP 7.4.3 和 PECL zip 1.16.1 起可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-rdonly">
   <term>
    <constant>ZipArchive::ER_RDONLY</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     归档只读。
     分别于 PHP 7.4.3 和 PECL zip 1.16.1 起可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-nopasswd">
   <term>
    <constant>ZipArchive::ER_NOPASSWD</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     没有提供密码。
     分别于 PHP 7.4.3 和 PECL zip 1.16.1 起可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-wrongpasswd">
   <term>
    <constant>ZipArchive::ER_WRONGPASSWD</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     提供的密码错误。
     分别于 PHP 7.4.3 和 PECL zip 1.16.1 起可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-opnotsupp">
   <term>
    <constant>ZipArchive::ER_OPNOTSUPP</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     操作不支持。
     在 PHP 7.4.3 和 PECL zip 1.16.1 中可用，前提是编译时使用的 libzip 版本大于等于 1.0.0。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-inuse">
   <term>
    <constant>ZipArchive::ER_INUSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     资源仍在使用。
     在 PHP 7.4.3 和 PECL zip 1.16.1 中可用，前提是编译时使用的 libzip 版本大于等于 1.0.0。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-tell">
   <term>
    <constant>ZipArchive::ER_TELL</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     Tell error.
     在 PHP 7.4.3 和 PECL zip 1.16.1 中可用，前提是编译时使用的 libzip 版本大于等于 1.0.0。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-compressed-data">
   <term>
    <constant>ZipArchive::ER_COMPRESSED_DATA</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     压缩数据无效。
     在 PHP 7.4.3 和 PECL zip 1.16.1 中可用，前提是编译时使用的 libzip 版本大于等于 1.6.0。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-cancelled">
   <term>
    <constant>ZipArchive::ER_CANCELLED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     操作已取消。
     在 PHP 7.4.3 和 PECL zip 1.16.1 中可用，前提是编译时使用的 libzip 版本大于等于 1.6.0。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-data-length">
   <term>
    <constant>ZipArchive::ER_DATA_LENGTH</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     数据长度异常。如果构建时使用的是 libzip ≥ 1.10.0，分别在 PHP 8.3.0 和 PECL zip 1.22.0 中可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-not-allowed">
   <term>
    <constant>ZipArchive::ER_NOT_ALLOWED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     在 torrentzip 中不允许。如果构建时使用的是 libzip ≥ 1.10.0，分别在 PHP 8.3.0 和 PECL zip 1.22.0 中可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.er-truncated-zip">
   <term>
    <constant>ZipArchive::ER_TRUNCATED_ZIP</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     可能截断或损坏的 zip 归档。
     如果构建时使用的是 libzip ≥ 1.11.1，
     分别在 PHP 8.4.0 和 PECL zip 1.22.4 中可用。
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist xml:id="ziparchive.constants.em">
  <title>加密模式</title>
  <varlistentry xml:id="ziparchive.constants.em-none">
   <term>
    <constant>ZipArchive::EM_NONE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     没有加密。分别从 PHP 7.2.0 和 PECL zip 1.14.0 开始可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.em-trad-pkware">
   <term>
    <constant>ZipArchive::EM_TRAD_PKWARE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     传统 PKWARE 加密。分别从 PHP 8.0.0 和 PECL zip 1.19.0 开始可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.em-aes-128">
   <term>
    <constant>ZipArchive::EM_AES_128</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     AES 128 encryption, since PHP 7.2.0, PECL zip 1.14.0
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.em-aes-192">
   <term>
    <constant>ZipArchive::EM_AES_192</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     AES 1192 encryption, since PHP 7.2.0, PECL zip 1.14.0
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.em-aes-256">
   <term>
    <constant>ZipArchive::EM_AES_256</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     AES 256 encryption, since PHP 7.2.0, PECL zip 1.14.0
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.em-unknown">
   <term>
    <constant>ZipArchive::EM_UNKNOWN</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     未知的加密算法。分别从 PHP 8.0.0 和 PECL zip 1.19.0 开始可用。
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist xml:id="ziparchive.constants.length">
  <title>length 参数常量</title>
  <varlistentry xml:id="ziparchive.constants.length-to-end">
   <term>
    <constant>ZipArchive::LENGTH_TO_END</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     使用的文件大小，如果文件增大，将会忽略附加数据，如果文件变小，则会引发错误（<constant>ZipArchive::ER_DATA_LENGTH</constant>）。
     自 PHP 8.3.0 和 PECL zip 1.22.2 起可用。
    </simpara>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.length-unchecked">
   <term>
    <constant>ZipArchive::LENGTH_UNCHECKED</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     使用所有可用的数据。如果针对 libzip ≥ 1.10.1 编译，自 PHP 8.3.0 和 PECL zip 1.22.2 起可用。
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist xml:id="ziparchive.constants.other">
  <title>其它常量</title>
  <varlistentry xml:id="ziparchive.constants.libzip-version">
   <term>
    <constant>ZipArchive::LIBZIP_VERSION</constant>
    (<type>string</type>)
   </term>
   <listitem>
    <simpara>
     Zip 库版本。从 PHP 7.4.3 和 PECL zip 1.16.0 开始起可用。
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>

 <variablelist xml:id="ziparchive.constants.opsys">
  <title>外部属性的操作系统常量</title>
  <varlistentry xml:id="ziparchive.constants.opsys-dos">
   <term>
    <constant>ZipArchive::OPSYS_DOS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-amiga">
   <term>
    <constant>ZipArchive::OPSYS_AMIGA</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-openvms">
   <term>
    <constant>ZipArchive::OPSYS_OPENVMS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-unix">
   <term>
    <constant>ZipArchive::OPSYS_UNIX</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-vm-cms">
   <term>
    <constant>ZipArchive::OPSYS_VM_CMS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-atari-st">
   <term>
    <constant>ZipArchive::OPSYS_ATARI_ST</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-os-2">
   <term>
    <constant>ZipArchive::OPSYS_OS_2</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-macintosh">
   <term>
    <constant>ZipArchive::OPSYS_MACINTOSH</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-z-system">
   <term>
    <constant>ZipArchive::OPSYS_Z_SYSTEM</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-cpm">
   <term>
    <constant>ZipArchive::OPSYS_CPM</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-windows-ntfs">
   <term>
    <constant>ZipArchive::OPSYS_WINDOWS_NTFS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-mvs">
   <term>
    <constant>ZipArchive::OPSYS_MVS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-vse">
   <term>
    <constant>ZipArchive::OPSYS_VSE</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-acorn-risc">
   <term>
    <constant>ZipArchive::OPSYS_ACORN_RISC</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-vfat">
   <term>
    <constant>ZipArchive::OPSYS_VFAT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-alternate-mvs">
   <term>
    <constant>ZipArchive::OPSYS_ALTERNATE_MVS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-beos">
   <term>
    <constant>ZipArchive::OPSYS_BEOS</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-tandem">
   <term>
    <constant>ZipArchive::OPSYS_TANDEM</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-os-4000">
   <term>
    <constant>ZipArchive::OPSYS_OS_400</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-os-x">
   <term>
    <constant>ZipArchive::OPSYS_OS_X</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara/>
   </listitem>
  </varlistentry>
  <varlistentry xml:id="ziparchive.constants.opsys-default">
   <term>
    <constant>ZipArchive::OPSYS_DEFAULT</constant>
    (<type>int</type>)
   </term>
   <listitem>
    <simpara>
     自 PECL zip 1.12.4 起可用
    </simpara>
   </listitem>
  </varlistentry>
 </variablelist>
</appendix>
<!-- 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
-->