预定义常量

下列常量由此扩展定义，且仅在此扩展编译入 PHP 或在运行时动态载入时可用。

**PREG 常量**
常量	描述	自哪个版本起
`PREG_PATTERN_ORDER`	结果按照"规则"排序，仅用于 preg_match_all()，即 `$matches[0]` 是完整规则的匹配结果， `$matches[1]` 是第一个子组匹配的结果，等等。	since
`PREG_SET_ORDER`	结果按照"集合"排序，仅用于preg_match_all()，即 `$matches[0]` 保存第一次匹配结果的所有结果(包含子组)信息, `$matches[1]` 保存第二次的结果信息，等等。
`PREG_OFFSET_CAPTURE`	查看 `PREG_SPLIT_OFFSET_CAPTURE` 的描述。	4.3.0
`PREG_SPLIT_NO_EMPTY`	这个标记告诉 preg_split() 仅返回非空部分。
`PREG_SPLIT_DELIM_CAPTURE`	这个标记告诉 preg_split() 同时捕获括号表达式匹配到的内容。	4.0.5
`PREG_SPLIT_OFFSET_CAPTURE`	如果设置了这个标记，每次出现的匹配子串的偏移量也会被返回。注意，这会改变返回数组中的值，每个元素都是由匹配子串作为第 0 个元素，它相对目标字符串的偏移量作为第 1 个元素的数组。这个标记只能用于 preg_split()。	4.3.0
`PREG_UNMATCHED_AS_NULL`	This flag tells preg_match() and preg_match_all() to include unmatched subpatterns in `$matches` as `null` values. Without this flag, unmatched subpatterns are reported as empty strings, as if they were empty matches. Setting this flag allows to distinguish between these two cases.	7.2.0
`PREG_NO_ERROR`	没有匹配错误时调用 preg_last_error() 返回。	5.2.0
`PREG_INTERNAL_ERROR`	如果有 PCRE 内部错误时调用 preg_last_error() 返回。	5.2.0
`PREG_BACKTRACK_LIMIT_ERROR`	如果调用回溯限制超出，调用preg_last_error()时返回。	5.2.0
`PREG_RECURSION_LIMIT_ERROR`	如果递归限制超出，调用preg_last_error()时返回。	5.2.0
`PREG_BAD_UTF8_ERROR`	如果最后一个错误时由于异常的utf-8数据(仅在运行在 UTF-8 模式正则表达式下可用)。导致的，调用preg_last_error()返回。	5.2.0
`PREG_BAD_UTF8_OFFSET_ERROR`	如果偏移量与合法的 UTF-8 代码不匹配(仅在运行在 UTF-8 模式正则表达式下可用)。调用 preg_last_error() 返回。	5.3.0
`PREG_JIT_STACKLIMIT_ERROR`	当 PCRE 函数因 JIT 栈空间限制而失败，preg_last_error() 就会返回此常量。	7.0.0
`PCRE_VERSION`	PCRE版本号和发布日期(比如： "`7.0 18-Dec-2006`")。	5.2.4

User Contributed Notes

Robert 23-Dec-2015 10:41


The new PREG_JIT_STACKLIMIT_ERROR constant introduced with PHP 7.0.0 has got a value of 6.



I experienced this error code when parsing a 112KB file. preg_match_all failed with this error. Interesting was: The matches array contained some entries, but not all as the command failed (I missed to check the return value).



Unfortunately you can not configure the stack-size of the PCRE JIT. The only way out was - at least for me - to disable the PCRE JIT via php.ini (pcre.jit=0).

erutan409 at hotmail dot com 31-Jul-2015 01:24


PREG_PATTERN_ORDER: 1

PREG_SET_ORDER: 2

PREG_OFFSET_CAPTURE: 256

PREG_SPLIT_NO_EMPTY: 1

PREG_SPLIT_DELIM_CAPTURE: 2

PREG_SPLIT_OFFSET_CAPTURE: 4

PREG_NO_ERROR: 0

PREG_INTERNAL_ERROR: 1

PREG_BACKTRACK_LIMIT_ERROR: 2

PREG_RECURSION_LIMIT_ERROR: 3

PREG_BAD_UTF8_ERROR: 4

PREG_BAD_UTF8_OFFSET_ERROR: 5

PCRE_VERSION: %YOUR_VERSION_NUMBER%