讲师中心 微信公众号
AI工具推荐 视频效率加速

WordPress REST API 正则验证失效的根源与正确写法

云婷君_4364

云婷君_4364

发布时间:2026-07-15 14:47:03

|

463人浏览过

|

来源于php中文网

原创

WordPress REST API 正则验证失效的根源与正确写法

WordPress REST API 的 pattern 参数要求提供不带分隔符的原生正则表达式,若误加 / 等定界符会导致匹配失败;核心原因是内部函数自动添加 # 作为分隔符并启用 Unicode 模式(#u),双重定界引发语法错误。

wordpress rest api 的 `pattern` 参数要求提供不带分隔符的原生正则表达式,若误加 `/` 等定界符会导致匹配失败;核心原因是内部函数自动添加 `#` 作为分隔符并启用 unicode 模式(`#u`),双重定界引发语法错误。

在 WordPress REST API 中为请求参数配置正则校验时,开发者常因沿用 PHP 原生 preg_match() 的书写习惯,在 pattern 字段中错误地包含正则分隔符(如 /^[A-Za-z0-9 ]+$/),从而导致验证始终失败,并返回 rest_invalid_pattern 错误。

根本原因在于 WordPress 内部使用了 rest_validate_json_schema_pattern() 函数进行校验:

function rest_validate_json_schema_pattern( $pattern, $value ) {
    $escaped_pattern = str_replace( '#', '\#', $pattern );
    return 1 === preg_match( '#' . $escaped_pattern . '#u', $value );
}

该函数会:

  • 自动以 # 作为正则分隔符(而非 /);
  • 在模式前后添加 #,并追加 u 修饰符(支持 UTF-8 Unicode 字符);
  • 对 # 字符做转义,避免冲突。

因此,当你传入 ' /^[A-Za-z0-9 ]+$/ ',实际执行的是:

preg_match('#/^[A-Za-z0-9 ]+$/#u', $value)

这构成非法正则语法(开头的 / 被当作字面量,而非分隔符),必然返回 false。

论文常用的tex格式转换为word格式,核心是能转换数学公式(非图片),表格,图表等等
论文常用的tex格式转换为word格式,核心是能转换数学公式(非图片),表格,图表等等

将 LaTeX(.tex)学术论文转换为 Word(.docx),支持可编辑的 OMML 公式、原生 Word 表格、嵌入图形、IEEE 双栏排版及参考文献

下载

✅ 正确写法:省略所有分隔符,仅提供纯模式字符串

register_rest_route( $this->namespace, '/posts', [
    'methods'             => 'POST',
    'permission_callback' => '__return_true',
    'callback'            => 'create_post',
    'args'                => [
        'title' => [
            'type'        => 'string',
            'description' => 'The post's title',
            'required'    => true,
            'pattern'     => '^[A-Za-z0-9 ]+$', // ✅ 无 /、# 等分隔符
        ],
    ],
]);

? 验证示例(与 PHP 一致):

// 正确匹配(等效于 WordPress 内部执行)
var_dump( preg_match( '#^[A-Za-z0-9 ]+$#u', 'Test Title' ) ); // int(1)
var_dump( preg_match( '#^[A-Za-z0-9 ]+$#u', '&Invalid!' ) );   // int(0)

⚠️ 注意事项:

  • 不要使用 /、# 或其他符号包裹正则,否则将被重复解析;
  • u 修饰符已默认启用,需确保模式兼容 UTF-8(例如中文字符需显式写入,如 [p{L}p{N} ]+);
  • 特殊字符如 # 若需匹配,必须手动转义:pattern => 'My#Title';
  • 空字符串 '' 默认通过(除非配合 minLength 限制);
  • 建议配合 sanitize_callback 进行二次清理,增强健壮性。

总结:WordPress REST API 的 pattern 是 JSON Schema 规范的实现,遵循 JSON Schema Validation 标准——它只接受 ECMAScript 风格的正则字符串(无分隔符、无修饰符),由底层适配为 PCRE 兼容格式。理解这一设计边界,是写出可靠 API 参数校验的关键。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

10104

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

5981

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2075

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

3748

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

4454

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

3491

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4977

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

3902

2023.11.13

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

100

2026.09.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何在 Windows 11 上安装 XAMPP
如何在 Windows 11 上安装 XAMPP

共1课时 | 205人学习

第二十三期_前端开发
第二十三期_前端开发

共98课时 | 11.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn