Skip to content

Commit

Permalink
Update features
Browse files Browse the repository at this point in the history
  • Loading branch information
@mowangjuanzi
mowangjuanzi committed Nov 24, 2024
1 parent 485359a commit 311dda9
Show file tree
Hide file tree
Showing 3 changed files with 19 additions and 82 deletions.
12 changes: 9 additions & 3 deletions features/commandline.xml
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 725ceadea94af4f4db6c76b9665829f27068d2c5 Maintainer: HonestQiao Status: ready -->
<!-- EN-Revision: eee245cdbd89dc2fd908285f588e3b9e055924e5 Maintainer: HonestQiao Status: ready -->
<!-- CREDITS: HonestQiao, Haohappy, Luffy, mowangjuanzi -->
<chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>PHP 的命令行模式</title>
Expand Down Expand Up @@ -1457,8 +1457,14 @@ php >
<title>交互模式</title>
<para>
如果 readline 扩展不可用，在 PHP 8.1.0 之前，使用 <option>-a</option> 选项调用 &cli.sapi; 会提供交互模式。
在此模式中，一个完整的 PHP 脚本应该通过 STDIN 给出，并用 <literal>CRTL+d</literal> （POSIX） 或者 <literal>CTRL+z</literal>
终止然后 <literal>ENTER</literal> （Windows），脚本执行。这与不加 <option>-a</option> 选项调用 &cli.sapi; 基本相同。
在此模式中，一个完整的 PHP 脚本应该通过 STDIN 给出，并用 <keycombo action='simul'>
<keycap>CTRL</keycap>
<keycap>D</keycap>
</keycombo>（POSIX）或者 <keycombo action='simul'>
<keycap>CTRL</keycap>
<keycap>Z</keycap>
</keycombo>
终止然后 <keycap>ENTER</keycap>（Windows），脚本执行。这与不加 <option>-a</option> 选项调用 &cli.sapi; 基本相同。
</para>
<para>
自 PHP 8.1.0 起，如果 readline 扩展不可用，使用 <option>-a</option> 调用 &cli.sapi; 会失败。
Expand Down
83 changes: 7 additions & 76 deletions features/file-upload.xml
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 04d9aded7bbd447523cf038ddf88e6d7f7e43c53 Maintainer: Gregory Status: ready -->
<!-- EN-Revision: 3944dc63330edde959cfd3e7d113c999cbec10ff Maintainer: Gregory Status: ready -->
<!-- CREDITS: dallas, Luffy, mowangjuanzi -->
<chapter xml:id="features.file-upload" xmlns="http://docbook.org/ns/docbook">
<title>文件上传处理</title>
Expand Down Expand Up @@ -218,8 +218,8 @@ foreach ($_FILES["pictures"]["error"] as $key => $error) {
</programlisting>
</example>
<para>
File upload progress bar can be implemented using <link
linkend="session.upload-progress">Session Upload Progress</link>.
文件上传进度条可以使用 <link
linkend="session.upload-progress">Session Upload Progress</link> 来实现。
</para>
</sect1>

Expand All @@ -231,79 +231,10 @@ foreach ($_FILES["pictures"]["error"] as $key => $error) {
<literal>error</literal> 字段中被找到，也就是
<varname>$_FILES['userfile']['error']</varname>。
</simpara>
<para>
<variablelist>
<varlistentry>
<term><constant>UPLOAD_ERR_OK</constant></term>
<listitem>
<para>
其值为 0，没有错误发生，文件上传成功。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>UPLOAD_ERR_INI_SIZE</constant></term>
<listitem>
<para>
其值为 1，上传的文件超过了 &php.ini; 中
<link linkend="ini.upload-max-filesize">upload_max_filesize</link> 选项限制的值。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>UPLOAD_ERR_FORM_SIZE</constant></term>
<listitem>
<para>
其值为 2，上传文件的大小超过了 HTML 表单中
<emphasis>MAX_FILE_SIZE</emphasis> 选项指定的值。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>UPLOAD_ERR_PARTIAL</constant></term>
<listitem>
<para>
其值为 3，文件只有部分被上传。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>UPLOAD_ERR_NO_FILE</constant></term>
<listitem>
<para>
其值为 4，没有文件被上传。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>UPLOAD_ERR_NO_TMP_DIR</constant></term>
<listitem>
<para>
其值为 6，找不到临时文件夹。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>UPLOAD_ERR_CANT_WRITE</constant></term>
<listitem>
<para>
其值为 7，文件写入失败。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><constant>UPLOAD_ERR_EXTENSION</constant></term>
<listitem>
<para>
Value: 8; A PHP extension stopped the file upload. PHP does not
provide a way to ascertain which extension caused the file upload to
stop; examining the list of loaded extensions with <function>phpinfo</function> may help.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
<simpara>
此错误代码的值是 <constant>UPLOAD_ERR_<replaceable>*</replaceable></constant> 常量中的一个。
</simpara>
</sect1>

<sect1 xml:id="features.file-upload.common-pitfalls">
<title>常见缺陷</title>
Expand Down
6 changes: 3 additions & 3 deletions language-snippets.ent
View file
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 9cd8eb0f11edb4e59fd22f723137bbb91d6ab64f Maintainer: Gregory Status: ready -->
<!-- EN-Revision: 8b502f81f951a1af64396b69823f7a35b7637541 Maintainer: Gregory Status: ready -->
<!-- CREDITS: dallas, mowangjuanzi, Luffy -->
<!-- 请保持此文件与英文文件中相应的每个 ENTITY 行号一一对应以便于对照，修改与更新！ -->

Expand Down Expand Up @@ -4367,8 +4367,8 @@ local: {
要应用的过滤器 ID。<xref linkend="filter.filters" /> 手册页面列出了可用的过滤器。
</para>
<para>
如果省略，将使用 <constant>FILTER_DEFAULT</constant>，默认等同于 <link
linkend="filter.filters.sanitize"><constant>FILTER_UNSAFE_RAW</constant></link>。这将导致不进行任何默认过滤。
如果省略，将使用 <constant>FILTER_DEFAULT</constant>，默认等同于
<constant>FILTER_UNSAFE_RAW</constant>。这将导致不进行任何默认过滤。
</para>
</listitem>
</varlistentry>
Expand Down

0 comments on commit 311dda9

Please sign in to comment.