diff --git a/install/macos/compile.xml b/install/macos/compile.xml index f08d53005..b150f0064 100644 --- a/install/macos/compile.xml +++ b/install/macos/compile.xml @@ -1,31 +1,31 @@ - - - - - 在 macOS 下编译 PHP - - 参考 Unix 系统下的安装以在 - macOS下编译 PHP。 - - - - \ No newline at end of file + + + + + 在 macOS 下编译 PHP + + 参考 Unix 系统下的安装以在 + macOS 下编译 PHP。 + + + + diff --git a/reference/array/sorting.xml b/reference/array/sorting.xml index 10344ad4a..5a3c80c6e 100644 --- a/reference/array/sorting.xml +++ b/reference/array/sorting.xml @@ -1,170 +1,170 @@ - - - - - - - 对数组进行排序 - - PHP 有一些用来排序数组的函数， - 这个文档会把它们列出来。 - - - 主要区别有： - - - - - 有些函数基于 array 的键来排序， - 而其他的基于值来排序的：$array['key'] = 'value';。 - - - 排序之后键和值之间的关联关系是否能够保持， - 是指排序之后数组的键可能 - 会被重置为数字型的（0,1,2 ...）。 - - - 排序的顺序有：字母表顺序， 升序（由低到高）， - 降序（由高到低），数字排序，自然排序，随机顺序或者用户自定义排序。 - - - 注意：下列的所有排序函数都是直接作用于数组本身， - 而不是返回一个新的有序的数组。 - - - 以下函数对于数组中相等的元素，会保留原有的排序。 - 在 PHP 8.0.0 之前，它们排序后的顺序是未定义的（也即相等元素之间的顺序是不稳定的）。 - - - - - - 排序函数属性 - - - - 函数名称 - 排序依据 - 数组索引键保持 - 排序的顺序 - 相关函数 - - - - - array_multisort - 值 - string 键保持不变，int 键重新索引 - 第一个数组或者由选项指定 - array_walk - - - asort - 值 - 是 - 升序 - arsort - - - arsort - 值 - 是 - 降序 - asort - - - krsort - 键 - 是 - 降序 - ksort - - - ksort - 键 - 是 - 升序 - krsort - - - natcasesort - 值 - 是 - 自然排序，大小写不敏感 - natsort - - - natsort - 值 - 是 - 自然排序 - natcasesort - - - rsort - 值 - 否 - 降序 - sort - - - shuffle - 值 - 否 - 随机 - array_rand - - - sort - 值 - 否 - 升序 - rsort - - - uasort - 值 - 是 - 由用户定义 - uksort - - - uksort - 键 - 是 - 由用户定义 - uasort - - - usort - 值 - 否 - 由用户定义 - uasort - - - -
- - - - + + + + + + + 对数组进行排序 + + PHP 有一些用来排序数组的函数， + 这个文档会把它们列出来。 + + + 主要区别有： + + + + + 有些函数基于 array 的键来排序， + 而其他的基于值来排序的：$array['key'] = 'value';。 + + + 排序之后键和值之间的关联关系是否能够保持， + 是指排序之后数组的键可能 + 会被重置为数字型的（0,1,2 ...）。 + + + 排序的顺序有：字母表顺序， 升序（由低到高）， + 降序（由高到低），数字排序，自然排序，随机顺序或者用户自定义排序。 + + + 注意：下列的所有排序函数都是直接作用于数组本身， + 而不是返回一个新的有序的数组。 + + + 以下函数对于数组中相等的元素，会保留原有的排序。 + 在 PHP 8.0.0 之前，它们排序后的顺序是未定义的（也即相等元素之间的顺序是不稳定的）。 + + + + + + 排序函数属性 + + + + 函数名称 + 排序依据 + 数组索引键保持 + 排序的顺序 + 相关函数 + + + + + array_multisort + 值 + string 键保持不变，int 键重新索引 + 第一个数组或者由选项指定 + array_walk + + + asort + 值 + 是 + 升序 + arsort + + + arsort + 值 + 是 + 降序 + asort + + + krsort + 键 + 是 + 降序 + ksort + + + ksort + 键 + 是 + 升序 + krsort + + + natcasesort + 值 + 是 + 自然排序，大小写不敏感 + natsort + + + natsort + 值 + 是 + 自然排序 + natcasesort + + + rsort + 值 + 否 + 降序 + sort + + + shuffle + 值 + 否 + 随机 + array_rand + + + sort + 值 + 否 + 升序 + rsort + + + uasort + 值 + 是 + 由用户定义 + uksort + + + uksort + 键 + 是 + 由用户定义 + uasort + + + usort + 值 + 否 + 由用户定义 + uasort + + + +
+ + + + diff --git a/reference/exec/book.xml b/reference/exec/book.xml index 66e0ecfdf..89bdd43c6 100644 --- a/reference/exec/book.xml +++ b/reference/exec/book.xml @@ -1,53 +1,53 @@ - - - - - - - 系统程序执行 - 程序执行 - - - - &reftitle.intro; - - 这些函数提供执行系统本身命令的能力， - 以及安全执行系统命令。 - - - - 在 Windows 平台上，所有命令执行都是通过 - cmd.exe 来完成的。 - 因此，调用这些函数的用户需要拥有运行此命令的相应权限。 - 但是当使用 bypass_shell 选项来调用 - proc_open 函数时是个例外。 - - - - - - &reference.exec.setup; - &reference.exec.reference; - - - - + + + + + + + 系统程序执行 + 程序执行 + + + + &reftitle.intro; + + 这些函数提供执行系统本身命令的能力， + 以及安全执行系统命令。 + + + + 在 Windows 平台上，所有命令执行都是通过 + cmd.exe 来完成的。 + 因此，调用这些函数的用户需要拥有运行此命令的相应权限。 + 但是当使用 bypass_shell 选项来调用 + proc_open 函数时是个例外。 + + + + + + &reference.exec.setup; + &reference.exec.reference; + + + + diff --git a/reference/exec/functions/escapeshellarg.xml b/reference/exec/functions/escapeshellarg.xml index c8922ffb2..bc8a5e2bc 100644 --- a/reference/exec/functions/escapeshellarg.xml +++ b/reference/exec/functions/escapeshellarg.xml @@ -1,100 +1,100 @@ - - - - - - - escapeshellarg - 把字符串转义为可以在 shell 命令里使用的参数 - - - - &reftitle.description; - - stringescapeshellarg - stringarg - - - escapeshellarg 将给字符串增加一个单引号并且能引用或者转义任何已经存在的单引号，这样以确保能够直接将一个字符串传入 shell - 函数，并且还是确保安全的。对于用户输入的部分参数就应该使用这个函数。shell 函数包含exec、system - 和执行运算符 。 - - - 在 Windows 上，escapeshellarg - 用空格替换了百分号、感叹号（延迟变量替换）和双引号，并在字符串两边加上双引号。此外，每条连续的反斜线(\)都会被一个额外的反斜线所转义。 - - - - - &reftitle.parameters; - - - - arg - - - 需要被转义的参数。 - - - - - - - - - &reftitle.returnvalues; - - 转换之后字符串。 - - - - - &reftitle.examples; - - - <function>escapeshellarg</function> 的例子 - - -]]> - - - - - - - &reftitle.seealso; - - - escapeshellcmd - exec - popen - system - 执行运算符 - - - - - - + + + + + + + escapeshellarg + 把字符串转义为可以在 shell 命令里使用的参数 + + + + &reftitle.description; + + stringescapeshellarg + stringarg + + + escapeshellarg 将给字符串增加一个单引号并且能引用或者转义任何已经存在的单引号，这样以确保能够直接将一个字符串传入 shell + 函数，并且还是确保安全的。对于用户输入的部分参数就应该使用这个函数。shell 函数包含exec、system + 和执行运算符 。 + + + 在 Windows 上，escapeshellarg + 用空格替换了百分号、感叹号（延迟变量替换）和双引号，并在字符串两边加上双引号。此外，每条连续的反斜线(\)都会被一个额外的反斜线所转义。 + + + + + &reftitle.parameters; + + + + arg + + + 需要被转义的参数。 + + + + + + + + + &reftitle.returnvalues; + + 转换之后字符串。 + + + + + &reftitle.examples; + + + <function>escapeshellarg</function> 的例子 + + +]]> + + + + + + + &reftitle.seealso; + + + escapeshellcmd + exec + popen + system + 执行运算符 + + + + + + diff --git a/reference/exec/functions/proc-get-status.xml b/reference/exec/functions/proc-get-status.xml index 77365cfa3..62d19968f 100644 --- a/reference/exec/functions/proc-get-status.xml +++ b/reference/exec/functions/proc-get-status.xml @@ -1,175 +1,175 @@ - - - - - - - proc_get_status - 获取由 proc_open 函数打开的进程的信息 - - - - &reftitle.description; - - arrayproc_get_status - resourceprocess - - - proc_get_status 函数可以获取由 - proc_open 函数打开的进程的信息。 - - - - - &reftitle.parameters; - - - - process - - - 要检查的由 proc_open 打开的进程 resource。 - - - - - - - - - &reftitle.returnvalues; - - 收集了进程信息的 array。返回的数组包含下列元素： - - - - - - 元素类型描述 - - - - command - string - - 传入 proc_open 函数的命令行字符串。 - - - - pid - int - 进程 ID - - - running - bool - - &true; 表示进程还在运行中， &false; 表示进程已经终止 - - - - signaled - bool - - &true; 表示子进程被未捕获的信号所终止。 - 在 Windows 平台永远为 &false;。 - - - - stopped - bool - - &true; 表示子进程被信号停止。 - 在 Windows 平台永远为 &false;。 - - - - exitcode - int - - 进程的退出码（仅在 running 为 &false; 时有意义）。PHP - 8.3.0 之前，此函数仅第一次调用返回实际的值，后续调用均返回 -1。 - - - - cached - bool - - 自 PHP 8.3.0 起，当 exit 代码已缓存时为 &true;。缓存是必要的，确保 exit 代码不会在后续调用进程 API 时丢失。 - - - - termsig - int - - 导致子进程终止执行的信号值 - （仅在 signaled 为 &true; 时有意义）。 - - - - stopsig - int - - 导致子进程停止执行的信号值 - （仅在 stopped 为 &true; 时有意义）。 - - - - - - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.3.0 - - 返回的数组中添加了"cached" 条目。PHP 8.3.0 之前，只有第一次调用才会返回真正的 - exit 代码。"cached" 条目表示已缓存 exit 代码。 - - - - - - - - - &reftitle.seealso; - - - proc_open - - - - - - + + + + + + + proc_get_status + 获取由 proc_open 函数打开的进程的信息 + + + + &reftitle.description; + + arrayproc_get_status + resourceprocess + + + proc_get_status 函数可以获取由 + proc_open 函数打开的进程的信息。 + + + + + &reftitle.parameters; + + + + process + + + 要检查的由 proc_open 打开的进程 resource。 + + + + + + + + + &reftitle.returnvalues; + + 收集了进程信息的 array。返回的数组包含下列元素： + + + + + + 元素类型描述 + + + + command + string + + 传入 proc_open 函数的命令行字符串。 + + + + pid + int + 进程 ID + + + running + bool + + &true; 表示进程还在运行中， &false; 表示进程已经终止 + + + + signaled + bool + + &true; 表示子进程被未捕获的信号所终止。 + 在 Windows 平台永远为 &false;。 + + + + stopped + bool + + &true; 表示子进程被信号停止。 + 在 Windows 平台永远为 &false;。 + + + + exitcode + int + + 进程的退出码（仅在 running 为 &false; 时有意义）。PHP + 8.3.0 之前，此函数仅第一次调用返回实际的值，后续调用均返回 -1。 + + + + cached + bool + + 自 PHP 8.3.0 起，当 exit 代码已缓存时为 &true;。缓存是必要的，确保 exit 代码不会在后续调用进程 API 时丢失。 + + + + termsig + int + + 导致子进程终止执行的信号值 + （仅在 signaled 为 &true; 时有意义）。 + + + + stopsig + int + + 导致子进程停止执行的信号值 + （仅在 stopped 为 &true; 时有意义）。 + + + + + + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.3.0 + + 返回的数组中添加了"cached" 条目。PHP 8.3.0 之前，只有第一次调用才会返回真正的 + exit 代码。"cached" 条目表示已缓存 exit 代码。 + + + + + + + + + &reftitle.seealso; + + + proc_open + + + + + + diff --git a/reference/exec/functions/proc-terminate.xml b/reference/exec/functions/proc-terminate.xml index 5eb0ef6f6..1a95f11b3 100644 --- a/reference/exec/functions/proc-terminate.xml +++ b/reference/exec/functions/proc-terminate.xml @@ -1,92 +1,92 @@ - - - - - - proc_terminate - 杀死由 proc_open 打开的进程 - - - - &reftitle.description; - - boolproc_terminate - resourceprocess - intsignal15 - - - 向 process（由 proc_open - 创建）发送信号通知其终止。proc_terminate - 调用之后将会立即返回，而不会等待进程终止。 - - - proc_terminate 允许终止进程并继续其他的任务。可以使用 - proc_get_status 函数轮询进程（查看是否已经停止）。 - - - - - &reftitle.parameters; - - - - process - - - 将要关闭的由 proc_open 打开的 resource。 - - - - - signal - - - 可选参数，仅用于 POSIX 操作系统。可以使用 - kill(2) 系统调用指定要发送到进程的信号。默认值为 - SIGTERM。 - - - - - - - - - &reftitle.returnvalues; - - 返回已运行进程的终止状态。 - - - - - &reftitle.seealso; - - - proc_open - proc_close - proc_get_status - - - - - - + + + + + + proc_terminate + 杀死由 proc_open 打开的进程 + + + + &reftitle.description; + + boolproc_terminate + resourceprocess + intsignal15 + + + 向 process（由 proc_open + 创建）发送信号通知其终止。proc_terminate + 调用之后将会立即返回，而不会等待进程终止。 + + + proc_terminate 允许终止进程并继续其他的任务。可以使用 + proc_get_status 函数轮询进程（查看是否已经停止）。 + + + + + &reftitle.parameters; + + + + process + + + 将要关闭的由 proc_open 打开的 resource。 + + + + + signal + + + 可选参数，仅用于 POSIX 操作系统。可以使用 + kill(2) 系统调用指定要发送到进程的信号。默认值为 + SIGTERM。 + + + + + + + + + &reftitle.returnvalues; + + 返回已运行进程的终止状态。 + + + + + &reftitle.seealso; + + + proc_open + proc_close + proc_get_status + + + + + + diff --git a/reference/exec/setup.xml b/reference/exec/setup.xml index a850965f3..76032f856 100644 --- a/reference/exec/setup.xml +++ b/reference/exec/setup.xml @@ -1,39 +1,39 @@ - - - - - - &reftitle.setup; - -
- &reftitle.resources; - - 本扩展定义了 process 资源， - proc_open 函数会返回此资源。 - -
- - - - - - + + + + + + &reftitle.setup; + +
+ &reftitle.resources; + + 本扩展定义了 process 资源， + proc_open 函数会返回此资源。 + +
+ + + + + + diff --git a/reference/fileinfo/entities.functions.xml b/reference/fileinfo/entities.functions.xml deleted file mode 100644 index 26e8a7519..000000000 --- a/reference/fileinfo/entities.functions.xml +++ /dev/null @@ -1,6 +0,0 @@ -&reference.fileinfo.functions.finfo-buffer; -&reference.fileinfo.functions.finfo-close; -&reference.fileinfo.functions.finfo-file; -&reference.fileinfo.functions.finfo-open; -&reference.fileinfo.functions.finfo-set-flags; -&reference.fileinfo.functions.mime-content-type; diff --git a/reference/pcntl/book.xml b/reference/pcntl/book.xml index 937a54f43..3a180c762 100644 --- a/reference/pcntl/book.xml +++ b/reference/pcntl/book.xml @@ -33,7 +33,7 @@ &reference.pcntl.constants; &reference.pcntl.examples; - &reference.pcntl.qosclass; + &reference.pcntl.pcntl.qosclass; &reference.pcntl.reference; diff --git a/reference/stream/functions/stream-context-get-options.xml b/reference/stream/functions/stream-context-get-options.xml index 27c5bf898..6e668df52 100644 --- a/reference/stream/functions/stream-context-get-options.xml +++ b/reference/stream/functions/stream-context-get-options.xml @@ -1,100 +1,100 @@ - - - - - - - stream_context_get_options - 获取资源流/数据包/上下文的参数 - - - - &reftitle.description; - - arraystream_context_get_options - resourcestream_or_context - - - 返回指定资源流或者上下文的数组参数。 - - - - - &reftitle.parameters; - - - - stream_or_context - - - 获取参数信息的 stream 或者 context 。 - - - - - - - - - &reftitle.returnvalues; - - 返回一个包含有原参数的关联数组。 - - - - - &reftitle.examples; - - - <function>stream_context_get_options</function> 的例子 - - "POST"); - -stream_context_set_default(array("http" => $params)); - -var_dump(stream_context_get_options(stream_context_get_default())); - -?> -]]> - - &example.outputs.similar; - - - array(1) { - ["method"]=> - string(4) "POST" - } -} -]]> - - - - - - - - - + + + + + + + stream_context_get_options + 获取资源流/数据包/上下文的参数 + + + + &reftitle.description; + + arraystream_context_get_options + resourcestream_or_context + + + 返回指定资源流或者上下文的数组参数。 + + + + + &reftitle.parameters; + + + + stream_or_context + + + 获取参数信息的 stream 或者 context 。 + + + + + + + + + &reftitle.returnvalues; + + 返回一个包含有原参数的关联数组。 + + + + + &reftitle.examples; + + + <function>stream_context_get_options</function> 的例子 + + "POST"); + +stream_context_set_default(array("http" => $params)); + +var_dump(stream_context_get_options(stream_context_get_default())); + +?> +]]> + + &example.outputs.similar; + + + array(1) { + ["method"]=> + string(4) "POST" + } +} +]]> + + + + + + + + + diff --git a/reference/stream/functions/stream-context-set-option.xml b/reference/stream/functions/stream-context-set-option.xml index 4c1fc62a9..3b92b8c79 100644 --- a/reference/stream/functions/stream-context-set-option.xml +++ b/reference/stream/functions/stream-context-set-option.xml @@ -1,143 +1,143 @@ - - - - - - - stream_context_set_option - 对资源流、数据包或者上下文设置参数 - - - - &reftitle.description; - - boolstream_context_set_option - resourcestream_or_context - stringwrapper - stringoption - mixedvalue - - - 自 PHP 8.4.0 起，下面的替代签名已被弃用，请使用 stream_context_set_options 代替。 - - boolstream_context_set_option - resourcestream_or_context - arrayoptions - - - - 给指定的上下文设置参数。参数 value - 是设置 wrapper 的 option 参数的值。 - - - - - &reftitle.parameters; - - - - stream_or_context - - - 需要添加参数的资源流或者上下文。 - - - - - wrapper - - - 封装协议的名称（可能与协议不同）。 - 请参考 上下文（Context）选项和参数 - 查看资源流参数列表。 - - - - - option - - - 选项的名称。 - - - - - value - - - 选项的值。 - - - - - options - - - 给 stream_or_context 设置的选项。 - - - - options 必须是一个 $arr['wrapper']['option'] = $value 格式二维关联数组 。 - - - 请参考 上下文（Context）选项和参数 查看资源流参数列表。 - - - - - - - - - - &reftitle.returnvalues; - - &return.success; - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.4.0 - - 替代的双参数签名已被弃用。 - 请使用 stream_context_set_options 代替。 - - - - - - - - - - + + + + + + + stream_context_set_option + 对资源流、数据包或者上下文设置参数 + + + + &reftitle.description; + + boolstream_context_set_option + resourcestream_or_context + stringwrapper + stringoption + mixedvalue + + + 自 PHP 8.4.0 起，下面的替代签名已被弃用，请使用 stream_context_set_options 代替。 + + boolstream_context_set_option + resourcestream_or_context + arrayoptions + + + + 给指定的上下文设置参数。参数 value + 是设置 wrapper 的 option 参数的值。 + + + + + &reftitle.parameters; + + + + stream_or_context + + + 需要添加参数的资源流或者上下文。 + + + + + wrapper + + + 封装协议的名称（可能与协议不同）。 + 请参考 上下文（Context）选项和参数 + 查看资源流参数列表。 + + + + + option + + + 选项的名称。 + + + + + value + + + 选项的值。 + + + + + options + + + 给 stream_or_context 设置的选项。 + + + + options 必须是一个 $arr['wrapper']['option'] = $value 格式二维关联数组 。 + + + 请参考 上下文（Context）选项和参数 查看资源流参数列表。 + + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.4.0 + + 替代的双参数签名已被弃用。 + 请使用 stream_context_set_options 代替。 + + + + + + + + + + diff --git a/reference/stream/functions/stream-filter-remove.xml b/reference/stream/functions/stream-filter-remove.xml index 0022042dc..bd5619141 100644 --- a/reference/stream/functions/stream-filter-remove.xml +++ b/reference/stream/functions/stream-filter-remove.xml @@ -1,109 +1,109 @@ - - - - - - stream_filter_remove - 从资源流里移除某个过滤器 - - - &reftitle.description; - - boolstream_filter_remove - resourcestream_filter - - - 移除之前通过 stream_filter_prepend 或者 stream_filter_append 添加到资源流里面的过滤器。 - 在移除之前，残留在过滤器内部缓冲区里的所有数据刷新到下一个过滤器。 - - - - - &reftitle.parameters; - - - - stream_filter - - - 需要被移除的资源流过滤器。 - - - - - - - - - &reftitle.returnvalues; - - &return.success; - - - - - &reftitle.examples; - - - 动态地重新过滤一个资源流 - - -]]> - - &example.outputs; - - - - - - - - - - &reftitle.seealso; - - - stream_filter_register - stream_filter_append - stream_filter_prepend - - - - - - + + + + + + stream_filter_remove + 从资源流里移除某个过滤器 + + + &reftitle.description; + + boolstream_filter_remove + resourcestream_filter + + + 移除之前通过 stream_filter_prepend 或者 stream_filter_append 添加到资源流里面的过滤器。 + 在移除之前，残留在过滤器内部缓冲区里的所有数据刷新到下一个过滤器。 + + + + + &reftitle.parameters; + + + + stream_filter + + + 需要被移除的资源流过滤器。 + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.examples; + + + 动态地重新过滤一个资源流 + + +]]> + + &example.outputs; + + + + + + + + + + &reftitle.seealso; + + + stream_filter_register + stream_filter_append + stream_filter_prepend + + + + + + diff --git a/reference/stream/functions/stream-get-filters.xml b/reference/stream/functions/stream-get-filters.xml index b59dceeee..3072c8ef9 100644 --- a/reference/stream/functions/stream-get-filters.xml +++ b/reference/stream/functions/stream-get-filters.xml @@ -1,91 +1,91 @@ - - - - - - - stream_get_filters - 获取已注册的数据流过滤器列表 - - - &reftitle.description; - - arraystream_get_filters - - - - 获取当前运行系统中已注册的数据流过滤器列表。 - - - - - &reftitle.parameters; - &no.function.parameters; - - - - &reftitle.returnvalues; - - 返回一个包含所有有效的数据流过滤器名字的索引数组。 - - - - - &reftitle.examples; - - - 使用 <function>stream_get_filters</function> - - -]]> - - &example.outputs.similar; - - string.rot13 - [1] => string.toupper - [2] => string.tolower - [3] => string.base64 - [4] => string.quoted-printable -) -]]> - - - - - - - &reftitle.seealso; - - stream_filter_register - stream_get_wrappers - - - - - - + + + + + + + stream_get_filters + 获取已注册的数据流过滤器列表 + + + &reftitle.description; + + arraystream_get_filters + + + + 获取当前运行系统中已注册的数据流过滤器列表。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + 返回一个包含所有有效的数据流过滤器名字的索引数组。 + + + + + &reftitle.examples; + + + 使用 <function>stream_get_filters</function> + + +]]> + + &example.outputs.similar; + + string.rot13 + [1] => string.toupper + [2] => string.tolower + [3] => string.base64 + [4] => string.quoted-printable +) +]]> + + + + + + + &reftitle.seealso; + + stream_filter_register + stream_get_wrappers + + + + + + diff --git a/reference/stream/functions/stream-get-transports.xml b/reference/stream/functions/stream-get-transports.xml index 72011d045..2a595e712 100644 --- a/reference/stream/functions/stream-get-transports.xml +++ b/reference/stream/functions/stream-get-transports.xml @@ -1,89 +1,89 @@ - - - - - - - stream_get_transports - 获取已注册的套接字传输协议列表 - - - &reftitle.description; - - arraystream_get_transports - - - - 返回一个包含当前运行系统中所有套接字传输协议名称的索引数组。 - - - - - &reftitle.parameters; - &no.function.parameters; - - - - &reftitle.returnvalues; - - 返回一个套接字传输协议名称的索引数组。 - - - - - &reftitle.examples; - - - 使用 <function>stream_get_transports</function> - - -]]> - - &example.outputs.similar; - - tcp - [1] => udp - [2] => unix - [3] => udg -) -]]> - - - - - - - &reftitle.seealso; - - stream_get_filters - stream_get_wrappers - - - - - + + + + + + + stream_get_transports + 获取已注册的套接字传输协议列表 + + + &reftitle.description; + + arraystream_get_transports + + + + 返回一个包含当前运行系统中所有套接字传输协议名称的索引数组。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + 返回一个套接字传输协议名称的索引数组。 + + + + + &reftitle.examples; + + + 使用 <function>stream_get_transports</function> + + +]]> + + &example.outputs.similar; + + tcp + [1] => udp + [2] => unix + [3] => udg +) +]]> + + + + + + + &reftitle.seealso; + + stream_get_filters + stream_get_wrappers + + + + + diff --git a/reference/stream/functions/stream-get-wrappers.xml b/reference/stream/functions/stream-get-wrappers.xml index bfeb9b380..5213d2b64 100644 --- a/reference/stream/functions/stream-get-wrappers.xml +++ b/reference/stream/functions/stream-get-wrappers.xml @@ -1,107 +1,107 @@ - - - - - - - stream_get_wrappers - 获取已注册的流类型 - - - &reftitle.description; - - arraystream_get_wrappers - - - - 获取在当前运行系统中已经注册并可使用的流类型列表。 - - - - - &reftitle.parameters; - &no.function.parameters; - - - - &reftitle.returnvalues; - - 返回一个索引数组，该数组里包含了当前运行系统中可使用的流类型的名称。 - - - - - &reftitle.examples; - - - <function>stream_get_wrappers</function> 例子 - - -]]> - - &example.outputs.similar; - - php - [1] => file - [2] => http - [3] => ftp - [4] => compress.bzip2 - [5] => compress.zlib -) -]]> - - - - - - 检查一个流类型是否存在 - - -]]> - - - - - - - &reftitle.seealso; - - stream_wrapper_register - - - - - + + + + + + + stream_get_wrappers + 获取已注册的流类型 + + + &reftitle.description; + + arraystream_get_wrappers + + + + 获取在当前运行系统中已经注册并可使用的流类型列表。 + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + 返回一个索引数组，该数组里包含了当前运行系统中可使用的流类型的名称。 + + + + + &reftitle.examples; + + + <function>stream_get_wrappers</function> 例子 + + +]]> + + &example.outputs.similar; + + php + [1] => file + [2] => http + [3] => ftp + [4] => compress.bzip2 + [5] => compress.zlib +) +]]> + + + + + + 检查一个流类型是否存在 + + +]]> + + + + + + + &reftitle.seealso; + + stream_wrapper_register + + + + + diff --git a/reference/stream/functions/stream-set-blocking.xml b/reference/stream/functions/stream-set-blocking.xml index c1d1f3d96..0e9461fb4 100644 --- a/reference/stream/functions/stream-set-blocking.xml +++ b/reference/stream/functions/stream-set-blocking.xml @@ -1,97 +1,97 @@ - - - - - - - stream_set_blocking - 为资源流设置阻塞或者阻塞模式 - - - &reftitle.description; - - boolstream_set_blocking - resourcestream - boolenable - - - 为 stream 设置阻塞或者非阻塞模式。 - - - 此函数适用于支持非阻塞模式的任何资源流（常规文件，套接字资源流等）。 - - - - - &reftitle.parameters; - - - - stream - - - 资源流。 - - - - - enable - - - 如果 enable 为 - &false;，资源流将会被转换为非阻塞模式；如果是 - &true;，资源流将会被转换为阻塞模式。 - 该参数的设置将会影响到像 - fgets 和 - fread 这样的函数从资源流里读取数据。 - 在非阻塞模式下，调用 fgets - 总是会立即返回；而在阻塞模式下，将会一直等到从资源流里面获取到数据才能返回。 - - - - - - - - - &reftitle.returnvalues; - - &return.success; - - - - - &reftitle.notes; - - 在 Windows 系统上，这对本地文件没有影响。Windows 不支持本地文件的非阻塞 IO。 - - - - - - &reftitle.seealso; - - stream_select - - - - + + + + + + + stream_set_blocking + 为资源流设置阻塞或者阻塞模式 + + + &reftitle.description; + + boolstream_set_blocking + resourcestream + boolenable + + + 为 stream 设置阻塞或者非阻塞模式。 + + + 此函数适用于支持非阻塞模式的任何资源流（常规文件，套接字资源流等）。 + + + + + &reftitle.parameters; + + + + stream + + + 资源流。 + + + + + enable + + + 如果 enable 为 + &false;，资源流将会被转换为非阻塞模式；如果是 + &true;，资源流将会被转换为阻塞模式。 + 该参数的设置将会影响到像 + fgets 和 + fread 这样的函数从资源流里读取数据。 + 在非阻塞模式下，调用 fgets + 总是会立即返回；而在阻塞模式下，将会一直等到从资源流里面获取到数据才能返回。 + + + + + + + + + &reftitle.returnvalues; + + &return.success; + + + + + &reftitle.notes; + + 在 Windows 系统上，这对本地文件没有影响。Windows 不支持本地文件的非阻塞 IO。 + + + + + + &reftitle.seealso; + + stream_select + + + + diff --git a/reference/stream/functions/stream-set-chunk-size.xml b/reference/stream/functions/stream-set-chunk-size.xml index 5d87fb6bc..04f66ad60 100644 --- a/reference/stream/functions/stream-set-chunk-size.xml +++ b/reference/stream/functions/stream-set-chunk-size.xml @@ -1,105 +1,105 @@ - - - - - - - stream_set_chunk_size - 设置资源流区块大小 - - - - &reftitle.description; - - intstream_set_chunk_size - resourcestream - intsize - - - 设置资源流区块大小。 - - - - - &reftitle.parameters; - - - stream - - - 目标资源流。 - - - - - size - - - 想设置的新的区块大小。 - - - - - - - - &reftitle.returnvalues; - - 成功的情况下返回资源流之前的区块大小。 - - - - - &reftitle.errors; - - 当 size 比 1 小或者比 PHP_INT_MAX 还大的时候将抛出 ValueError。 - - - - - &reftitle.changelog; - - - - - - &Version; - &Description; - - - - - 8.0.0 - - 当 size 比 1 小或者比 PHP_INT_MAX 还大的时候现在会抛出 - ValueError。之前产生 E_WARNING 级别的错误并返回 &false;。 - - - - - - - - - - - + + + + + + + stream_set_chunk_size + 设置资源流区块大小 + + + + &reftitle.description; + + intstream_set_chunk_size + resourcestream + intsize + + + 设置资源流区块大小。 + + + + + &reftitle.parameters; + + + stream + + + 目标资源流。 + + + + + size + + + 想设置的新的区块大小。 + + + + + + + + &reftitle.returnvalues; + + 成功的情况下返回资源流之前的区块大小。 + + + + + &reftitle.errors; + + 当 size 比 1 小或者比 PHP_INT_MAX 还大的时候将抛出 ValueError。 + + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + 8.0.0 + + 当 size 比 1 小或者比 PHP_INT_MAX 还大的时候现在会抛出 + ValueError。之前产生 E_WARNING 级别的错误并返回 &false;。 + + + + + + + + + + + diff --git a/reference/stream/functions/stream-socket-accept.xml b/reference/stream/functions/stream-socket-accept.xml index 95ec42a42..7cb15a799 100644 --- a/reference/stream/functions/stream-socket-accept.xml +++ b/reference/stream/functions/stream-socket-accept.xml @@ -1,140 +1,140 @@ - - - - - - - stream_socket_accept - 接受由 stream_socket_server 创建的套接字连接 - - - - &reftitle.description; - - resourcefalsestream_socket_accept - resourcesocket - floatnulltimeout&null; - stringpeer_name&null; - - - 接受由 stream_socket_server 创建的套接字连接。 - - - - - &reftitle.parameters; - - - - socket - - - 需要接受的服务器创建的套接字连接。 - - - - - timeout - - - 覆盖默认的套接字接受的超时时限。输入的时间需以秒为单位。默认情况下，使用 - default_socket_timeout - 作为超时时限。 - - - - - peer_name - - - 如果已选的传输器存在且有效的已连接客户端，则将该值设置为已连接客户端名称（地址）。 - - - - 也可以之后通过 stream_socket_get_name 来确定。 - - - - - - - - - - &reftitle.returnvalues; - - 返回接受套接之后的资源流 &return.falseforfailure;。 - - - - - &reftitle.changelog; - - - - - &Version; - &Description; - - - - - 8.0.0 - - 现在 timeout 可以为 null。 - - - - - - - - - &reftitle.notes; - - - 该函数不能被用于 UDP 套接字。可以使用 stream_socket_recvfrom 和 - stream_socket_sendto 来取而代之。 - - - - - - &reftitle.seealso; - - - stream_socket_server - stream_socket_get_name - stream_set_blocking - stream_set_timeout - fgets - fgetss - fwrite - fclose - feof - - - - - - - + + + + + + + stream_socket_accept + 接受由 stream_socket_server 创建的套接字连接 + + + + &reftitle.description; + + resourcefalsestream_socket_accept + resourcesocket + floatnulltimeout&null; + stringpeer_name&null; + + + 接受由 stream_socket_server 创建的套接字连接。 + + + + + &reftitle.parameters; + + + + socket + + + 需要接受的服务器创建的套接字连接。 + + + + + timeout + + + 覆盖默认的套接字接受的超时时限。输入的时间需以秒为单位。默认情况下，使用 + default_socket_timeout + 作为超时时限。 + + + + + peer_name + + + 如果已选的传输器存在且有效的已连接客户端，则将该值设置为已连接客户端名称（地址）。 + + + + 也可以之后通过 stream_socket_get_name 来确定。 + + + + + + + + + + &reftitle.returnvalues; + + 返回接受套接之后的资源流 &return.falseforfailure;。 + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + 现在 timeout 可以为 null。 + + + + + + + + + &reftitle.notes; + + + 该函数不能被用于 UDP 套接字。可以使用 stream_socket_recvfrom 和 + stream_socket_sendto 来取而代之。 + + + + + + &reftitle.seealso; + + + stream_socket_server + stream_socket_get_name + stream_set_blocking + stream_set_timeout + fgets + fgetss + fwrite + fclose + feof + + + + + + + diff --git a/reference/stream/functions/stream-socket-get-name.xml b/reference/stream/functions/stream-socket-get-name.xml index 1f95eed42..f6787238d 100644 --- a/reference/stream/functions/stream-socket-get-name.xml +++ b/reference/stream/functions/stream-socket-get-name.xml @@ -1,81 +1,81 @@ - - - - - - stream_socket_get_name - 获取本地或者远程的套接字名称 - - - - &reftitle.description; - - stringfalsestream_socket_get_name - resourcesocket - boolremote - - - 返回给定的本地或者远程套接字连接的名称。 - - - - - &reftitle.parameters; - - - - socket - - - 需要获取其名称的套接字连接。 - - - - - remote - - - 如果设置为 &true; ，那么将返回 remote 套接字连接名称；如果设置为 &false; 则返回 local 套接字连接名称。 - - - - - - - - - &reftitle.returnvalues; - - 套接字连接的名称，&return.falseforfailure;。 - - - - - &reftitle.seealso; - - - stream_socket_accept - - - - - + + + + + + stream_socket_get_name + 获取本地或者远程的套接字名称 + + + + &reftitle.description; + + stringfalsestream_socket_get_name + resourcesocket + boolremote + + + 返回给定的本地或者远程套接字连接的名称。 + + + + + &reftitle.parameters; + + + + socket + + + 需要获取其名称的套接字连接。 + + + + + remote + + + 如果设置为 &true; ，那么将返回 remote 套接字连接名称；如果设置为 &false; 则返回 local 套接字连接名称。 + + + + + + + + + &reftitle.returnvalues; + + 套接字连接的名称，&return.falseforfailure;。 + + + + + &reftitle.seealso; + + + stream_socket_accept + + + + +