PHP str_contains 与空字符串判断：批量导入字段校验的边界

批量导入 CSV 时，最难排查的往往不是分隔符，而是“备注为空”这类看似简单的判断：一旦把空字符串直接交给 str_contains，任何非空文本都会被判定为包含它。更稳妥的做法是先用 trim 归一化字段，再把“缺失”和“包含标记”拆成两个判断。

str_contains($haystack, '') 会返回 true，所以空搜索串不能代表“字段存在”；批量导入应先判断字段是否为空，再判断是否包含目标文本。

一条导入记录为什么被误判

假设订单导入要求备注里出现“已核对”才进入人工复核。第一版代码通常长这样：

$remark = trim($row['remark'] ?? '');
$needsReview = str_contains($remark, $marker);

如果 $marker 来自可配置字段，管理员暂时留空，str_contains 的第二个参数就是空字符串。此时它对任意 $remark 都返回 true，结果是整批记录都进入复核队列。这里先别急着改成 empty($remark)，因为“备注为空”和“备注包含标记”不是同一件事。

把缺失判断和包含判断分开

更容易验收的写法，是先得到两个状态：字段是否缺失、字段是否包含目标标记。下面的节点只对应这条真实路径：trim 负责归一化，str_contains 负责查找，empty 只作为兼容旧代码时的对照。

$remark = trim((string) ($row['remark'] ?? ''));
$marker = trim((string) ($config['review_marker'] ?? ''));

$missingRemark = ($remark === '');
$hasMarker = ($marker !== '') && str_contains($remark, $marker);

if ($missingRemark) {
    $errors[] = '备注不能为空';
} elseif ($hasMarker) {
    $reviewQueue[] = $row['order_no'];
}

成功状态也很具体：空备注只产生“备注不能为空”，空标记不会让所有订单进入队列；只有标记非空且确实出现在备注里，订单号才会进入 $reviewQueue。

为什么不建议用 empty 代替全部判断

empty 适合表达“这个值在业务上没有可用内容”，但它的范围比空字符串更宽。字符串 "0"、整数 0、false、null 和空数组都会触发 empty。订单号、邮编、状态码等字段可能合法地使用 "0"，这时直接写 empty($value) 会把有效数据当成缺失。

如果需求就是判断用户是否提交了非空文本，用 trim($value) === '' 更直白；如果需求是查找子串，先确认搜索串非空，再调用 str_contains。两者组合起来，代码读者能直接看出规则，而不是猜 empty 的隐含类型表。

PHP 8.0 之前的回退写法

str_contains 从 PHP 8.0 开始提供。旧项目若不能升级，可以保留同一条判断顺序，用 strpos 并严格比较返回值：

$hasMarker = ($marker !== '') && strpos($remark, $marker) !== false;

不能写成 if (strpos($remark, $marker))，因为标记位于字符串开头时返回整数 0，会被当作假值。无论使用哪个函数，空搜索串的前置判断都要保留。

上线前用四条样例验收

• remark = ''、marker = '已核对'：报备注缺失，不入队。
• remark = ' 已核对 '、marker = '已核对'：归一化后入队。
• remark = '客户已确认'、marker = ''：不入队，不得全量命中。
• remark = '编号 0'：不要因为某段旧代码使用 empty 就判定整字段缺失。

这四组样例覆盖了最容易混淆的空值、首尾空白、空搜索串和零值边界。上线后如果规则继续扩展，再把“缺失”“包含”“格式不合法”拆成独立错误，批量导入的失败记录会更容易定位。

相关问题

str_contains 区分大小写吗？

区分。需要不区分大小写时，应先明确字符集和大小写转换策略，再选择适合的函数，不要把转换悄悄混进缺失判断。

空格应该算空字段吗？

导入文本字段通常应先 trim 再判断；如果空格本身有业务意义，则应在字段协议里明确保留它。

strpos 返回 0 为什么要用 !== false？

返回 0 表示匹配从首字符开始，不表示没有匹配。只有严格比较 false，才能保留这个结果。

小结

这类问题的根因不是函数失效，而是把“空搜索串”和“字段为空”当成了同一个状态。先 trim，再用 === '' 判断缺失，最后在标记非空时调用 str_contains，批量导入的分支就能按业务含义验收。