在数组中搜索给定的值，如果成功则返回首个相应的键名？

Posted 2023-05-08

在数组中搜索给定的值，如果成功则返回首个相应的键名

array_search
(php 4 >= 4.0.5, PHP 5, PHP 7)
array_search — 在数组中搜索给定的值，如果成功则返回首个相应的键名
说明
array_search ( mixed $needle , array $haystack [, bool $strict = false ] ) : mixed
大海捞针，在大海（haystack）中搜索针（ needle 参数）。
参数
needle
搜索的值。
注意:
如果 needle 是字符串，则比较以区分大小写的方式进行。
haystack
这个数组。
strict
如果可选的第三个参数 strict 为 true，则 array_search() 将在 haystack 中检查完全相同的元素。 这意味着同样严格比较 haystack 里 needle 的 类型，并且对象需是同一个实例。
返回值
如果找到了 needle 则返回它的键，否则返回 false。
如果 needle 在 haystack 中出现不止一次，则返回第一个匹配的键。要返回所有匹配值的键，应该用 array_keys() 加上可选参数 search_value 来代替。
警告
此函数可能返回布尔值 false，但也可能返回等同于 false 的非布尔值。请阅读 布尔类型章节以获取更多信息。应使用 === 运算符来测试此函数的返回值。
更新日志
版本 说明
5.3.0 As with all internal PHP functions as of 5.3.0, array_search() returns null if invalid parameters are passed to it. 参考技术A 巧用 PHP 数组函数

程序猿的生活1
09-10
0x00 前言

PHP 的数组是一种很强大的数据类型，与此同时 PHP 内置了一系列与数组相关的函数可以很轻易的实现日常开发的功能。但是我发现好像很多小伙伴都忽略了内置函数的作用（比如我自己就编写过一些有关数组操作的代码然后发现PHP自带了/(ㄒoㄒ)/~~），善用 PHP 内置函数能极大的提高开发效率和运行效率（内置函数都是用 C 写的效率比用 PHP 写的高很多），所以本文便总结了一些在常见场景中利用 PHP 内置函数的实现方法。此外如果想更深入的学习有关 PHP 数组函数最好还是去查 PHP 手册！点我看官方数组函数手册

10年架构师领你架构-成长之路-

0x01 取指定键名

对于某些关联数组，有时候我们只想取指定键名的那部分，比如数组为 ['id' => 1, 'name' => 'zane', 'password' => '123456'] 此时若只想取包含 id 和 name 的部分该怎么实现呢？下面直接贴代码。

<?php$raw = ['id' => 1, 'name' => 'zane', 'password' => '123456'];// 自己用 PHP 实现function onlyKeys($raw, $keys) $new = []; foreach ($raw as $key => $val) if (in_array($key, $keys)) $new[$key] = $val; return $new;// 用 PHP 内置函数实现function newOnlyKeys($array, $keys) return array_intersect_key($array, array_flip($keys));var_dump(onlyKeys($raw, ['id', 'name']));// 结果 ['id' => 1, 'name' => 'zane']var_dump(newOnlyKeys($raw, ['id', 'name']));// 结果 ['id' => 1, 'name' => 'zane']
很明显简洁很多有木有！不过 array_intersect_key 和 array_flip 是什么鬼？这里简单的介绍一下这两个函数的作用，首先是 array_flip 函数，这个函数的功能是「将数组的键和值对调」，也就是键名变成值，值变成键名。我们传递的 $keys 参数经过这个函数便从 [0 => 'id', 1 => 'name'] 转变为了 ['id' => 0, 'name' => 1]。这样做的目的是为了向 array_intersect_key 函数服务，array_intersect_key 函数的功能是「使用键名比较计算数组的交集」，也就是返回第一个参数数组中与其他参数数组相同键名的值。这样便实现了取指定键名的功能 ~(≧▽≦)/~啦！当然要详细了解这两个函数的功能还是要查 PHP 官方手册：array_flip array_intersect_key

0x02 移除指定键名

有了上一个例子做铺垫，这个就简单讲讲啦，道理是大同小异滴。

