目录 搜索
阅读前篇 简介 Yii 是什么 从 Yii 1.1 升级 入门 安装 Yii 运行应用 第一次问候 使用Forms 数据库应用 使用 Gii 生成代码 进阶 应用结构 概述 入口脚本 应用(Applications) 应用组件(Application Components) 控制器(Controllers) 模型(Models) 视图(views) 模块(Modules) 过滤器(Filters) 小部件(Widgets) 前端资源(Assets) 扩展(Extensions) 请求处理 运行概述 启动引导(Bootstrapping) 路由和创建URL 请求(Requests) 响应(Responses) Sessions 和 Cookies 错误处理(Handling Errors) 日志(Logging) 关键概念 组件(Component) 属性(Property) 事件(Events) 行为(Behaviors) 配置(Configurations) 别名(Aliases) 类自动加载(Autoloading) 服务定位器(Service Locator) 依赖注入容器(Dependency Injection Container) 配合数据库工作 数据库访问 (Data Access Objects) 查询生成器(Query Builder) 活动记录(Active Record) 数据库迁移(Migrations) Sphinx Redis MongoDB Elasticsearch 接收用户数据 创建表单(Creating Forms) 输入验证(Validating Input) 文件上传(Uploading Files) 收集列表输入(Collecting Tabular Input) 多模型的复合表单(Getting Data for Multiple Models) 显示数据 格式化输出数据(Data Formatting) 分页(Pagination) 排序(Sorting) 数据提供器(Data Providers) 数据小部件(Data Widgets) 客户端脚本使用(Working with Client Scripts) 主题(Theming) 安全 认证(Authentication) 授权(Authorization) 处理密码(Working with Passwords) 客户端认证(Auth Clients) 最佳安全实践(Best Practices) 缓存 概述 数据缓存 片段缓存 页面缓存 HTTP 缓存 RESTfull Web服务 快速入门(Quick Start) 资源(Resources) 控制器(Controllers) 路由(Routing) 格式化响应(Response Formatting) 授权认证(Authentication) 速率限制(Rate Limiting) 版本(Versioning) 错误处理(Error Handling) 开发工具 调试工具栏和调试器 使用Gii生成代码 生成API文档 测试 概述(Overview) 配置测试环境(Testing environment setup) 单元测试(Unit Tests) 功能测试(Function Tests) 验收测试(Acceptance Tests) 测试夹具(Fixtures) 高级专题 高级应用模板 创建自定义应用程序结构 控制台命令 核心验证器(Core Validators) 国际化 收发邮件 性能优化 共享主机环境 模板引擎 集成第三方代码 小部件 Bootstrap 小部件 Jquery UI 助手类 概述 Array 助手(ArrayHelper) Html 助手(Html) Url 助手(Url)
文字

Array 助手

数组助手类

除了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 ,你也可以对键名做编码。 编码将默认使用应用程序的字符集,你可以通过第三个参数指定该字符集。

合并数组

  /**
    * 将两个或者多个数组递归式的合并为一个数组。
    * 如果每个数组有一个元素的键名相同,
    * 那么后面元素的将覆盖前面的元素(不同于 array_merge_recursive)。
    * 如果两个数组都有相同键名的数组元素(译者注:嵌套数组)
    * 则将引发递归合并。
    * 对数值型键名的元素,后面数组中的这些元素会被追加到前面数组中。
    * @param array $a 被合并的数组
    * @param array $b 合并的数组,你可以在第三、第四个
    * 参数中指定另外的合并数组,等等
    * @return 合并的结果数组 (原始数组不会被改变)
    */
    public static function merge($a, $b)

对象转换为数组

你经常要将一个对象或者对象的数组转换成一个数组,常见的情形是,为了通过REST API提供数据数组(或其他使用方式), 将AR模型(活动记录模型)转换成数组。如下代码可完成这个工作:

$posts = Post::find()->limit(10)->all();
$data = ArrayHelper::toArray($posts, [
    'app\models\Post' => [
        'id',
        'title',
        // the key name in array result => property name
        'createTime' => 'created_at',
        // the key name in array result => anonymous function
        'length' => function ($post) {
            return strlen($post->content);
        },
    ],
]);

第一个参数包含我们想要转换的数据,在本例中,我们要转换一个叫 Post 的 AR 模型。

第二个参数是每个类的转换映射表,我们在此设置了一个Post 模型的映射。 每个映射数组包含一组的映射,每个映射可以是:

  • 一个要包含的照原样的字段名(和类中属性的名称一致);
  • 一个由你可随意取名的键名和你想从中取值的模型列名组成的键值对;
  • 一个由你可随意取名的键名和有返回值的回调函数组成的键值对;

这上面的转换结果将会是:

[
    'id' => 123,
    'title' => 'test',
    'createTime' => '2013-01-01 12:00AM',
    'length' => 301,
]
也可以在一个特定的类中实现yii\base\Arrayable接口, 从而为其对象提供默认的转换成数组的方法。
上一篇: 下一篇: