多字节字符串函数 mb_ereg_search_setpos Set start point of next regular expression match

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

mb_ereg_search_setpos

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

mb_ereg_search_setpos — Set start point of next regular expression match

说明

mb_ereg_search_setpos(int $offset): bool

mb_ereg_search_setpos() sets the starting point of a match for mb_ereg_search().

参数

offset: The position to set. If it is negative, it counts from the end of the string.

返回值

成功时返回 true，或者在失败时返回 false。

更新日志

版本	说明
7.1.0	Support for negative `offset`s has been added.

注释

注意:
mb_regex_encoding() 指定的内部编码或字符编码将会当作此函数用的字符编码。

参见

mb_regex_encoding() - Set/Get character encoding for multibyte regex
mb_ereg_search_init() - Setup string and regular expression for a multibyte regular expression match

阅读全文 »

多字节字符串函数 mb_ereg_search Multibyte regular expression match for predefined multibyte string

发表日期：2021-07-01 08:55:51 | 来源： | 分类：多字节字符串函数

mb_ereg_search

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

mb_ereg_search — Multibyte regular expression match for predefined multibyte string

说明

mb_ereg_search(string|null $pattern = null, string|null $options = null): bool

Performs a multibyte regular expression match for a predefined multibyte string.

参数

pattern: The search pattern.
options: The search option. See mb_regex_set_options() for explanation.

返回值

mb_ereg_search() returns true if the multibyte string matches with the regular expression, or false otherwise. The string for matching is set by mb_ereg_search_init(). If pattern is not specified, the previous one is used.

更新日志

版本	说明
8.0.0	`pattern` and `options` are nullable now.

注释

注意:
mb_regex_encoding() 指定的内部编码或字符编码将会当作此函数用的字符编码。

参见

mb_regex_encoding() - Set/Get character encoding for multibyte regex
mb_ereg_search_init() - Setup string and regular expression for a multibyte regular expression match

阅读全文 »

多字节字符串函数 mb_ereg Regular expression match with multibyte support

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

mb_ereg

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

mb_ereg — Regular expression match with multibyte support

说明

mb_ereg(string $pattern, string $string, array &$matches = null): bool

Executes the regular expression match with multibyte support.

参数

pattern

The search pattern.

string

The search string.

matches

If matches are found for parenthesized substrings of pattern and the function is called with the third argument matches, the matches will be stored in the elements of the array matches. If no matches are found, matches is set to an empty array.

$matches[1] will contain the substring which starts at the first left parenthesis; $matches[2] will contain the substring starting at the second, and so on. $matches[0] will contain a copy of the complete string matched.

返回值

Returns whether pattern matches string.

更新日志

版本	说明
8.0.0	This function returns `true` on success now. Previously, it returned the byte length of the matched string if a match for `pattern` was found in `string` and `matches` was passed. If the optional parameter `matches` was not passed or the length of the matched string was `0`, this function returned `1`.
7.1.0	mb_ereg() will now set `matches` to an empty array, if nothing matched. Formerly, `matches` was not modified in that case.

注释

注意:
mb_regex_encoding() 指定的内部编码或字符编码将会当作此函数用的字符编码。

参见

mb_regex_encoding() - Set/Get character encoding for multibyte regex
mb_eregi() - Regular expression match ignoring case with multibyte support

阅读全文 »

多字节字符串函数 mb_eregi_replace Replace regular expression with multibyte support ignoring case

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

mb_eregi_replace

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

mb_eregi_replace — Replace regular expression with multibyte support ignoring case

说明

mb_eregi_replace(
    string $pattern,
    string $replacement,
    string $string,
    string|null $options = null
): string|false|null

Scans string for matches to pattern, then replaces the matched text with replacement.

参数

pattern: The regular expression pattern. Multibyte characters may be used. The case will be ignored.
replacement: The replacement text.
string: The searched string.
options: The search option. See mb_regex_set_options() for explanation.