<?php$raw = ['id' => 1, 'name' => 'zane', 'password' => '123456'];// 用 PHP 内置函数实现function removeKeys($array, $keys) return array_diff_key($array, array_flip($keys));// 移除 id 键var_dump(removeKeys($raw, ['id', 'password']));// 结果 ['name' => 'zane']
和上一个例子相比本例只是将 array_intersect_key 函数改为 array_diff_key，嗯……相信大家能猜出来这个函数的功能「使用键名比较计算数组的差集」，刚好和 array_intersect_key 的功能相反而已。官方手册：array_diff_key 0x03 数组去重

这个相信大家都有这个需求，当然 PHP 也内置了array_unique函数供给大家使用，如下例：

<?php$input = ['you are' => 666, 'i am' => 233, 'he is' => 233, 'she is' => 666];$result = array_unique($input);var_dump($result);// 结果 ['you are' => 666, 'i am' => 233]
嘿，用这个函数就能解决大部分问题了，但是有时候你可能会觉得它不够快，原因如下： array_unique() 先将值作为字符串排序，然后对每个值只保留第一个遇到的键名，接着忽略所有后面的键名。 因为这个函数会先将数组进行排序，所以速度可能在某些场景达不到预期的要求。 现在我们可以祭出我们的黑科技 array_flip 函数，众所周知 PHP 里数组的键名是唯一的，所以在键名和值对调后重复的值便被忽略了。试想一下我们连续调用两次 array_flip 函数是不是就相当于实现了 array_unique 函数的功能呢？示例代码如下：

<?php$input = ['you are' => 666, 'i am' => 233, 'he is' => 233, 'she is' => 666];$result = array_flip(array_flip($input));var_dump($result);// 结果 ['she is' => 666, 'he is' => 233]
嗯哼？！结果和 array_unique 的不一样！为什么，我们可以从 PHP 官方手册得到答案： 如果同一个值出现多次，则最后一个键名将作为它的值，其它键会被丢弃。 总的来说就是 array_unique 保留第一个出现的键名，array_flip 保留最后一个出现的键名。

注意：使用 array_flip 作为数组去重时数组的值必须能够作为键名（即为 string 类型或 integer 类型），否则这个值将被忽略。 此外，若不需要保留键名我们可以直接这样使用 array_values(array_flip($input))。 0x04 重置索引 当我们想要对一个索引并不连续的数组进行重置时，比如数组：[0 => 233, 99 => 666]，对于这种数组我们只需要调用 array_values 函数即可实现。如下例：

<?php$input = [0 => 233, 99 => 666];var_dump(array_values($input));// 结果 [0 => 233, 1 => 66]
需要注意的是array_values函数并不止重置数字索引还会将字符串键名也同样删除并重置。那如何在保留字符串键名的同时重置数字索引呢？答案就是array_slice函数，代码示例如下：

<?php$input = ['hello' => 'world', 0 => 233, 99 => 666];var_dump(array_slice($input, 0));// 结果 ['hello' => 'world', 0 => 233, 1 => 66]
array_slice函数的功能是取出数组的中的一段，但它默认会重新排序并重置数组的数字索引，所以可以利用它重置数组中的数字索引。

0x05 清除空值

嘿，有时候我们想清除某个数组中的空值比如：null、false、0、0.0、[]空数组、''空字符串、'0'字符串0 ，这时 array_filter 函数便能帮上大忙。代码如下：

<?php$input = ['foo', false, -1, null, '', []];var_dump(array_filter($input));// 结果 [0 => 'foo', 2 => -1]
为什么会出现这样的结果捏？array_filter 的作用其实是「用回调函数过滤数组中的单元」，它的第二个参数其实是个回调函数，向数组的每个成员都执行这个回调函数，若回调函数的返回值为 true 便保留这个成员，为 false 则忽略。这个函数还有一个特性就是： 如果没有提供 callback 函数， 将删除 array 中所有等值为 FALSE 的条目。 等值为 false 就是转换为 bool 类型后值为 false 的意思，详细看文档：转换为布尔类型。

注意：如果不填写 callback 函数，0、0.0、'0'字符串0 这些可能有意义的值会被删除。所以如果清除的规则有所不同还需要自行编写 callback 函数。

