PHP写接口怎么实现简单的数据校验

梦杰小哥_4108

梦杰小哥_4108

2026-09-30

647人浏览

原创

filter_var() 最省事且可靠:它内置、免扩展,比 empty()/isset() 避免 "0" 等误判,比手写正则更准;邮箱用 filter_validate_email,url 加 filter_flag_scheme_required,整数用 filter_validate_int 配范围;批量校验用 filter_input_array(),json 接口需先读 php://input 再 json_decode() 并检查错误。

php写接口怎么实现简单的数据校验

PHP接口里用filter_var()做基础字段校验最省事

大多数简单接口(比如用户注册、表单提交)不需要上框架验证器,filter_var() 就够用,它内置在 PHP 里,不用装扩展,也不依赖外部库。

常见错误是直接用 empty() 或 isset() 判空,但它们对 "0"、"false" 这类字符串会误判;或者用正则硬写邮箱/URL 格式,容易漏边界 case。

实操建议:

  • 手机号用 filter_var($phone, FILTER_SANITIZE_NUMBER_INT) 清洗后再判断长度,比正则更稳
  • 邮箱必须用 FILTER_VALIDATE_EMAIL,别自己写 /^.+@.+\..+$/ —— 它不校验 @ 后有没有合法域名
  • URL 用 FILTER_VALIDATE_URL,注意它默认不校验 http:// 前缀,要加 FILTER_FLAG_SCHEME_REQUIRED
  • 整数用 filter_var($id, FILTER_VALIDATE_INT, ['options' => ['min_range' => 1]]),比 is_numeric() 更准(后者接受 "1e3")

POST数据进来的数组怎么批量校验

手写一堆 filter_var() 很累,PHP 有 filter_input_array() 直接处理整个 $_POST 或 $_GET。

容易踩的坑:它默认只读取 INPUT_POST,但不会自动过滤 $_FILES 或 $_COOKIE;另外如果某个字段没传,返回 false 而不是 null,得用 === false 严格判断。

示例场景:接收一个带 title(非空字符串)、price(正浮点)、category_id(大于 0 的整数)的 JSON 接口请求:

$rules = [
    'title' => ['filter' => FILTER_SANITIZE_STRING, 'flags' => FILTER_FLAG_NO_ENCODE_QUOTES],
    'price' => ['filter' => FILTER_VALIDATE_FLOAT, 'options' => ['min_range' => 0.01]],
    'category_id' => ['filter' => FILTER_VALIDATE_INT, 'options' => ['min_range' => 1]]
];
$data = filter_input_array(INPUT_POST, $rules);
if ($data === false || $data['title'] === null || $data['price'] === false || $data['category_id'] === false) {
    http_response_code(400);
    echo json_encode(['error' => '参数校验失败']);
    exit;
}

为什么filter_var()不适合复杂业务规则

它只管格式,不管语义。比如“用户名不能为 admin”、“密码需包含大小写字母和数字”、“两个日期字段谁必须早于谁”,这些都得自己写逻辑。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

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

下载

这时候硬塞进 filter_var() 的 callback 模式反而难维护,不如拆成独立函数:

  • 先用 filter_var() 做基础清洗和格式兜底(防 XSS、类型错乱)
  • 再用 if/else 或 switch 显式检查业务约束,错误信息也更容易定位
  • 别把校验逻辑藏在模型 save() 里——接口层就该明确告诉调用方哪条规则没过

性能上没区别,但可读性和调试成本差很多。

JSON接口要注意php://input和$_POST的区别

前端发 Content-Type: application/json 时,数据不在 $_POST 里,得手动读 php://input 并 json_decode()。

常见错误是直接对 $_POST 调用 filter_input_array(),结果永远拿不到数据;或者没设 json_decode($raw, true) 的第二个参数,导致后面用 $data['key'] 报错。

实操要点:

  • 先 $raw = file_get_contents('php://input');,再 $data = json_decode($raw, true);
  • 校验前务必检查 json_last_error() === JSON_ERROR_NONE,否则前端传了个 {name:"张三",age:} 这种半截 JSON,$data 就是 null
  • 之后再用 filter_var() 处理每个字段,别跳过这步——json_decode 不做任何过滤

真正麻烦的从来不是“怎么校验”,而是“校验失败后怎么让前端快速知道是哪个字段、哪条规则挂了”。字段名拼错、类型传错、必填项漏传……这些细节比技术选型重要得多。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php从入门到精通 php

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.09.01

9564

6

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

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

2023.10.11

5741

5

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

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

2023.10.11

2055

5

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

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

2023.10.23

3588

4

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

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

2023.10.23

4274

6

html怎么上传
html怎么上传

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

2023.11.03

3351

9

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

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

2023.11.09

4757

8

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

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

2023.11.13

3722

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11722

4

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
《20天入门精通PHP》视频教程
《20天入门精通PHP》视频教程

共200课时 | 48万人学习

墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习