Skip to content

ext/zip: Change <para> to <simpara> #1047

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sy-records merged 1 commit into from
May 23, 2026
Merged

ext/zip: Change <para> to <simpara> #1047

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions reference/zip/book.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: aebf045bfb7f4f2350db5e1e908cf290be334075 Maintainer: dallas Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<!-- EN-Revision: 963af75faf771d12d38a74d1c3449586ac0a966a Maintainer: dallas Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<book xml:id="book.zip" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="bundledexternal" ?>
<title>Zip</title>

<!-- {{{ preface -->
<preface xml:id="intro.zip">
&reftitle.intro;
<para>
<simpara>
此扩展能够透明地读取或写入 ZIP 压缩档案及其中的文件。
</para>
</simpara>
</preface>
<!-- }}} -->

Expand Down
22 changes: 11 additions & 11 deletions reference/zip/configure.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,41 +1,41 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 7747acdc55fe497b9e920d6edcbe70c71e03ea30 Maintainer: dallas Status: ready -->
<!-- EN-Revision: 963af75faf771d12d38a74d1c3449586ac0a966a Maintainer: dallas Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<section xml:id="zip.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.install;

<section xml:id="zip.installation.linux">
<title>Linux 系统</title>
<para>
<simpara>
必须在编译 PHP 时用 <option role="configure">--with-zip</option>
配置选项来提供 zip 支持来使用这些方法。
</para>
<para>
</simpara>
<simpara>
PHP 7.4.0 之前，PHP 捆绑了 libzip，编译扩展需要使用
<option role="configure">--enable-zip</option> 配置项。从 PHP 7.3.0 开始, 不鼓励使用捆绑的 libzip
进行构建，但仍然可以使用 <option role="configure">--without-libzip</option> 配置项。
</para>
<para>
</simpara>
<simpara>
新增 <option role="configure">--with-libzip=DIR</option> 配置选项以使用系统
libzip 安装。需要 libzip 版本 0.11，推荐使用 0.11.2 或更高版本。
</para>
</simpara>
</section>

<section xml:id="zip.installation.new.windows">
<title>Windows</title>
<para>
<simpara>
从 PHP 8.2.0 开始，必须在 &php.ini; 中<link linkend="install.pecl.windows.loading">启用</link>
<filename>php_zip.dll</filename> DLL。以前内置此扩展。
</para>
</simpara>
</section>

<section xml:id="zip.installation.pecl">
<title>通过 PECL 安装</title>
<para>
<simpara>
&pecl.info;
<link xlink:href="&url.pecl.package;zip">&url.pecl.package;zip</link>.
</para>
</simpara>
</section>

</section>
Expand Down
6 changes: 3 additions & 3 deletions reference/zip/constants.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8afee82662753fe5ed0c3b8003b14118f00547ef Maintainer: dallas Status: ready -->
<!-- EN-Revision: 963af75faf771d12d38a74d1c3449586ac0a966a Maintainer: dallas Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<appendix xml:id="zip.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;

<para>
<simpara>
<classname>ZipArchive</classname> 使用类常量。有各种类型的常量，主要有：Flag（以 <literal>FL_</literal>
为前缀）、全局 Flag（以 <literal>AFL_</literal> 为前缀）、错误（以 <literal>ER_</literal> 为前缀）以及模式（没有前缀）。
</para>
</simpara>

<variablelist xml:id="ziparchive.constants.mode">
<title>归档打开模式</title>
Expand Down
8 changes: 4 additions & 4 deletions reference/zip/examples.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bac24fafb415f56925732ef41ec7b2326ded3d8e Maintainer: dallas Status: ready -->
<!-- CREDITS: mowangjuanzi -->
<!-- EN-Revision: 963af75faf771d12d38a74d1c3449586ac0a966a Maintainer: dallas Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<chapter xml:id="zip.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.examples;
<example>
Expand Down Expand Up @@ -79,10 +79,10 @@ print_r($odt_meta);
]]>
</programlisting>
</example>
<para>
<simpara>
此例使用了旧的 API（PHP 4），它打开了 ZIP 文件归档，读取归档里的每个文件，并输出文件内容。此例用到的
<filename>test2.zip</filename> 文档是 ZZIPlib 源分布里测试文档中的一个。
</para>
</simpara>
<example>
<title>Zip 使用范例</title>
<programlisting role="php">
Expand Down
14 changes: 7 additions & 7 deletions reference/zip/functions/zip-close.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: Jeff Liu Status: ready -->
<!-- EN-Revision: 963af75faf771d12d38a74d1c3449586ac0a966a Maintainer: Jeff Liu Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<refentry xml:id="function.zip-close" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -19,9 +19,9 @@
<type>void</type><methodname>zip_close</methodname>
<methodparam><type>resource</type><parameter>zip</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
关闭一个指定的ZIP档案文件。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
Expand All @@ -30,19 +30,19 @@
<varlistentry>
<term><parameter>zip</parameter></term>
<listitem>
<para>
<simpara>
一个由<function>zip_open</function>打开的ZIP文件资源。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.void;
</para>
</simpara>
</refsect1>

