PHP 正则表达式校验字符串中 key:value 键值对格式的合法性-php教程-PHP中文网

PHP 正则表达式校验字符串中 key:value 键值对格式的合法性

本文介绍如何使用 PHP 的 preg_match() 和精心设计的正则表达式，严格校验字符串中是否合法包含指定关键词（如 key1、key2）组成的 key:value 结构：关键词后必须紧接冒号（无空格），冒号后必须有非空白内容；非关键词后出现冒号或关键词后无有效值均视为非法。

本文介绍如何使用 php 的 `preg_match()` 和精心设计的正则表达式，严格校验字符串中是否合法包含指定关键词（如 key1、key2）组成的 `key:value` 结构：关键词后必须紧接冒号（无空格），冒号后必须有非空白内容；非关键词后出现冒号或关键词后无有效值均视为非法。

要实现题述的复杂校验逻辑——即仅当出现白名单关键词时，才强制要求其后必须为 : + 非空内容，且冒号前必须是完整关键词（由单词边界保证），其余任意字符（不含冒号和空格）均可自由存在——传统“查找错误模式”的思路易遗漏边界情况。更稳健的方式是采用 “全字符串匹配 + 主动拒绝”策略：用正则从头到尾尝试匹配整个字符串，一旦遇到违反规则的片段（如 key1 后无冒号、key2: 后为空、abc: 中 abc 不在白名单），立即失败。

以下是推荐的正则表达式及其实现：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

$pattern = '/^(?: ?(?:\b(?:key1|key2)(?:: *\S+|(*SKIP)(*FAIL))|[^: ]+))*$/';
$result = preg_match($pattern, $string) ? 'valid' : 'invalid';

✅ 表达式核心解析：

^...$：强制锚定字符串首尾，确保完全匹配，不接受子串合规即通过；
(?: ... )*：外层非捕获组，允许零次或多次重复匹配“合法片段”；
?：可选空格（处理多个键值对间可能存在的单个空格分隔）；
\b(?:key1|key2)：单词边界 + 白名单关键词，杜绝 mykey1: 或 key123: 等误匹配；
(?:: *\S+|(*SKIP)(*FAIL))：条件分支：
- : *\S+：匹配 : + 任意空格 + 至少一个非空白字符（满足“冒号后非空”）；
- |(*SKIP)(*FAIL)：若上一分支不匹配（如 key1 后无冒号，或 key2: 后为空），立即回溯失败，不尝试其他路径；
|[^: ]+：非关键词、非冒号、非空格的普通文本（如 asds asd），只要不含 : 就安全放行。

⚠️ 注意事项：

白名单扩展：在 (?:key1|key2) 中追加 |key3|key4 即可支持更多关键词；
空格敏感性：key1: value 合法（冒号后空格被 * 消耗，value 由 \S+ 匹配），但 key1 :value 非法（关键词与冒号间有空格，\b 后无法匹配）；
性能提示：该模式使用 (*SKIP)(*FAIL) 实现原子性拒绝，避免回溯灾难，在长字符串中依然高效；
替代方案：亦可用 \G 连续匹配或 preg_replace_callback 分步验证，但本模式更简洁、单次调用即可判定。

✅ 示例验证：

字符串	结果	原因
`"hello world"`	`valid`	无关键词，全程匹配 `[^: ]+`
`"text key1:value"`	`valid`	`key1:value` 符合 `: *\S+` 分支
`"key2: hello"`	`valid`	冒号后空格 + `hello` 满足 `\S+`
`"key1"`	`invalid`	`key1` 后无冒号，触发 `(SKIP)(FAIL)`
`"key2:"`	`invalid`	冒号后无非空白字符，同样触发失败
`"abc:value"`	`invalid`	`abc` 不在白名单，`\b(?:key1\\|key2)` 不匹配，且含 `:`，无法进入 `[^: ]+` 分支