0x06 确认数组成员全部为真 有时候我们希望确认数组中的的值全部为 true，比如：['read' => true, 'write' => true, 'execute' => true]，这时我们需要用一个循环判定吗？NO，NO，NO……只需要用 array_product 函数便可以实现了。代码如下：

<?php$power = ['read' => true, 'write' => true, 'execute' => true];var_dump((bool)array_product($power));// 结果 true$power = ['read' => true, 'write' => true, 'execute' => false];var_dump((bool)array_product($power));// 结果 false
为什么能实现这个功能呢？ array_product 函数本来的功能是「计算数组中所有值的乘积」，在累乘数组中所有成员的时候会将成员的值转为数值类型。当传递的参数为一个 bool 成员所组成的数组时，众所周知 true 会被转为 1，false 会被转为 0。然后只要数组中出现一个 false 累乘的结果自然会变成 0，然后我们再将结果转为 bool 类型不就是 false 了嘛！

注意：使用 array_product 函数将在计算过程中将数组成员转为数值类型进行计算，所以请确保你了解数组成员转为数值类型后的值，否则会产生意料之外的结果。比如：

<?php$power = ['read' => true, 'write' => true, 'execute' => 'true'];var_dump((bool)array_product($power));// 结果 false
上例是因为'true'在计算过程中被转为 0。要想详细了解请点击这里。

0x07 获取指定键名之前 / 之后的数组

如果我们只想要关联数组中指定键名值之前的部分该怎么办呢？又用一个循环？当然不用我们可以通过 array_keys、array_search 和 array_slice 组合使用便能够实现！下面贴代码：

<?php$data = ['first' => 1, 'second' => 2, 'third' => 3];function beforeKey($array, $key) $keys = array_keys($array); // $keys = [0 => 'first', 1 => 'second', 2 => 'third'] $len = array_search($key, $keys); return array_slice($array, 0, $len);var_dump(beforeKey($data, 'first'));// 结果 []var_dump(beforeKey($data, 'second'));// 结果 ['first' => 1]var_dump(beforeKey($data, 'third'));// 结果 ['first' => 1, 'second' => 2]
思路解析，要实现这样的功能大部分同学都应该能想到 array_slice 函数，但这个函数取出部分数组是根据偏移量（可以理解为键名在数组中的顺序，从 0 开始）而不是根据键名的，而关联数组的键名却是是字符串或者是不按顺序的数字，此时要解决的问题便是「如何取到键名对应的偏移量？」，这是 array_keys 函数便帮了我们大忙，它的功能是「返回数组中部分的或所有的键名」默认返回全部键名，此外返回的键名数组是以数字索引的，也就是说返回的键名数组的索引就是偏移量！例子中的原数组变为： [0 => 'first', 1 => 'second', 2 => 'third'] 。然后我们通过 array_search 便可以获得指定键名的偏移量了，因为这个函数的功能是「在数组中搜索给定的值，如果成功则返回首个相应的键名」。有了偏移量我们直接调用 array_slice 函数便可以实现目的了。 上面的例子懂了，那获取指定键名之后的数组也就轻而易举了，略微修改 array_slice 即可。直接贴代码：

<?php$data = ['first' => 1, 'second' => 2, 'third' => 3];function afterKey($array, $key) $keys = array_keys($array); $offset = array_search($key, $keys); return array_slice($array, $offset + 1);var_dump(afterKey($data, 'first'));// 结果 ['second' => 2, 'third' => 3]var_dump(afterKey($data, 'second'));// 结果 ['third' => 3]var_dump(afterKey($data, 'third'));// 结果 []
那如何获取指定值之前或之后的数组呢？嘿，记得 array_search 的作用吧，其实我们只需要这样调用 beforeKey($data, array_search($value, $data)) 不就实现了嘛！ 0x08 数组中重复次数最多的值 敲黑板，划重点！据说这是一道面试题喔。假设有这样一个数组 [6, 11, 11, 2, 4, 4, 11, 6, 7, 4, 2, 11, 8]，请问如何获取数组中重复次数最多的值？关键就在于 array_count_values 函数。实例代码如下：

