如何在 PHP 中安全检测字符串非空并避免调用未定义函数

php 中没有 javascript 风格的 `includes()` 方法,直接使用会触发“call to undefined function”致命错误;应改用 `str_contains()`(php 8.0+)或 `strpos()`/`preg_match()` 等原生函数,并始终先校验变量存在性与类型,防止空值或非字符串导致的运行时异常。

你在代码中遇到的 Fatal error: Call to undefined function includes() 错误,根本原因在于:PHP 本身不提供 .includes() 这样的方法——这是 JavaScript 的字符串方法,不能直接移植到 PHP 中。PHP 的字符串操作必须使用其原生函数,且需注意版本兼容性和输入安全性。

✅ 正确做法:分两步处理

  1. 先确保 $array[$i][$k] 存在、不为 null、且是字符串类型(防止 strpos() 或正则对非字符串报错);
  2. 再执行条件匹配逻辑,推荐使用语义清晰、性能良好、且支持否定前瞻的正则表达式(如原答案所示),或更现代的 str_contains()(PHP ≥ 8.0)。

✅ 推荐方案(兼容 PHP 7.4+,安全可靠)

// 安全检查:确保索引存在、值非空且为字符串
if (isset($array[$i][$k]) && is_string($array[$i][$k]) && $array[$i][$k] !== '') {
    // 使用 preg_match 实现精确逻辑:
    // 匹配 "SA" 但不匹配 "SAP"(即 SA 后不紧跟 P),或匹配 "Schulaufgabe" 或 "Unterrichtsende"
    if (preg_match('/SA(?!P)|Schulaufgabe|Unterrichtsende/', $array[$i][$k])) {
        echo "" . htmlspecialchars($array[$i][$k]) . '';
    } else {
        echo '' . htmlspecialchars($array[$i][$k]) . '';
    }
} else {
    // 处理空值/缺失项(如输出空单元格或默认占位符)
    echo ' ';
}
? 正则说明:SA(?!P) 是「负向先行断言」,表示匹配 "SA" 且其后不是 "P",从而准确排除 "SAP",同时保留 "SA" 单独出现(如 "SA1"、"SA-Test")的场景。

✅ 替代方案(PHP 8.0+,更易读)

if (isset($array[$i][$k]) && is_string($array[$i][$k]) && $array[$i][$k] !== '') {
    $str = $array[$i][$k];
    $hasSA = str_contains($str, 'SA') && !str_contains($str, 'SAP');
    $hasOther = str_contains($str, 'Schulaufgabe') || str_contains($str, 'Unterrichtsende');

    if ($hasSA || $hasOther) {
        echo "" . htmlspecialchars($str) . '';
    } else {
        echo '' . htmlspecialchars($str) . '';
    }
}

⚠️ 关键注意事项

  • ❌ 不要使用 strlen($array[$i][$k]) != 0 单独判断:若 $array[$i][$k] 为 null、false 或未定义,strlen() 会返回 0(PHP 会静默转换),造成逻辑误判;
  • ✅ 始终优先使用 isset() + is_string() + !== '' 三重校验,或直接用 !empty($array[$i][$k])(注意:empty() 会将 "0" 视为 true,慎用于含数字内容的场景);
  • ✅ 输出 HTML 前务必使用 htmlspecialchars() 防止 XSS;
  • ✅ 避免在条件中混用 && 和 || 而不加括号——原问题中逻辑有歧义(A && B || C || D ≠ A && (B || C || D)),易引发意外匹配。

✅ 总结

解决该问题的核心不是“找一个能替代 .includes() 的函数”,而是:
认清语言差异(PHP ≠ JS),拒绝照搬语法;
坚持防御性编程:检查变量存在性、类型和内容有效性;
选择语义准确的工具:正则适用于复杂模式(如排除 SAP),str_contains() 更适合简单子串判断;
保持输出安全:任何用户可控数据输出前必须转义。

这样,你不仅能彻底消除 undefined function 错误,还能构建出健壮、可维护、安全的 PHP 字符串处理逻辑。