首页 / 网页编程 / PHP / PHP数组操作类实例

class ArrayHelper{/** * 从数组中删除空白的元素（包括只有空白字符的元素） * * 用法： * @code php * $arr = array（"", "test", ""）; * ArrayHelper::removeEmpty（$arr）; * * dump（$arr）; *// 输出结果中将只有 "test" * @endcode * * @param array $arr 要处理的数组 * @param boolean $trim 是否对数组元素调用 trim 函数 */static function removeEmpty（& $arr, $trim = TRUE）{foreach （$arr as $key => $value）{if （is_array（$value））{self::removeEmpty（$arr[$key]）;}else{$value = trim（$value）;if （$value == ""）{unset（$arr[$key]）;}elseif （$trim）{$arr[$key] = $value;}}}}/** * 从一个二维数组中返回指定键的所有值 * * 用法： * @code php * $rows = array（ * array（"id" => 1, "value" => "1-1"）, * array（"id" => 2, "value" => "2-1"）, * ）; * $values = ArrayHelper::getCols（$rows, "value"）; * * dump（$values）; *// 输出结果为 *// array（ *//"1-1", *//"2-1", *// ） * @endcode * * @param array $arr 数据源 * @param string $col 要查询的键 * * @return array 包含指定键所有值的数组 */static function getCols（$arr, $col）{$ret = array（）;foreach （$arr as $row）{if （isset（$row[$col]）） {$ret[] = $row[$col];}}return $ret;}/** * 将一个二维数组转换为 HashMap，并返回结果 * * 用法1： * @code php * $rows = array（ * array（"id" => 1, "value" => "1-1"）, * array（"id" => 2, "value" => "2-1"）, * ）; * $hashmap = ArrayHelper::toHashmap（$rows, "id", "value"）; * * dump（$hashmap）; *// 输出结果为 *// array（ *//1 => "1-1", *//2 => "2-1", *// ） * @endcode * * 如果省略 $valueField 参数，则转换结果每一项为包含该项所有数据的数组。 * * 用法2： * @code php * $rows = array（ * array（"id" => 1, "value" => "1-1"）, * array（"id" => 2, "value" => "2-1"）, * ）; * $hashmap = ArrayHelper::toHashmap（$rows, "id"）; * * dump（$hashmap）; *// 输出结果为 *// array（ *//1 => array（"id" => 1, "value" => "1-1"）, *//2 => array（"id" => 2, "value" => "2-1"）, *// ） * @endcode * * @param array $arr 数据源 * @param string $keyField 按照什么键的值进行转换 * @param string $valueField 对应的键值 * * @return array 转换后的 HashMap 样式数组 */static function toHashmap（$arr, $keyField, $valueField = NULL）{$ret = array（）;if （$valueField）{foreach （$arr as $row）{$ret[$row[$keyField]] = $row[$valueField];}}else{foreach （$arr as $row）{$ret[$row[$keyField]] = $row;}}return $ret;}/** * 将一个二维数组按照指定字段的值分组 * * 用法： * @endcode * * @param array $arr 数据源 * @param string $keyField 作为分组依据的键名 * * @return array 分组后的结果 */static function groupBy（$arr, $keyField）{$ret = array（）;foreach （$arr as $row）{$key = $row[$keyField];$ret[$key][] = $row;}return $ret;}/** * 将一个平面的二维数组按照指定的字段转换为树状结构 * * * 如果要获得任意节点为根的子树，可以使用 $refs 参数： * @code php * $refs = null; * $tree = ArrayHelper::tree（$rows, "id", "parent", "nodes", $refs）; * * // 输出 id 为 3 的节点及其所有子节点 * $id = 3; * dump（$refs[$id]）; * @endcode * * @param array $arr 数据源 * @param string $keyNodeId 节点ID字段名 * @param string $keyParentId 节点父ID字段名 * @param string $keyChildrens 保存子节点的字段名 * @param boolean $refs 是否在返回结果中包含节点引用 * * return array 树形结构的数组 */static function toTree（$arr, $keyNodeId, $keyParentId = "parent_id", $keyChildrens = "childrens", & $refs = NULL）{$refs = array（）;foreach （$arr as $offset => $row）{$arr[$offset][$keyChildrens] = array（）;$refs[$row[$keyNodeId]] =& $arr[$offset];}$tree = array（）;foreach （$arr as $offset => $row）{$parentId = $row[$keyParentId];if （$parentId）{if （！isset（$refs[$parentId]））{$tree[] =& $arr[$offset];continue;}$parent =& $refs[$parentId];$parent[$keyChildrens][] =& $arr[$offset];}else{$tree[] =& $arr[$offset];}}return $tree;}/** * 将树形数组展开为平面的数组 * * 这个方法是 tree（） 方法的逆向操作。 * * @param array $tree 树形数组 * @param string $keyChildrens 包含子节点的键名 * * @return array 展开后的数组 */static function treeToArray（$tree, $keyChildrens = "childrens"）{$ret = array（）;if （isset（$tree[$keyChildrens]） && is_array（$tree[$keyChildrens]））{foreach （$tree[$keyChildrens] as $child）{$ret = array_merge（$ret, self::treeToArray（$child, $keyChildrens））;}unset（$node[$keyChildrens]）;$ret[] = $tree;}else{$ret[] = $tree;}return $ret;}/** * 根据指定的键对数组排序 * * @endcode * * @param array $array 要排序的数组 * @param string $keyname 排序的键 * @param int $dir 排序方向 * * @return array 排序后的数组 */static function sortByCol（$array, $keyname, $dir = SORT_ASC）{return self::sortByMultiCols（$array, array（$keyname => $dir））;}/** * 将一个二维数组按照多个列进行排序，类似 SQL 语句中的 ORDER BY * * 用法： * @code php * $rows = ArrayHelper::sortByMultiCols（$rows, array（ * "parent" => SORT_ASC, * "name" => SORT_DESC, * ））; * @endcode * * @param array $rowset 要排序的数组 * @param array $args 排序的键 * * @return array 排序后的数组 */static function sortByMultiCols（$rowset, $args）{$sortArray = array（）;$sortRule = "";foreach （$args as $sortField => $sortDir）{foreach （$rowset as $offset => $row）{$sortArray[$sortField][$offset] = $row[$sortField];}$sortRule .= "$sortArray["" . $sortField . ""], " . $sortDir . ", ";}if （empty（$sortArray） || empty（$sortRule）） {return $rowset;}eval（"array_multisort（" . $sortRule . "$rowset）;"）;return $rowset;}}