返回值

The resultant string or false on error. If string is not valid for the current encoding, null is returned.

更新日志

版本	说明
8.0.0	`options` is nullable now.
7.1.0	The function checks whether `string` is valid for the current encoding.
7.1.0	The `e` modifier has been deprecated.

注释

注意:
mb_regex_encoding() 指定的内部编码或字符编码将会当作此函数用的字符编码。

警告

处理非信任的输入时从不使用 e 修饰符，就不会转码（即调用 preg_replace()）。不注意这些会很可能会导致应用程序引发远程代码执行的漏洞。

参见

mb_regex_encoding() - Set/Get character encoding for multibyte regex
mb_ereg_replace() - Replace regular expression with multibyte support

阅读全文 »

多字节字符串函数 mb_eregi Regular expression match ignoring case with multibyte support

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

mb_eregi

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

mb_eregi — Regular expression match ignoring case with multibyte support

说明

mb_eregi(string $pattern, string $string, array &$matches = null): bool

Executes the case insensitive regular expression match with multibyte support.

参数

pattern

The regular expression pattern.

string

The string being searched.

matches

If matches are found for parenthesized substrings of pattern and the function is called with the third argument matches, the matches will be stored in the elements of the array matches. If no matches are found, matches is set to an empty array.

$matches[1] will contain the substring which starts at the first left parenthesis; $matches[2] will contain the substring starting at the second, and so on. $matches[0] will contain a copy of the complete string matched.

返回值

Returns whether pattern matches string.

更新日志

版本	说明
8.0.0	This function returns `true` on success now. Previously, it returned the byte length of the matched string if a match for `pattern` was found in `string` and `matches` was passed. If the optional parameter `matches` was not passed or the length of the matched string was `0`, this function returned `1`.
7.1.0	mb_eregi() will now set `matches` to an empty array, if nothing matched. Formerly, `matches` was not modified in that case.

注释

注意:
mb_regex_encoding() 指定的内部编码或字符编码将会当作此函数用的字符编码。

参见

mb_regex_encoding() - Set/Get character encoding for multibyte regex
mb_ereg() - Regular expression match with multibyte support

阅读全文 »

多字节字符串函数 mb_get_info 获取 mbstring 的内部设置

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

mb_get_info

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

mb_get_info — 获取 mbstring 的内部设置

说明

mb_get_info(string $type = "all"): mixed

mb_get_info() 返回 mbstring 参数的内部设定。

参数

type

如果没有设定 type 或者将其设定为 "all" 将会返回以下内容 "internal_encoding", "http_input", "http_output", "http_output_conv_mimetypes", "mail_charset", "mail_header_encoding", "mail_body_encoding", "illegal_chars", "encoding_translation", "language", "detect_order", "substitute_character" 和 "strict_detection"。

如果 type 设定为类似 "internal_encoding", "http_input", "http_output", "http_output_conv_mimetypes", "mail_charset", "mail_header_encoding", "mail_body_encoding", "illegal_chars", "encoding_translation", "language", "detect_order", "substitute_character" 或 "strict_detection"，将返回该参数的设置。

返回值

如果没有指定 type 将返回类型信息的数组，否则将返回指定 type 的信息。或者在失败时返回 false。

更新日志

版本	说明
8.0.0	参数 `type` 中的 `"func_overload"` 和 `"func_overload_list"` 不再被支持。

参见

mb_regex_encoding() - Set/Get character encoding for multibyte regex
mb_http_output() - 设置/获取 HTTP 输出字符编码

阅读全文 »

多字节字符串函数 mb_http_input 检测 HTTP 输入字符编码

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

mb_http_input

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_http_input — 检测 HTTP 输入字符编码

说明

mb_http_input(string $type = ""): mixed

检测 HTTP 输入字符的编码。

参数

