Array 助手（ArrayHelper）

由  创建， 最后一次修改 2016-02-24 数组助手类除了PHP中丰富的数组函数集， Yii 数组助手类提供了额外的静态方法，让你更高效地处理数组。获取值用原生PHP从一个对象、数组、或者包含这两者的一个复杂数据结构中获取数据是非常繁琐的。 你首先得使用isset?检查 key 是否存在, 然后如果存在你就获取它，如果不存在， 则提供一个默认返回值：class User{ public $name = 'Alex';}$array = [ 'foo' => [ 'bar' => new User(), ]];$value = isset($array['foo']['bar']->name) ? $array['foo']['bar']->name : null;Yii 提供了一个非常方便的方法来做这件事：$value = ArrayHelper::getValue($array, 'foo.bar.name');方法的第一个参数是我们从哪里获取值。第二个参数指定了如何获取数据， 它可以是下述几种类型中的一个：数组键名或者欲从中取值的对象的属性名称；以点号分割的数组键名或者对象属性名称组成的字符串，上例中使用的参数类型就是该类型；返回一个值的回调函数。回调函数如下例所示：$fullName = ArrayHelper::getValue($user, function ($user, $defaultValue) { return $user->firstName . ' ' . $user->lastName;});第三个可选的参数如果没有给定值，则默认为?null，如下例所示：$username = ArrayHelper::getValue($comment, 'user.username', 'Unknown');对于取到值后想要立即从数组中删除的情况，你可以使用?remove?方法：$array = ['type' => 'A', 'options' => [1, 2]];$type = ArrayHelper::remove($array, 'type');执行了上述代码之后，?$array?将包含?['options' => [1, 2]]?并且?$type?将会是?A?。 注意和?getValue?方法不同的是，remove?方法只支持简单键名。检查键名的存在ArrayHelper::keyExists?工作原理和array_key_exists差不多，除了 它还可支持大小写不敏感的键名比较，比如：$data1 = [ 'userName' => 'Alex',];$data2 = [ 'username' => 'Carsten',];if (!ArrayHelper::keyExists('username', $data1, false) || !ArrayHelper::keyExists('username', $data2, false)) { echo "Please provide username.";}检索列通常你要从多行数据或者多个对象构成的数组中获取某列的值，一个普通的例子是获取id值列表。$data = [ ['id' => '123', 'data' => 'abc'], ['id' => '345', 'data' => 'def'],];$ids = ArrayHelper::getColumn($array, 'id');结果将是?['123', '345']。如果需要额外的转换或者取值的方法比较复杂， 第二参数可以指定一个匿名函数：$result = ArrayHelper::getColumn($array, function ($element) { return $element['id'];});重建数组索引按一个指定的键名重新索引一个数组，可以用?index?方法。输入的数组应该是多维数组或者是一个对象数组。 键名（译者注：第二个参数）可以是子数组的键名、对象的属性名， 也可以是一个返回给定元素数组键值的匿名函数。如果一个键值（译者注：第二个参数对应的值）是 null，相应的数组元素将被丢弃并且不会放入到结果中，例如，$array = [ ['id' => '123', 'data' => 'abc'], ['id' => '345', 'data' => 'def'],];$result = ArrayHelper::index($array, 'id');// the result is:// [// '123' => ['id' => '123', 'data' => 'abc'],// '345' => ['id' => '345', 'data' => 'def'],// ]// using anonymous function$result = ArrayHelper::index($array, function ($element) { return $element['id'];});建立哈希表为了从一个多维数组或者一个对象数组中建立一个映射表(键值对)，你可以使用?map方法.$from?和?$to?参数分别指定了欲构建的映射表的键名和属性名。 根据需要，你可以按照一个分组字段?$group?将映射表进行分组，例如。$array = [ ['id' => '123', 'name' => 'aaa', 'class' => 'x'], ['id' => '124', 'name' => 'bbb', 'class' => 'x'], ['id' => '345', 'name' => 'ccc', 'class' => 'y'],);$result = ArrayHelper::map($array, 'id', 'name');// 结果是： // [// '123' => 'aaa',// '124' => 'bbb',// '345' => 'ccc',// ]$result = ArrayHelper::map($array, 'id', 'name', 'class');// 结果是：// [// 'x' => [// '123' => 'aaa',// '124' => 'bbb',// ],// 'y' => [// '345' => 'ccc',// ],// ]多维排序multisort?方法可用来对嵌套数组或者对象数组进行排序，可按一到多个键名排序，比如，$data = [ ['age' => 30, 'name' => 'Alexander'], ['age' => 30, 'name' => 'Brian'], ['age' => 19, 'name' => 'Barney'],];ArrayHelper::multisort($data, ['age', 'name'], [SORT_ASC, SORT_DESC]);排序之后我们在?$data?中得到的值如下所示：[ ['age' => 19, 'name' => 'Barney'], ['age' => 30, 'name' => 'Brian'], ['age' => 30, 'name' => 'Alexander'],];第二个参数指定排序的键名，如果是单键名的话可以是字符串，如果是多键名则是一个数组， 或者是如下例所示的一个匿名函数：ArrayHelper::multisort($data, function($item) { return isset($item['age']) ? ['age', 'name'] : 'name';});第三个参数表示增降顺序。单键排序时，它可以是?SORT_ASC?或者?SORT_DESC?之一。 如果是按多个键名排序，你可以用一个数组为各个键指定不同的顺序。最后一个参数（译者注：第四个参数）是PHP的排序标识（sort flag），可使用的值和调用PHP?sort()?函数时传递的值一样。检测数组类型想知道一个数组是索引数组还是联合数组很方便，这有个例子：// 不指定键名的数组$indexed = ['Qiang', 'Paul'];echo ArrayHelper::isIndexed($indexed);// 所有键名都是字符串$associative = ['framework' => 'Yii', 'version' => '2.0'];echo ArrayHelper::isAssociative($associative);HTML 编码和解码值为了将字符串数组中的特殊字符做 HTML 编解码，你可以使用下列方法：$encoded = ArrayHelper::htmlEncode($data);$decoded = ArrayHelper::htmlDecode($data);默认情况只会对值做编码（译者注：原文中是编码，应为编解码）。通过给第二个参数传?false?，你也可以