From cca949ecfa148edd13c619df8f9e4e897d2810ee Mon Sep 17 00:00:00 2001 From: mowangjuanzi Date: Tue, 3 Dec 2024 10:00:46 +0800 Subject: [PATCH] Update install/errorfunc --- install/pecl.xml | 68 +-- reference/curl/constants_curl_setopt.xml | 35 +- reference/errorfunc/constants.xml | 518 ++++++++++-------- .../errorfunc/functions/trigger-error.xml | 28 +- 4 files changed, 365 insertions(+), 284 deletions(-) diff --git a/install/pecl.xml b/install/pecl.xml index 21e89bfab..73b8c7027 100755 --- a/install/pecl.xml +++ b/install/pecl.xml @@ -1,6 +1,6 @@ - + PECL 扩展安装 @@ -80,11 +80,11 @@ &url.php.svn;pecl/。要直接从 SVN 中下载，用以下命令： - - + + - +]]> + @@ -274,11 +274,11 @@ Loaded Configuration File C:\Program Files\PHP\8.2\php.ini PECL 使建立共享 PHP 扩展库更容易。用 pecl 命令这样做： - - - $ pecl install extname - - + + + 这将下载 extname 的源代码，编译之，并将 extname.so 安装到 beta 状态的包。如果没有 stable 包可用，也可以用以下命令安装一个 beta 包： - - - $ pecl install extname-beta - - + + + 也可以用此命令安装一个指定的版本： - - - $ pecl install extname-0.1 - - + + + 在 &php.ini; 中启用扩展之后，需要重新启动 web 服务以使更改生效。 @@ -475,16 +475,16 @@ $ mv extname-x.x.x extname 这将产生以下目录： - - - /path/to/php/src/dir/ext/extname - - + + + 此时 PHP 需要强制重新生成配置脚本，然后正常编译 PHP： - - + + - +]]> + 要运行 buildconf 脚本，需要 autoconf @@ -507,11 +507,11 @@ $ make install 取决于扩展库。通常不需要外部库文件的扩展库使用 。当然，在 buildconf 之后运行： - - - $ ./configure --help | grep extname - - + + + diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml index 8f48326d2..b3cd45afb 100644 --- a/reference/curl/constants_curl_setopt.xml +++ b/reference/curl/constants_curl_setopt.xml @@ -4142,10 +4142,7 @@ - Accepts a bitmask setting WebSocket behavior options. - The only available option is CURLWS_RAW_MODE. - Defaults to 0. - Available as of PHP 8.3.0 and cURL 7.86.0. + 接受位掩码设置 WebSocket 行为选项。唯一可用的选项是 CURLWS_RAW_MODE。默认为 0。自 PHP 8.3.0 和 cURL 7.86.0 起可用。 @@ -4156,7 +4153,7 @@ - A callable with the following signature: + 具有以下签名的 callable： intcallback resourcecurlHandle @@ -4170,7 +4167,7 @@ curlHandle - The cURL handle. + cURL 句柄。 @@ -4178,7 +4175,7 @@ bytesToDownload - The total number of bytes expected to be downloaded in this transfer. + 本次传输预计下载的总字节数。 @@ -4186,7 +4183,7 @@ bytesDownloaded - The number of bytes downloaded so far. + 迄今已下载的字节数。 @@ -4194,7 +4191,7 @@ bytesToUpload - The total number of bytes expected to be uploaded in this transfer. + 本次传输预计上传的总字节数。 @@ -4202,14 +4199,12 @@ bytesUploaded - The number of bytes uploaded so far. + 迄今已上传的字节数。 - Return 1 to abort the transfer - and set a CURLE_ABORTED_BY_CALLBACK error. - Available as of PHP 8.2.0 and cURL 7.32.0. + 返回 1 可中止传输并设置 CURLE_ABORTED_BY_CALLBACK 错误。自 PHP 8.2.0 和 cURL 7.32.0 起可用。 @@ -4220,12 +4215,9 @@ - A timeout in seconds cURL will wait for a response from an - FTP, SFTP, IMAP, - SCP, SMTP, or a POP3 server. - This option replaces the existing CURLOPT_FTP_RESPONSE_TIMEOUT - option which is deprecated in cURL 7.85.0. - Available as of PHP 8.4.0. + cURL 将等待来自 FTP、SFTP、IMAP、SCP、SMTP + 或 POP3 服务器响应的超时秒数。此选项取代了现有的 CURLOPT_FTP_RESPONSE_TIMEOUT 选项，该选项在 + cURL 7.85.0 中已弃用。自 PHP 8.4.0 起可用。 @@ -4236,10 +4228,7 @@ - Specifies the OAuth 2.0 access token. - Set to &null; to disable. - Defaults to &null;. - Available as of PHP 7.0.7 and cURL 7.33.0. + 指定 OAuth 2.0 访问 token。设置为 &null; 以禁用。默认为 &null;。自 PHP 7.0.7 和 cURL 7.33.0 起可用。 diff --git a/reference/errorfunc/constants.xml b/reference/errorfunc/constants.xml index 42abf65a2..0d9e8db7f 100644 --- a/reference/errorfunc/constants.xml +++ b/reference/errorfunc/constants.xml @@ -1,235 +1,305 @@ - + + &reftitle.constants; &extension.constants.core; - + + + 以下常量（相应的数值或其符号名称）用作位掩码来指定要报告的错误。可以使用按位运算符来组合这些值或屏蔽某些类型的错误。 + + + + + 常量的名称可以在 &php.ini; 中使用，而不是它们对应的原始数值。但是，&php.ini; 中只能理解 + |、~、^、!、& + 运算符。 + + + + - 你可以使用它们在 &php.ini; 中的常量名称; 但是在 PHP 之外，例如在 &httpd.conf; 之中, 你必须使用二进制位掩码来代替。 + 无法在 PHP 之外使用符号名称。例如，在 &httpd.conf; 中，必须使用计算出的位掩码值。 - - - - 错误和日志记录 - - - - 值 - 常量 - 说明 - 备注 - - - - - 1 - - E_ERROR - (int) - - - 致命的运行时错误。这类错误一般是不可恢复的情况，例如内存分配导致的问题。后果是导致脚本终止不再继续运行。 - - - - - - 2 - - E_WARNING - (int) - - - 运行时警告 (非致命错误)。仅给出提示信息，但是脚本不会终止运行。 - - - - - - 4 - - E_PARSE - (int) - - - 编译时语法解析错误。解析错误仅仅由分析器产生。 - - - - - - 8 - - E_NOTICE - (int) - - - 运行时通知。表示脚本遇到可能会表现为错误的情况，但是在可以正常运行的脚本里面也可能会有类似的通知。 - - - - - - 16 - - E_CORE_ERROR - (int) - - - 在 PHP 初始化启动过程中发生的致命错误。该错误类似 - E_ERROR，但是是由 PHP 引擎核心产生的。 - - - - - - 32 - - E_CORE_WARNING - (int) - - - PHP 初始化启动过程中发生的警告 (非致命错误) 。类似 E_WARNING，但是是由 PHP 引擎核心产生的。 - - - - - - 64 - - E_COMPILE_ERROR - (int) - - - 致命编译时错误。类似 E_ERROR，但是是由 Zend 脚本引擎产生的。 - - - - - - 128 - - E_COMPILE_WARNING - (int) - - - 编译时警告 (非致命错误)。类似 - E_WARNING，但是是由 Zend 脚本引擎产生的。 - - - - - - 256 - - E_USER_ERROR - (int) - - - 用户产生的错误信息。类似 - E_ERROR，但是是由用户自己在代码中使用 PHP 函数 trigger_error来产生的。 - - - - - - 512 - - E_USER_WARNING - (int) - - - 用户产生的警告信息。类似 - E_WARNING，但是是由用户自己在代码中使用 PHP 函数 trigger_error来产生的。 - - - - - - 1024 - - E_USER_NOTICE - (int) - - - 用户产生的通知信息。类似 - E_NOTICE，但是是由用户自己在代码中使用 PHP 函数 trigger_error来产生的。 - - - - - - 2048 - - E_STRICT - (int) - - - 启用 PHP 对代码的修改建议，以确保代码具有最佳的互操作性和向前兼容性。 - - - - - - 4096 - - E_RECOVERABLE_ERROR - (int) - - - 可被捕捉的致命错误。 它表示发生了一个可能非常危险的错误，但是还没有导致PHP引擎处于不稳定的状态。 如果该错误没有被用户自定义句柄捕获 (参见 - set_error_handler)，将成为一个 E_ERROR　从而脚本会终止运行。 - - - - - - 8192 - - E_DEPRECATED - (int) - - - 运行时通知。启用后将会对在未来版本中可能无法正常工作的代码给出警告。 - - - - - - 16384 - - E_USER_DEPRECATED - (int) - - - 用户产生的警告信息。 类似 - E_DEPRECATED, 但是是由用户自己在代码中使用PHP函数 trigger_error来产生的。 - - - - - - 32767 - - E_ALL - (int) - - - 所有错误、警告和通知。 - - - - - - -
- - - 上面的值（数值或者符号）用于建立一个二进制位掩码，来制定要报告的错误信息。可以使用按位运算符来组合这些值或者屏蔽某些类型的错误。请注意，在 &php.ini; 之中，只有'|', '~', '!', '^' 和 '&' 会正确解析。 - - + + + + + + E_ERROR + (int) + + + + 致命的运行时错误。这类错误一般是不可恢复的情况，例如内存分配导致的问题。后果是导致脚本终止不再继续运行。 + + + 常量值 1 + + + + + + + E_WARNING + (int) + + + + 运行时警告 (非致命错误)。仅给出提示信息，但是脚本不会终止运行。 + + + 常量值：2 + + + + + + + E_PARSE + (int) + + + + 编译时解析错误。解析错误只由解析器产生。 + + + 常量值：4 + + + + + + + E_NOTICE + (int) + + + + 运行时通知。表示脚本遇到可能会表现为错误的情况，但是在可以正常运行的脚本里面也可能会有类似的通知。 + + + 常量值：8 + + + + + + + E_CORE_ERROR + (int) + + + + 在 PHP 初始化启动过程中发生的致命错误。该错误类似 + E_ERROR，但是是由 PHP 引擎核心产生。 + + + 常量值：16 + + + + + + + E_CORE_WARNING + (int) + + + + PHP 初始化启动过程中发生的警告 (非致命错误) 。类似 E_WARNING，但是是由 PHP 引擎核心产生。 + + + 常量值：32 + + + + + + + E_COMPILE_ERROR + (int) + + + + 致命编译时错误。类似 E_ERROR，但是是由 Zend 脚本引擎产生。 + + + 常量值：64 + + + + + + + E_COMPILE_WARNING + (int) + + + + 编译时警告 (非致命错误)。类似 + E_WARNING，但是是由 Zend 脚本引擎产生。 + + + 常量值：128 + + + + + + + E_DEPRECATED + (int) + + + + 运行时弃用通知。启用后将会对在未来版本中可能无法正常工作的代码给出警告。 + + + 常量值：8192 + + + + + + + E_USER_ERROR + (int) + + + + 用户产生的错误信息。类似 + E_ERROR，但是是由用户自己在代码中使用 PHP + 函数 trigger_error 来产生。 + + + 常量值：256 + + + + 自 PHP 8.4.0 起，已弃用此常量与 trigger_error 一起使用的用法。建议改为 + &throw; Exception 或调用 exit。 + + + + + + + + E_USER_WARNING + (int) + + + + 用户产生的警告信息。类似 + E_WARNING，由用户自己在代码中使用 PHP + 函数 trigger_error 来产生。 + + + 常量值：512 + + + + + + + E_USER_NOTICE + (int) + + + + 用户产生的通知信息。类似 + E_NOTICE，由用户自己在代码中使用 PHP + 函数 trigger_error 来产生。 + + + 常量值：1024 + + + + + + + E_USER_DEPRECATED + (int) + + + + 用户产生的警告信息。 类似 + E_DEPRECATED, 由用户自己在代码中使用 PHP + 函数 trigger_error 来产生。 + + + 常量值：16384 + + + + + + + E_STRICT + (int) + + + + PHP 发出有关执行代码的运行时建议，以确保向前兼容。 + + + 常量值：2048 + + + + 此错误级别未使用，且自 PHP 8.4.0 起已弃用。 + + + + + + + + E_RECOVERABLE_ERROR + (int) + + + + 旧引擎“exception”对应于可捕获的致命错误。与 Error + 类似，但必须通过用户定义的错误处理程序捕获（请参阅 + set_error_handler）。如果不处理，则其行为类似于 E_ERROR。 + + + 常量值：4096 + + + + 此错误级别实际上未使用，唯一可能发生这种情况的情况是将 &object; 解释为 bool + 失败。这只会发生在内部对象中。 + + + PHP 8.4.0 之前，最常见的示例是在条件中使用 GMP 实例。 + + + + + + + + E_ALL + (int) + + + + 包含每个错误、警告和通知的位掩码。 + + + 常量值：32767 + + + + + - + @@ -41,6 +41,12 @@ 该 error 所特定的错误类型。仅 E_USER_* 系列常量对其有效，默认是 E_USER_NOTICE。 + + + 现已弃用传递 E_USER_ERROR 作为 error_level。抛出 + Exception 或调用 exit。 + + @@ -73,6 +79,19 @@ + + 8.4.0 + + 现已弃用传递 E_USER_ERROR 作为 error_level。抛出 + Exception 或调用 exit。 + + + + 8.4.0 + + 此函数现在返回类型是 true 而不是 bool。 + + 8.0.0 @@ -95,9 +114,11 @@ ]]> @@ -124,6 +145,7 @@ if ($divisor == 0) { set_error_handler restore_error_handler 错误级别常量 + Deprecated 注解