<?php$data = [6, 11, 11, 2, 4, 4, 11, 6, 7, 4, 2, 11, 8];$cv = array_count_values($data);// $cv = [6 => 2, 11 => 4, 2 => 2, 4 => 3, 7 => 1, 8 => 1]arsort($cv);$max = key($cv);var_dump($max);// 结果 11
array_count_values 函数的功能是「统计数组中所有的值」，就是将原数组中的值作为返回数组的键名，值出现的次数作为返回数组的值。这样我们便可以通过 arsort 函数对出现的次数进行降序排序并且保持索引关联。最后使用 key 获得当前单元（当前单元默认为数组第一个成员）的键名，此时的键名即是原数组的值重复次数最多的值。

0x09 打广告时间

虽然 PHP 提供了很多和数组相关的函数，但使用起来还是不算太方便而且都是通过函数的调用方式而没有面向对象相关的实现，所以我最近在写一个开源的工具类项目 zane/utils，封装了一些常用的方法并且支持链式调用，其中的 Ary 类实现 「获取数组中重复次数最多的值」只需一行，如下所示：

$data = [6, 11, 11, 2, 4, 4, 11, 6, 7, 4, 2, 11, 8];$max = Ary::new($data)->countValues()->maxKey();var_dump($max);// 结果 11
欢迎大家给我提 issue 和 pr，另外如果你喜欢这个项目希望动动小手点个 star :-D 项目地址：github.com/zanemmm/uti…

0x0A 结语

其实还有很多实用的函数没有介绍，但是限于文章篇幅就讲到这里了吧。本文出现的很多例子都并非本人原创的，多数出于 PHP 官方手册（每个函数功能下面的评论里都有很多大神提出一些厉害的用法，部分示例就是出自评论）。在下只是拾人牙慧，将其总结了一下。另外文章中若出现错误，希望大家能够指出，若有疑问可以互相讨论:-D。

以上内容希望帮助到大家，很多PHPer在进阶的时候总会遇到一些问题和瓶颈，业务代码写多了没有方向感，不知道该从那里入手去提升，对此我整理了一些资料，包括但不限于：分布式架构、高可扩展、高性能、高并发、服务器性能调优、TP6，laravel，YII2，Redis，Swoole、Swoft、Kafka、mysql优化、shell脚本、Docker、微服务、nginx等多个知识点高级进阶干货需要的可以免费分享给大家，需要的可以点击查看详细资料！！

喜欢我的文章就关注我吧，持续更新中.....

搜索
初学编程100个代码
普通人自学编程有用吗
自学编程该如何入手
最简单的php函数
从零开始学编程怎么学
java自学一般要学多久

（基础篇）数组函数详解

一、数组操作的基本函数

数组的键名和值

array_values($arr);获得数组的值

array_keys($arr);获得数组的键名

array_flip($arr);数组中的值与键名互换（如果有重复前面的会被后面的覆盖）

in_array("apple",$arr);在数组中检索apple

array_search("apple",$arr);在数组中检索apple ，如果存在返回键名

array_key_exists("apple",$arr);检索给定的键名是否存在数组中

isset($arr[apple]):检索给定的键名是否存在数组中

 

数组的内部指针

current($arr);返回数组中的当前单元

pos($arr);返回数组中的当前单元

key($arr);返回数组中当前单元的键名

prev($arr);将数组中的内部指针倒回一位

next($arr);将数组中的内部指针向前移动一位

end($arr);将数组中的内部指针指向最后一个单元