type: 设置的字符串指定了输入类型。 "G" 是 GET，"P" 是 POST，"C" 是 COOKIE，"S" 是 string，"L" 是 list，以及 "I" 是整个列表（将会返回 array）。如果省略了 type，它将返回最后处理的一种输入类型。

返回值

每个 type 的字符编码名称。如果 mb_http_input() 没有处理过任何指定的 HTTP 输入，它将返回 false。

参见

mb_internal_encoding() - 设置/获取内部字符编码
mb_http_output() - 设置/获取 HTTP 输出字符编码
mb_detect_order() - 设置/获取字符编码的检测顺序

阅读全文 »

多字节字符串函数 mb_http_output 设置/获取 HTTP 输出字符编码

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

mb_http_output

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_http_output — 设置/获取 HTTP 输出字符编码

说明

mb_http_output(string $encoding = mb_http_output()): mixed

设置/获取 HTTP 输出字符编码。此函数被调用之后输出的内容会被转换成 encoding。

参数

encoding

如果设置了 encoding，mb_http_output() 设置 HTTP 输出字符编码为 encoding。

如果省略了 encoding，mb_http_output() 返回当前的 HTTP 输出字符编码。

返回值

如果省略了 encoding，mb_http_output() 返回当前的 HTTP 输出字符编码。否则成功时返回 true，或者在失败时返回 false。

参见

mb_internal_encoding() - 设置/获取内部字符编码
mb_http_input() - 检测 HTTP 输入字符编码
mb_detect_order() - 设置/获取字符编码的检测顺序

阅读全文 »

多字节字符串函数 mb_internal_encoding 设置/获取内部字符编码

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

示例1

<?php 
/* 设置内部字符编码为 UTF-8 */
mb_internal_encoding("UTF-8");
/* 显示当前的内部字符编码*/
echo mb_internal_encoding();
?>

阅读全文 »

多字节字符串函数 mb_language 设置/获取当前的语言

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

mb_language

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_language — 设置/获取当前的语言

说明

mb_language(string $language = mb_language()): mixed

设置/获取当前的语言。

参数

language

用于编码邮件信息。有效的语言有："Japanese","ja","English","en" 和 "uni"（UTF-8）。 mb_send_mail() 使用了该设置来对邮件进行编码。

语言和它的设置，日文是 ISO-2022-JP/Base64，uni 是 UTF-8/Base64，英文是 ISO-8859-1/quoted。

返回值

如果设置了 language，并且 language 是有效的，它将返回 true。否则将返回 false。当省略了 language 参数，它将返回语言名称的 string。如果之前没有设置过语言，则将返回 false。

参见

mb_send_mail() - 发送编码过的邮件

阅读全文 »

多字节字符串函数 mb_list_encodings 返回所有支持编码的数组

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

示例1

<?php 
print_r(mb_list_encodings());
?>

阅读全文 »

多字节字符串函数 mb_output_handler 在输出缓冲中转换字符编码的回调函数

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

示例1

<?php 
mb_http_output("UTF-8");
ob_start("mb_output_handler");
?>

阅读全文 »

多字节字符串函数 mb_parse_str 解析 GET/POST/COOKIE 数据并设置全局变量

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

mb_parse_str

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_parse_str — 解析 GET/POST/COOKIE 数据并设置全局变量

说明

mb_parse_str(string $encoded_string, array &$result = ?): bool

解析 GET/POST/COOKIE 数据并设置全局变量。由于 PHP 不提供原始 POST/COOKIE 数据，目前它仅能够用于 GET 数据。它解析了 URL 编码过的数据，检测其编码，并转换编码为内部编码，然后设置其值为 array 的 result 或者全局变量。

参数

encoded_string: URL 编码过的数据。
result: 一个 array，包含解码过的、编码转换后的值。

返回值

成功时返回 true，或者在失败时返回 false。

参见

mb_detect_order() - 设置/获取字符编码的检测顺序
mb_internal_encoding() - 设置/获取内部字符编码

阅读全文 »