<refsect1 role="changelog">
Expand Down
14 changes: 7 additions & 7 deletions reference/zip/functions/zip-entry-close.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: Jeff Liu Status: ready -->
<!-- EN-Revision: 963af75faf771d12d38a74d1c3449586ac0a966a Maintainer: Jeff Liu Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<refentry xml:id="function.zip-entry-close" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -19,9 +19,9 @@
<type>bool</type><methodname>zip_entry_close</methodname>
<methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
关闭指定的目录项。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
Expand All @@ -30,19 +30,19 @@
<varlistentry>
<term><parameter>zip_entry</parameter></term>
<listitem>
<para>
<simpara>
一个由<function>zip_entry_open</function>打开的项目。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
&return.success;
</para>
</simpara>
</refsect1>

<refsect1 role="changelog">
Expand Down
14 changes: 7 additions & 7 deletions reference/zip/functions/zip-entry-compressedsize.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: Jeff Liu Status: ready -->
<!-- EN-Revision: 963af75faf771d12d38a74d1c3449586ac0a966a Maintainer: Jeff Liu Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<refentry xml:id="function.zip-entry-compressedsize" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -19,9 +19,9 @@
<type class="union"><type>int</type><type>false</type></type><methodname>zip_entry_compressedsize</methodname>
<methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
返回指定目录项压缩过后的大小。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
Expand All @@ -30,19 +30,19 @@
<varlistentry>
<term><parameter>zip_entry</parameter></term>
<listitem>
<para>
<simpara>
由函数<function>zip_read</function> 返回的目录项。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
压缩后的大小，&return.falseforfailure;。
</para>
</simpara>
</refsect1>

<refsect1 role="changelog">
Expand Down
14 changes: 7 additions & 7 deletions reference/zip/functions/zip-entry-compressionmethod.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: Jeff Liu Status: ready -->
<!-- EN-Revision: 963af75faf771d12d38a74d1c3449586ac0a966a Maintainer: Jeff Liu Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<refentry xml:id="function.zip-entry-compressionmethod" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -19,9 +19,9 @@
<type class="union"><type>string</type><type>false</type></type><methodname>zip_entry_compressionmethod</methodname>
<methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
返回由函数<parameter>zip_entry</parameter>确定的目录实体的压缩方法。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
Expand All @@ -30,19 +30,19 @@
<varlistentry>
<term><parameter>zip_entry</parameter></term>
<listitem>
<para>
<simpara>
由函数<function>zip_read</function> 返回的目录实体。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
压缩方法，&return.falseforfailure;。
</para>
</simpara>
</refsect1>

<refsect1 role="changelog">
Expand Down
14 changes: 7 additions & 7 deletions reference/zip/functions/zip-entry-filesize.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: Jeff Liu Status: ready -->
<!-- EN-Revision: 963af75faf771d12d38a74d1c3449586ac0a966a Maintainer: Jeff Liu Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<refentry xml:id="function.zip-entry-filesize" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -19,9 +19,9 @@
<type class="union"><type>int</type><type>false</type></type><methodname>zip_entry_filesize</methodname>
<methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
返回指定目录实体的实际大小。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
Expand All @@ -30,19 +30,19 @@
<varlistentry>
<term><parameter>zip_entry</parameter></term>
<listitem>
<para>
<simpara>
由函数<function>zip_read</function> 返回的目录实体。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
返回该目录实体的大小，&return.falseforfailure;。
</para>
</simpara>
</refsect1>

<refsect1 role="changelog">
Expand Down
14 changes: 7 additions & 7 deletions reference/zip/functions/zip-entry-name.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: Jeff Liu Status: ready -->
<!-- EN-Revision: 963af75faf771d12d38a74d1c3449586ac0a966a Maintainer: Jeff Liu Status: ready -->
<!-- CREDITS: mowangjuanzi, Luffy -->
<refentry xml:id="function.zip-entry-name" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
Expand All @@ -19,9 +19,9 @@
<type class="union"><type>string</type><type>false</type></type><methodname>zip_entry_name</methodname>
<methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
</methodsynopsis>
<para>
<simpara>
返回指定目录项的名称。
</para>
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
Expand All @@ -30,19 +30,19 @@
<varlistentry>
<term><parameter>zip_entry</parameter></term>
<listitem>
<para>
<simpara>
由函数<function>zip_read</function> 返回的目录项。
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<simpara>
目录项的名称，&return.falseforfailure;。
</para>
</simpara>
</refsect1>

<refsect1 role="changelog">
Expand Down
Loading