reset($arr;将数组中的内部指针指向第一个单元

each($arr);将返回数组当前元素的一个键名/值的构造数组，并使数组指针向前移动一位

list($key,$value)=each($arr);获得数组当前元素的键名和值

 

数组和变量之间的转换

extract($arr);用于把数组中的元素转换成变量导入到当前文件中，键名当作变量名，值作为变量值

注：（第二个参数很重要，可以看手册使用）使用方法  echo $a;

compact(var1,var2,var3);用给定的变量名创建一个数组

 

二、数组的分段和填充

数组的分段

array_slice($arr,0,3);可以将数组中的一段取出，此函数忽略键名

array_splice($arr,0,3，array("black","maroon"));可以将数组中的一段取出，与上个函数不同在于返回的序列从原数组中删除

 

分割多个数组

array_chunk($arr,3,TRUE);可以将一个数组分割成多个，TRUE为保留原数组的键名

 

数组的填充

array_pad($arr,5,‘x‘);将一个数组填补到制定长度

 

三、数组与栈

array_push($arr,"apple","pear");将一个或多个元素压入数组栈的末尾（入栈），返回入栈元素的个数

array_pop($arr);将数组栈的最后一个元素弹出（出栈）

 

四、数组与列队

array_shift($arr);数组中的第一个元素移出并作为结果返回（数组长度减1，其他元素向前移动一位，数字键名改为从零技术，文字键名不变）

array_unshift($arr,"a",array(1,2));在数组的开头插入一个或多个元素

 

五、回调函数

array_walk($arr,‘function‘,‘words‘);使用用户函数对数组中的每个成员进行处理（第三个参数传递给回调函数function）

array_mpa("function",$arr1,$arr2);可以处理多个数组（当使用两个或更多数组时，他们的长度应该相同）

array_filter($arr,"function");使用回调函数过滤数组中的每个元素，如果回调函数为TRUE，数组的当前元素会被包含在返回的结果数组中，数组的键名保留不变

array_reduce($arr,"function","*");转化为单值函数（*为数组的第一个值）

 

六、数组的排序

通过元素值对数组排序

sort($arr);由小到大的顺序排序（第二个参数为按什么方式排序）忽略键名的数组排序

rsort($arr);由大到小的顺序排序（第二个参数为按什么方式排序）忽略键名的数组排序

usort($arr,"function");使用用户自定义的比较函数对数组中的值进行排序（function中有两个参数，0表示相等，正数表示第一个大于第二个，负数表示第一个小于第二个）忽略键名的数组排序

asort($arr);由小到大的顺序排序（第二个参数为按什么方式排序）保留键名的数组排序

arsort($arr);由大到小的顺序排序（第二个参数为按什么方式排序）保留键名的数组排序

uasort($arr,"function");使用用户自定义的比较函数对数组中的值进行排序（function中有两个参数，0表示相等，正数表示第一个大于第二个，负数表示第一个小于第二个）保留键名的数组排序

 

通过键名对数组排序

ksort($arr);按照键名正序排序

krsort($arr);按照键名逆序排序

uksort($arr,"function");使用用户自定义的比较函数对数组中的键名进行排序（function中有两个参数，0表示相等，正数表示第一个大于第二个，负数表示第一个小于第二个）

 

自然排序法排序

natsort($arr);自然排序（忽略键名）

natcasesort($arr);自然排序（忽略大小写，忽略键名）

 

七、数组的计算

数组元素的求和

array_sum($arr);对数组内部的所有元素做求和运算

 

数组的合并

array_merge($arr1,$arr2);合并两个或多个数组（相同的字符串键名，后面的覆盖前面的，相同的数字键名，后面的不会做覆盖操作，而是附加到后面）

“+”$arr1+$arr2;对于相同的键名只保留后一个

array_merge_recursive($arr1,$arr2); 递归合并操作，如果数组中有相同的字符串键名，这些值将被合并到一个数组中去。如果一个值本身是一个数组，将按照相应的键名把它合并为另一个数组。当数组 具有相同的数组键名时，后一个值将不会覆盖原来的值，而是附加到后面

 

数组的差集

array_diff($arr1,$arr2);返回差集结果数组

array_diff_assoc($arr1,$arr2,$arr3);返回差集结果数组，键名也做比较

 

数组的交集

array_intersect($arr1,$arr2);返回交集结果数组

array_intersect_assoc($arr1,$arr2);返回交集结果数组，键名也做比较

 

八、其他的数组函数

range(0,12);创建一个包含指定范围单元的数组

array_unique($arr);移除数组中重复的值，新的数组中会保留原始的键名

array_reverse($arr,TRUE);返回一个单元顺序与原数组相反的数组，如果第二个参数为TRUE保留原来的键名

//srand((float)microtime()*10000000); 随机种子触发器

array_rand($arr,2);从数组中随机取出一个或 多个元素

shuffle($arr);将数组的顺序打乱

本类函数允许用多种方法来操作数组和与之交互。数组的本质是储存，管理和操作一组变量。

PHP 支持一维和多维数组，可以是用户创建或由另一个函数创建。有一些特定的数据库处理函数可以从数据库查询中生成数组，还有一些函数返回数组。

 

array_change_key_case — 返回字符串键名全为小写或大写的数组

array_chunk — 将一个数组分割成多个

array_combine — 创建一个数组，用一个数组的值作为其键名，另一个数组的值作为其值

array_count_values — 统计数组中所有的值出现的次数

array_diff_assoc — 带索引检查计算数组的差集

array_diff_key — 使用键名比较计算数组的差集

array_diff_uassoc — 用用户提供的回调函数做索引检查来计算数组的差集

array_diff_ukey — 用回调函数对键名比较计算数组的差集

array_diff — 计算数组的差集

array_fill_keys — Fill an array with values, specifying keys

array_fill — 用给定的值填充数组

array_filter — 用回调函数过滤数组中的单元

array_flip — 交换数组中的键和值

array_intersect_assoc — 带索引检查计算数组的交集

array_intersect_key — 使用键名比较计算数组的交集

array_intersect_uassoc — 带索引检查计算数组的交集，用回调函数比较索引

array_intersect_ukey — 用回调函数比较键名来计算数组的交集

array_intersect — 计算数组的交集

array_key_exists — 检查给定的键名或索引是否存在于数组中

array_keys — 返回数组中所有的键名

array_map — 将回调函数作用到给定数组的单元上

array_merge_recursive — 递归地合并一个或多个数组

array_merge — 合并一个或多个数组

array_multisort — 对多个数组或多维数组进行排序

array_pad — 用值将数组填补到指定长度

array_pop — 将数组最后一个单元弹出（出栈）

array_product — 计算数组中所有值的乘积

array_push — 将一个或多个单元压入数组的末尾（入栈）

array_rand — 从数组中随机取出一个或多个单元

array_reduce — 用回调函数迭代地将数组简化为单一的值

array_reverse — 返回一个单元顺序相反的数组

array_search — 在数组中搜索给定的值，如果成功则返回相应的键名

array_shift — 将数组开头的单元移出数组

array_slice — 从数组中取出一段

array_splice — 把数组中的一部分去掉并用其它值取代

array_sum — 计算数组中所有值的和

array_udiff_assoc — 带索引检查计算数组的差集，用回调函数比较数据

array_udiff_uassoc — 带索引检查计算数组的差集，用回调函数比较数据和索引

array_udiff — 用回调函数比较数据来计算数组的差集

array_uintersect_assoc — 带索引检查计算数组的交集，用回调函数比较数据

array_uintersect_uassoc — 带索引检查计算数组的交集，用回调函数比较数据和索引

array_uintersect — 计算数组的交集，用回调函数比较数据

array_unique — 移除数组中重复的值

array_unshift — 在数组开头插入一个或多个单元

array_values — 返回数组中所有的值

array_walk_recursive — 对数组中的每个成员递归地应用用户函数

array_walk — 对数组中的每个成员应用用户函数

array — 新建一个数组

arsort — 对数组进行逆向排序并保持索引关系

asort — 对数组进行排序并保持索引关系

compact — 建立一个数组，包括变量名和它们的值

count — 计算数组中的单元数目或对象中的属性个数

current — 返回数组中的当前单元

each — 返回数组中当前的键／值对并将数组指针向前移动一步

end — 将数组的内部指针指向最后一个单元

extract — 从数组中将变量导入到当前的符号表

in_array — 检查数组中是否存在某个值

key — 从关联数组中取得键名

krsort — 对数组按照键名逆向排序

ksort — 对数组按照键名排序

list — 把数组中的值赋给一些变量

natcasesort — 用“自然排序”算法对数组进行不区分大小写字母的排序

natsort — 用“自然排序”算法对数组排序

next — 将数组中的内部指针向前移动一位

pos — current() 的别名

prev — 将数组的内部指针倒回一位

range — 建立一个包含指定范围单元的数组

reset — 将数组的内部指针指向第一个单元

rsort — 对数组逆向排序

shuffle — 将数组打乱

sizeof — count() 的别名

sort — 对数组排序

uasort — 使用用户自定义的比较函数对数组中的值进行排序并保持索引关联

uksort — 使用用户自定义的比较函数对数组中的键名进行排序

usort — 使用用户自定义的比较函数对数组中的值进行排序