多字节字符串函数 mb_preferred_mime_name 获取 MIME 字符串

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

示例1

<?php 
$outputenc = "sjis-win";
mb_http_output($outputenc);
ob_start("mb_output_handler");
header("Content-Type: text/html;
 charset=" . mb_preferred_mime_name($outputenc));
?>

阅读全文 »

多字节字符串函数 mb_regex_encoding Set/Get character encoding for multibyte regex

发表日期：2021-07-01 08:55:53 | 来源： | 分类：多字节字符串函数

mb_regex_encoding

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

mb_regex_encoding — Set/Get character encoding for multibyte regex

说明

mb_regex_encoding(string|null $encoding = null): string|bool

Set/Get character encoding for a multibyte regex.

参数

encoding: encoding 参数为字符编码。如果省略或是 null，则使用内部字符编码。

返回值

If encoding is set, then 成功时返回 true，或者在失败时返回 false。 In this case, the internal character encoding is NOT changed. If encoding is omitted, then the current character encoding name for a multibyte regex is returned.

更新日志

版本	说明
8.0.0	现在 `encoding` 可以为 null。

参见

mb_internal_encoding() - 设置/获取内部字符编码
mb_ereg() - Regular expression match with multibyte support

阅读全文 »

多字节字符串函数 mb_regex_set_options Set/Get the default options for mbregex functions

发表日期：2021-07-01 08:55:53 | 来源： | 分类：多字节字符串函数

mb_regex_set_options

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

mb_regex_set_options — Set/Get the default options for mbregex functions

说明

mb_regex_set_options(string|null $options = null): string

Sets the default options described by options for multibyte regex functions.

参数

options

The options to set. This is a string where each character is an option. To set a mode, the mode character must be the last one set, however there can only be set one mode but multiple options.

**Regex options**
Option	Meaning
i	Ambiguity match on
x	Enables extended pattern form
m	`'.'` matches with newlines
s	`'^'` -> `'\A'`, `'$'` -> `'\Z'`
p	Same as both the `m` and `s` options
l	Finds longest matches
n	Ignores empty matches
e	eval() resulting code

**Regex syntax modes**
Mode	Meaning
j	Java (Sun java.util.regex)
u	GNU regex
g	grep
c	Emacs
r	Ruby
z	Perl
b	POSIX Basic regex
d	POSIX Extended regex

返回值

The previous options. If options is omitted or null, it returns the string that describes the current options.

更新日志

版本	说明
8.0.0	If the parameter `options` is given and not `null`, the previous options are returned. Formerly, the current options have been returned.
8.0.0	`options` is nullable now.

参见

mb_split() - 使用正则表达式分割多字节字符串
mb_ereg() - Regular expression match with multibyte support
mb_eregi() - Regular expression match ignoring case with multibyte support

阅读全文 »

多字节字符串函数 mb_scrub Description

发表日期：2021-07-01 08:55:52 | 来源： | 分类：多字节字符串函数

mb_scrub

(PHP 7 >= 7.2.0, PHP 8)

mb_scrub — Description

说明

mb_scrub(string $string, string|null $encoding = null): string

警告

本函数还未编写文档，仅有参数列表。

参数

string
encoding

返回值

更新日志

版本	说明
8.0.0	现在 `encoding` 可以为 null。

阅读全文 »

多字节字符串函数 mb_send_mail 发送编码过的邮件

发表日期：2021-07-01 08:55:53 | 来源： | 分类：多字节字符串函数

mb_send_mail

(PHP 4 >= 4.0.6, PHP 5, PHP 7, PHP 8)

mb_send_mail — 发送编码过的邮件

说明

mb_send_mail(
    string $to,
    string $subject,
    string $message,
    string $additional_headers = null,
    string $additional_parameter = null
): bool

发送邮件。邮件头和内容根据 mb_language() 设置来转换编码。这是 mail() 的一个包装器函数，所以详情参见 mail()。

参数

to

被发送到该邮件地址。可通过逗号分隔地址的 to 来指定多个收件人。该参数不会被自动编码。

subject

邮件标题。

message

邮件消息。

additional_headers(可选)

String to be inserted at the end of the email header.

This is typically used to add extra headers (From, Cc, and Bcc). Multiple extra headers should be separated with a CRLF (\r\n). Validate parameter not to be injected unwanted headers by attackers.

注意:
When sending mail, the mail must contain a From header. This can be set with the additional_headers parameter, or a default can be set in php.ini.

Failing to do this will result in an error message similar to Warning: mail(): "sendmail_from" not set in php.ini or custom "From:" header missing. The From header sets also Return-Path under Windows.

注意:
If messages are not received, try using a LF (\n) only. Some Unix mail transfer agents (most notably » qmail) replace LF by CRLF automatically (which leads to doubling CR if CRLF is used). This should be a last resort, as it does not comply with » RFC 2822.

additional_parameter

additional_parameter 是一个 MTA 命令行参数。在使用 sendmail 时对设置正确的返回路径头很有帮助。

This parameter is escaped by escapeshellcmd() internally to prevent command execution. escapeshellcmd() prevents command execution, but allows to add addtional parameters. For security reason, this parameter should be validated.

Since escapeshellcmd() is applied automatically, some characters that are allowed as email addresses by internet RFCs cannot be used. Programs that are required to use these characters mail() cannot be used.

The user that the webserver runs as should be added as a trusted user to the sendmail configuration to prevent a 'X-Warning' header from being added to the message when the envelope sender (-f) is set using this method. For sendmail users, this file is /etc/mail/trusted-users.

返回值

成功时返回 true，或者在失败时返回 false。

参见

mail() - 发送邮件
mb_encode_mimeheader() - 为 MIME 头编码字符串
mb_language() - 设置/获取当前的语言

阅读全文 »

多字节字符串函数 mb_split 使用正则表达式分割多字节字符串

发表日期：2021-07-01 08:55:53 | 来源： | 分类：多字节字符串函数

mb_split

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

mb_split — 使用正则表达式分割多字节字符串

说明

mb_split(string $pattern, string $string, int $limit = -1): array

使用正则表达式 pattern 分割多字节 string 并返回结果 array。

参数

pattern: 正则表达式。
string: 待分割的 string。
limit: 如果指定了可选参数 limit，将最多分割为 limit 个元素。

返回值

array 的结果。

注释

注意:
The character encoding specified by mb_regex_encoding() will be used as the character encoding for this function by default.

参见

mb_regex_encoding() - Set/Get character encoding for multibyte regex
mb_ereg() - Regular expression match with multibyte support

阅读全文 »

多字节字符串函数 mb_str_split Given a multibyte string, return an array of its characters

发表日期：2021-07-01 08:55:53 | 来源： | 分类：多字节字符串函数

mb_str_split

(PHP 7 >= 7.4.0, PHP 8)

mb_str_split — Given a multibyte string, return an array of its characters

说明

mb_str_split(string $string, int $length = 1, string|null $encoding = null): array

This function will return an array of strings, it is a version of str_split() with support for encodings of variable character size as well as fixed-size encodings of 1,2 or 4 byte characters. If the length parameter is specified, the string is broken down into chunks of the specified length in characters (not bytes). The encoding parameter can be optionally specified and it is good practice to do so.

参数

string

The string to split into characters or chunks.

length

If specified, each element of the returned array will be composed of multiple characters instead of a single character.

encoding

encoding 参数为字符编码。如果省略或是 null，则使用内部字符编码。

A string specifying one of the supported encodings.

返回值

mb_str_split() returns an array of strings.

更新日志

版本	说明
8.0.0	现在 `encoding` 可以为 null。
8.0.0	This function no longer returns `false` on failure.

参见

str_split() - 将字符串转换为数组

阅读全文 »