enzyme/freckle

基于点的信息检索辅助工具集合...嗯?

v0.3.0 2016-04-03 05:46 UTC

This package is not auto-updated.

Last update: 2024-09-14 19:04:03 UTC


README

Build Status Coverage Status Scrutinizer Code Quality

Freckle 是一组信息访问器。它允许您使用点分隔的路径遍历并获取数组和其他集合类型中的值。例如,给定以下数组,获取 users.bob456.name 多维关联数组中的值

$array = [
    'users' => [
        'jane123' => ['name' => 'Jane Foo'],
        'bob456'  => ['name' => 'Bob Foo'],
    ]
];

将返回值 Bob Foo。很简单吧?

安装

composer require enzyme/freckle

使用方法

从简单集合中获取值。

use Enzyme\Freckle\Dot;

$array = [
    'users' => [
        'jane123' => ['name' => 'Jane Foo'],
        'bob456'  => ['name' => 'Bob Foo'],
    ]
];

$dot = new Dot;
$full_name = $dot->get($array, 'users.bob456.name'); // returns "Bob Foo".

从具有数字键的简单集合中获取值。

use Enzyme\Freckle\Dot;

$array = [
    'users' => [
        0 => [
            'jane123' => ['name' => 'Jane Foo'],
        ],
        1 => [
            'bob456'  => ['name' => 'Bob Foo'],
        ]
    ]
];

$dot = new Dot;
$full_name = $dot->get($array, 'users.bob456.name'); // returns "Bob Foo".

如果集合具有数字键或支持具有相同键名的多个条目,则仅返回找到的第一个结果。

如果没有找到值,将返回 null。但请注意,如果您在检查成功时针对 null 值进行检查,那么如果找到了实际值,但该值恰好是 null,则可能会得到假阳性。

贡献

请参阅 CONTRIBUTING.md

许可证

MIT - 版权所有 (c) 2015 Tristan Strathearn,请参阅 LICENSE