diff --git a/language-snippets.ent b/language-snippets.ent index e79eee81a..498bb4e49 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,6 +1,6 @@ - + @@ -362,6 +362,9 @@ xmlns="http://docbook.org/ns/docbook">本特性已自 PHP 8.3.0 xmlns="http://docbook.org/ns/docbook">此函数自 PHP 8.3.0 起弃用。强烈建议不要应用此函数。'> +此函数自 PHP 8.4.0 +起弃用。强烈建议不要应用此函数。'> 将肯定会在未来被移除。'> @@ -1129,6 +1132,16 @@ purposes.'> '> + +dba_open 或 dba_popen 返回的 Dba\Connection 实例。'> + + 8.4.0 + + dba 参数现在接受 Dba\Connection 实例， + 之前接受有效的 dba &resource;。 + +'> + @@ -1944,24 +1957,6 @@ It is strongly recommended to avoid timezone abbreviations. 此说明在文档被打印或显示时不可见，只在文档用 Acrobat Distiller 或 Ghostview 转换成 PDF 时显示。'> - - - - -&sm.disabled;'> - - -当启用 -安全模式时， -PHP 会检查被操作的文件或目录是否与被执行的脚本有相同的 UID（所有者）。'> - - - -当启用 -安全模式时， -PHP 会在执行脚本时检查被脚本操作的目录是否与被执行的脚本有相同的 UID（所有者）。'> - - 此函数受 open_basedir 影响。'> @@ -1972,35 +1967,6 @@ PHP 会在执行脚本时检查被脚本操作的目录是否与被执行的脚 '> - - - - - - - -安全模式 启用时，命令字符串会被 -escapeshellcmd 转换。因此，echo y | echo x 会变成 -echo y \| echo x。'> - - -安全模式 启用时，可仅可用 -safe_mode_exec_dir 执行文件。实际上，现在不允许在到可执行的路径中存在 .. 组件。'> - - - - - - - - - - -安全模式 时，不能使用此函数。'> - - 此扩展没有在 &php.ini; 中定义配置指令。'> 此扩展没有定义资源类型。'> @@ -2041,10 +2007,6 @@ PHP 会在执行脚本时检查被脚本操作的目录是否与被执行的脚 '> - - -此扩展需要 PHP 5。'> - 下列常量由此驱动定义，且仅在扩展编译入 PHP 或在运行时动态载入时可用。另外，使用此驱动时，仅会使用这些驱动特定的常量。使用其他驱动的驱动特定的常量可能会导致不可预见的情况。如果代码可运行于多个驱动，PDO::getAttribute @@ -2173,14 +2135,6 @@ while PGSQL_BOTH will return both numerical and associative SQL 安全模式'> - - -debug_level由加上 XXX_TRACE -常量而形成的整数。不建议使用 -MEMORY_TRACE。这会很慢且似乎不精确。 -ASSIGNMENT_TRACE 还未被实现。要打开所有跟踪功能(TIMING, FUNCTIONS, ARGS SUMMARY (比如 strace -c)) 则使用 99 作为值。 -'> - @@ -2308,26 +2262,6 @@ PHP FastCGI 的主要实现，包含大部分对高负载网站有用的功能 此函数将 NULL 字段设置为 PHP &null; 值。'> - - - - -link_identifiermSQL 连接。如果不指定，则使用由 -msql_connect 最近打开的连接。如果没有找到该连接，函数会尝试通过调用 -msql_connect 建立连接并使用它。 -'> - - - -resultresource -型的结果集。此结果集来自对 msql_query -的调用。'> - - -field_offset数值型字段偏移量。 -field_offset 从 1 -开始。'> - @@ -2392,43 +2326,6 @@ link_identifier MySQL 连接. 如果该连接 执行完毕后自动销毁，所以手动关闭连接，并释放资源是可选的。但是还是推荐你在代码中显性的执行该操作，这对提高代码性能有帮助。参考文档 资源释放'> - - - - -此函数仅适用于对 Sybase 使用 CT 库接口，而不适用于 DB 库。'> - - - -此函数仅适用于对 Sybase 使用 DB 库接口，而不适用于 CT 库。'> - - - -link_identifierSybase -连接。如不指定连接标识，则使用由 sybase_connect -最近打开的连接。如果没有找到该连接，会尝试不带参数调用 -sybase_connect 来创建。如没有找到连接或无法建立连接，则会生成 -E_WARNING 级别的错误。 - -'> - - -可选参数 mode -决定单位长度。如为 0 或省略，则为页面使用的默认单位。其他情况下，座标用 postscript 点进行度量，而忽略当前单位。'> - - - - -mode可选参数 mode -决定单位长度。如为 0 或省略，则为页面使用的默认单位。其他情况下，座标用 postscript 点进行度量，而忽略当前单位。 -'> - - - - -pdf_document文档句柄，由 -cpdf_open返回。'> - 扩展的属性有两种 不同的命名空间：user 和 root。user 命名空间对所有用户均有效，而 root @@ -2441,9 +2338,6 @@ xattr 默认在 user 命名空间上操作，但可使用 地址（例如 fe80::1）时必须用方括号将 IP 围起来——例如， tcp://[fe80::1]:80。'> -在 -PHP 5.0.0 开始加入了对 IPv6 的支持。'> - Tidy 对象。'> @@ -2510,22 +2404,10 @@ Windows 环境下的 Apache 配置文件中添加路径值时，所有的反斜 - -此函数不能用来操作当前正常运行（或运行链上）的方法。 -'> - - + 此函数不能用来操作当前正常运行（或运行链上）的方法。 '> -沙箱支持（是 runkit_lint，runkit_lint_file -函数，与 Runkit_Sandbox 类所必需）仅可用于 -PHP 5.1.0 或 PHP 5.0 的特别修补版本，并需启用线程安全。更多信息可参见 runkit 包中的 -README 文件。'> - - - - 默认情况下，仅在用户空间可删除，重命名，或者修改函数。为了覆盖内部函数，必须启用 &php.ini; 中的 runkit.internal_override 设置。 @@ -2671,13 +2553,6 @@ PHP 5.1.0 或 PHP 5.0 的特别修补版本，并需启用线程安全。更多 '> - - - 此函数在 PHP 5 中不再存在. 你应该使用更自然的面向对象语法操作属性及方法。 - - -'> - 此方法需要 @@ -2685,17 +2560,6 @@ PHP 5.1.0 或 PHP 5.0 的特别修补版本，并需启用线程安全。更多 0 以适合 Phar 对象. 否则, 将抛出PharException.'> -此方法已经从 phar -扩展 2.0.0以上版本中删除。可使用 -Phar::compress，Phar::decompress，Phar::compressFiles -和 Phar::decompressFiles替代。'> - - -此方法已经从 phar -扩展 2.0.0以上版本中删除。可使用 -PharFileInfo::isCompressed，PharFileInfo::decompress 和 -PharFileInfo::compress替代。'> - Phar::addFile, Phar::addFromString and Phar::offsetSet @@ -2788,7 +2652,14 @@ PHP 5.1.0 或 PHP 5.0 的特别修补版本，并需启用线程安全。更多 数据结构'> 异常'> -SPL 提供一系列标准异常。可参考。'> + + SPL 提供了一套标准的异常。 + + + 可参考 。 + +'> 文件处理'> SPL 提供 一些与文件相关的类。'> @@ -2962,69 +2833,6 @@ xmlns="http://docbook.org/ns/docbook">read_preferenceThe read preference mode: MongoClient::RP_PRIMARY, MongoClient::RP_PRIMARY_PREFERRED, MongoClient::RP_SECONDARY, MongoClient::RP_SECONDARY_PREFERRED, or MongoClient::RP_NEAREST.tagsAn array of zero or more tag sets, where each tag set is itself an array of criteria used to match tags on replica set members.'> -Returns &true; on success, or &false; otherwise.'> -Emits E_WARNING if either parameter is invalid, or if one or more tag sets are provided with the MongoClient::RP_PRIMARY read preference mode.'> -This function returns an array describing the read preference. The array contains the values type for the string read preference mode (corresponding to the MongoClient constants), and tagsets containing a list of all tag set criteria. If no tag sets were specified, tagsets will not be present in the array.'> -wThe write concern. This may be an integer denoting the number of servers required to acknowledge the write, or a string mode (e.g. "majority").wtimeoutThe maximum number of milliseconds to wait for the server to satisfy the write concern.'> -Returns &true; on success, or &false; otherwise.'> -Emits E_WARNING if the w parameter is not an integer or string value.'> -This function returns an array describing the write concern. The array contains the values w for an integer acknowledgement level or string mode, and wtimeout denoting the maximum number of milliseconds to wait for the server to satisfy the write concern.'> -"maxTimeMS"Specifies a cumulative time limit in milliseconds for processing the operation on the server (does not include idle time). If the operation is not completed by the server within the timeout period, a MongoExecutionTimeoutException will be thrown.'> -"background"Builds the index in the background so that building an index does not block other database activities. Specify &true; to build in the background. The default value is &false;.Prior to MongoDB 2.6.0, index builds on secondaries were executed as foreground operations, irrespective of this option. See Building Indexes with Replica Sets for more information.'> -"dropDups"Specify &true; to force creation of a unique index where the collection may contain duplicate values for a key. MongoDB will index the first occurrence of a key and delete all subsequent documents from the collection that contain a duplicate value for that key. The default value is &false;."dropDups" may delete data from your database. Use with extreme caution.This option is not supported on MongoDB 2.8+. Index creation will fail if the collection contains duplicate values.'> -"expireAfterSeconds"The value of this option should specify the number of seconds after which a document should be considered expired and automatically removed from the collection. This option is only compatible with single-field indexes where the field will contain MongoDate values.This feature is available in MongoDB 2.2+. See Expire Data from Collections by Setting TTL for more information.'> -"name"A optional name that uniquely identifies the index.By default, the driver will generate an index name based on the index's field(s) and ordering or type. For example, a compound index array("x" => 1, "y" => -1) would be named "x_1_y_-1" and a geospatial index array("loc" => "2dsphere") would be named "loc_2dsphere". For indexes with many fields, it is possible that the generated name might exceed MongoDB's limit for index names. The "name" option may be used in that case to supply a shorter name.'> -"sparse"Specify &true; to create a sparse index, which only indexes documents containing a specified field. The default value is &false;.'> -"unique"Specify &true; to create a unique index. The default value is &false;. This option applies only to ascending/descending indexes.When MongoDB indexes a field, if a document does not have a value for the field, a &null; value is indexed. If multiple documents do not contain a field, a unique index will reject all but the first of those documents. The "sparse" option may be used to overcome this, since it will prevent documents without the field from being indexed.'> -This method will use the listCollections database command when communicating with MongoDB 2.8+. For previous database versions, the method will query the special system.namespaces collection.'> -"filter"Optional query criteria. If provided, this criteria will be used to filter the collections included in the result.Relevant fields that may be queried include "name" (collection name as a string, without the database name prefix) and "options" (object containing options used to create the collection)..MongoDB 2.6 and earlier versions require the "name" criteria, if specified, to be a string value (i.e. equality match). This is because the driver must prefix the value with the database name in order to query the system.namespaces collection. Later versions of MongoDB do not have this limitation, as the driver will use the listCollections command.'> -"includeSystemCollections"Boolean, defaults to &false;. Determines whether system collections should be included in the result.'> -"w"See Write Concerns. The default value for MongoClient is 1.'> -"wtimeout"Deprecated alias for "wTimeoutMS".'> -"wTimeoutMS"This option specifies the time limit, in milliseconds, for write concern acknowledgement. It is only applicable when "w" is greater than 1, as the timeout pertains to replication. If the write concern is not satisfied within the time limit, a MongoCursorException will be thrown. A value of 0 may be specified to block indefinitely. The default value for MongoClient is 10000 (ten seconds).'> -"fsync"Boolean, defaults to &false;. If journaling is enabled, it works exactly like "j". If journaling is not enabled, the write operation blocks until it is synced to database files on disk. If &true;, an acknowledged insert is implied and this option will override setting "w" to 0.If journaling is enabled, users are strongly encouraged to use the "j" option instead of "fsync". Do not use "fsync" and "j" simultaneously, as that will result in an error.'> -"socketTimeoutMS"This option specifies the time limit, in milliseconds, for socket communication. If the server does not respond within the timeout period, a MongoCursorTimeoutException will be thrown and there will be no way to determine if the server actually handled the write or not. A value of -1 may be specified to block indefinitely. The default value for MongoClient is 30000 (30 seconds).'> -"j"Boolean, defaults to &false;. Forces the write operation to block until it is synced to the journal on disk. If &true;, an acknowledged write is implied and this option will override setting "w" to 0.If this option is used and journaling is disabled, MongoDB 2.6+ will raise an error and the write will fail; older server versions will simply ignore the option.'> -"safe"Deprecated. Please use the write concern "w" option.'> -"timeout"Deprecated alias for "socketTimeoutMS".'> -Throws MongoCursorException if the "w" option is set and the write fails.Throws MongoCursorTimeoutException if the "w" option is set to a value greater than one and the operation takes longer than MongoCursor::$timeout milliseconds to complete. This does not kill the operation on the server, it is a client-side timeout. The operation in MongoCollection::$wtimeout is milliseconds.'> -Issues E_DEPRECATED warning'> -These fields may also overwrite those that would be created automatically by the driver, as described in the MongoDB core documentation for the files collection. Some practical use cases for this behavior would be to specify a custom chunkSize or _id for the file.'> -Returns the _id of the saved file document. This will be a generated MongoId unless an _id was explicitly specified in the metadata parameter.'> -An array of Write Options.keyvalue meaningw (int|string)Write concern valuewtimeout (int)Maximum time to wait for replicationorderedDetermines if MongoDB must apply this batch in order. Ordered writes execute serially (i.e. one at a time) and execution will stop after the first error. Unordered writes may execute in parallel and execution will not stop after the first error. Defaults to &true;j (bool)Wait for journaling on the primary. This value is discouraged, use WriteConcern insteadfsync (bool)Wait for fsync on the primary. This value is discouraged, use WriteConcern instead'> -The MongoCollection to execute the batch on. Its write concern will be copied and used as the default write concern if none is given as $write_options or during MongoWriteBatch::execute.'> - server An array containing the basic information about the server that was picked. key value hash server hash, example: localhost:27017;-;X;56052 type Node type (primary/secondary/mongos/arbiter): 2 max_bson_size The maximum BSON Size over the wire this node accepts: 16777216 max_message_size The maximum Message Size over the wire this node accepts: 48000000 request_id The request identifier for this message: 42 '> - writeOptions key value ordered boolean, if the operation (in case of batch operation) must be executed sequentually (ordered=true) writeConcern An array of writeConcern options (see below) writeConcern array values key value fsync boolean, force flushing to disk before returning j boolean, force journal write before returning wtimeout integer, milliseconds, maximum time the primary is allowed to wait to verify replication w integer=server count, or string=replication-tag
'> - protocolOptions key value message_length The total size (in bytes) of the encoded message being sent over the wire request_id The request identifier for this message: 42 namespace The MongoDB namespace used for the protocol message dbname.collectionname '> -This extension that defines this class -is deprecated. Instead, the MongoDB extension should be used. -Alternatives to this class include:'> -This extension that defines this class -is deprecated. Instead, the MongoDB extension should be used. -There is no equivalent for this class in the new extension.'> -This extension that defines this method -is deprecated. Instead, the MongoDB extension should be used. -Alternatives to this method include:'> -This extension that defines this method -is deprecated. Instead, the MongoDB extension should be used. -There is no equivalent for this method in the new extension.'> -This extension that defines this method -is deprecated. Instead, the MongoDB extension should be used. -There is no equivalent for this method in the new extension, but there is an -alternative in the PHP library:'> - -This extension is deprecated. Instead, -the MongoDB extension should be -used.'> - @@ -3761,6 +3569,55 @@ local: { '> + + + + " "： ASCII SP 字符 + 0x20，一个普通的空格。 + + + + + "\t"： ASCII HT 字符 + 0x09，一个制表符。 + + + + + "\n"： ASCII LF 字符 + 0x0A，一个换行符。 + + + + + "\r"： ASCII CR 字符 + 0x0D，一个回车符。 + + + + + "\0"： ASCII NUL 字符 + 0x00，一个 NUL 字节。 + + + + + "\v"： ASCII VT 字符 + 0x0B，一个垂直制表符。 + + + +'> + + + 可选，也可以使用 characters 参数指定要剥离的字符。 + 只需列出所有需要剥离的字符。 + 使用 .. 可以指定一个递增的字符范围。 + +'> + An optional argument defining the encoding used when converting characters. diff --git a/reference/mysql/functions/mysql-fetch-array.xml b/reference/mysql/functions/mysql-fetch-array.xml index dcb487132..372fcd7e1 100644 --- a/reference/mysql/functions/mysql-fetch-array.xml +++ b/reference/mysql/functions/mysql-fetch-array.xml @@ -28,7 +28,7 @@ &reftitle.parameters; - &msql.result.description; + &mysql.result.description; result_type diff --git a/reference/mysqli/mysqli/kill.xml b/reference/mysqli/mysqli/kill.xml index fe0b1a0b5..43433b3d4 100644 --- a/reference/mysqli/mysqli/kill.xml +++ b/reference/mysqli/mysqli/kill.xml @@ -1,7 +1,7 @@ - - + + mysqli::kill @@ -9,6 +9,10 @@ 让服务器杀死一个 MySQL 线程 + + &warn.deprecated.function-8-4-0; + + &reftitle.description; &style.oop; diff --git a/reference/mysqli/mysqli/ping.xml b/reference/mysqli/mysqli/ping.xml index cabdd5c2c..fb76c2028 100644 --- a/reference/mysqli/mysqli/ping.xml +++ b/reference/mysqli/mysqli/ping.xml @@ -1,7 +1,7 @@ - - + + mysqli::ping @@ -9,6 +9,10 @@ ping 一个连接，或者如果连接处于断开状态，重新连接 + + &warn.deprecated.function-8-4-0; + + &reftitle.description; &style.oop; diff --git a/reference/mysqli/mysqli/refresh.xml b/reference/mysqli/mysqli/refresh.xml index 70dd5e9bb..dfe982a0c 100644 --- a/reference/mysqli/mysqli/refresh.xml +++ b/reference/mysqli/mysqli/refresh.xml @@ -1,14 +1,18 @@ - - + + mysqli::refresh mysqli_refresh 刷新 - + + + &warn.deprecated.function-8-4-0; + + &reftitle.description; &style.oop;