在 WordPress 中如何查找数组元素？从 PHP 的 array_find 到 wpjam_find
内容提要
PHP 8.4 新增 array_find 和 array_find_key，可短路查找数组首个满足条件的值或键，但不支持数字索引、关联条件查找和映射后查找。WPJAM Basic 提供 wpjam_find 弥补这些不足，支持 value、key、index、result 四种输出模式，可传关联数组作为条件或闭包做映射，并以 null 作为跳过信号，避免 0、空字符串、false 等合法值被误判。
延伸解读
原生 array_find 的局限与 wpjam_find 的补位
PHP 8.4 的 array_find 和 array_find_key 解决了短路查找首个匹配值或键的问题，但文章指出它们仍有三处不便：获取数字索引需额外转换、不支持关联数组条件、无法边映射边查找。wpjam_find 并非取代原生函数，而是针对这些复合场景提供统一封装，通过参数类型自动推断意图，减少手写闭包和循环的噪音。
四种输出模式与严格索引查找
wpjam_find 支持 value、key、index、result 四种输出模式。前两者直接转发原生函数；index 模式内部使用 array_search 严格比较，避免 0 和 '0' 混淆，找不到时安全返回 null；result 模式是原生没有的能力，将闭包作为映射器，返回第一个非 null 的映射结果。这种设计让同一函数覆盖多种查找需求。
null 作为跳过信号：避免合法值被误判
在 result 映射模式下，wpjam_find 约定只有返回 null 才表示跳过，0、空字符串、false 等均视为命中。这解决了业务中这些值常为合法结果却被真值判断忽略的问题。若确实想跳过空值，可在闭包中显式使用 ?: null 转换。这一约定有助于减少类型和逻辑错误。
适用场景与选择建议
文章建议简单查找直接用 PHP 8.4 原生 array_find 和 array_find_key；遇到关联条件查找、映射后查找或需要安全获取数字索引时，再使用 wpjam_find。它通过关联数组条件省去手写 wpjam_matches，通过闭包映射补足原生缺失的能力，适合替代大量“遍历+判断+取值”的冗余代码。
Q&A
PHP 8.4 新增的 array_find 和 array_find_key 函数有什么作用？
array_find 用于查找数组中第一个满足条件的值，array_find_key 用于查找第一个满足条件的键。它们都支持短路（命中即停），性能优于 array_filter。
原生 array_find 和 array_find_key 有哪些不足？
原生函数有三个不足：1. 想获取数字索引需要额外步骤；2. 只支持回调，不支持关联数组条件查找；3. 不支持边映射边查找。
wpjam_find 函数是什么？它和原生 array_find 有什么区别？
wpjam_find 是 WPJAM Basic 提供的增强函数，用于弥补原生 array_find 的不足。它支持四种输出模式（value、key、index、result），可以传关联数组作为条件或闭包做映射，并以 null 作为跳过信号，避免 0、空字符串、false 等合法值被误判。
wpjam_find 的四种输出模式分别是什么？
四种模式：value 返回元素值（原生 array_find 转发）；key 返回数组键（原生 array_find_key 转发）；index 返回数字索引（自动严格比较，防止 0 和 '0' 混淆）；result 返回映射后的结果（闭包默认模式，原生没有）。
wpjam_find 中 result 模式（映射查找）的规则是什么？
在 result 模式下，闭包作为映射函数，对每个元素进行转换。只有返回 null 才表示跳过，继续找下一个；返回任何非 null 值（包括 0、空字符串、false、空数组）都视为命中，立即返回该值。
如何使用 wpjam_find 按关联数组条件查找元素？
直接将关联数组作为第二个参数传入即可，例如 wpjam_find($posts, ['status'=>'publish', 'type'=>'post'])，函数内部会自动使用 wpjam_matches 进行匹配，省去手写闭包的麻烦。
wpjam_find 如何安全地获取数字索引？
指定第三个参数为 'index'，例如 wpjam_find($arr, $cb, 'index')。函数内部会使用 array_search(..., true) 进行严格比较，避免类型混淆，找不到时返回 null。
在 wpjam_find 中，如果想把空值当作未命中跳过，应该怎么做？
可以在闭包映射表达式后面加 ?: null，例如 $url ?: null，显式地将空值转换为 null，这样就会被视为跳过。
