Digging Deeper - 07.1 Helpers - Arrays & Objects

Die Arr::add-Methode fügt ein gegebenes Schlüssel/Wert-Paar zu einem Array hinzu, wenn der gegebene Schlüssel nicht bereits im Array existiert:

use Illuminate\Support\Arr;

$array = Arr::add(['name' => 'Desk'], 'price', 100);

// ['name' => 'Desk', 'price' => 100]

Die Arr::collapse-Methode kollabiert ein Array von Arrays in ein einziges Array:

use Illuminate\Support\Arr;

$array = Arr::collapse([[1, 2, 3], [4, 5, 6], [7, 8, 9]]);

// [1, 2, 3, 4, 5, 6, 7, 8, 9]

Die Methode Arr::divide gibt zwei Arrays zurück, von denen eines die Schlüssel und das andere die Werte des gegebenen Arrays enthält:

use Illuminate\Support\Arr;

[$keys, $values] = Arr::divide(['name' => 'Desk']);

// $keys: ['name']

// $values: ['Desk']

Die Arr::dot-Methode verflacht ein mehrdimensionales Array zu einem einstufigen Array, das die "Punkt"-Notation zur Angabe der Tiefe verwendet:

use Illuminate\Support\Arr;

$array = ['products' => ['desk' => ['price' => 100]]];

$flattened = Arr::dot($array);

// ['products.desk.price' => 100]

Die Arr::except-Methode entfernt die angegebenen Schlüssel/Wert-Paare aus einem Array:

use Illuminate\Support\Arr;

$array = ['name' => 'Desk', 'price' => 100];

$filtered = Arr::except($array, ['price']);

// ['name' => 'Desk']

Die Methode Arr::first gibt das erste Element eines Arrays zurück, das einen gegebenen Wahrheitstest besteht:

use Illuminate\Support\Arr;

$array = [100, 200, 300];

$first = Arr::first($array, function ($value, $key) {
    return $value >= 150;
});

// 200

Ein Standardwert kann auch als dritter Parameter an die Methode übergeben werden. Dieser Wert wird zurückgegeben, wenn kein Wert den Wahrheitstest besteht:

use Illuminate\Support\Arr;

$first = Arr::first($array, $callback, $default);

Die Arr::flatten-Methode verflacht ein mehrdimensionales Array zu einem einstufigen Array:

use Illuminate\Support\Arr;

$array = ['name' => 'Joe', 'languages' => ['PHP', 'Ruby']];

$flattened = Arr::flatten($array);

// ['Joe', 'PHP', 'Ruby']

Die Arr::forget-Methode entfernt ein bestimmtes Schlüssel/Wert-Paar aus einem tief verschachtelten Array in "Punkt"-Notation:

use Illuminate\Support\Arr;

$array = ['products' => ['desk' => ['price' => 100]]];

Arr::forget($array, 'products.desk');

// ['products' => []]

Die Arr::get-Methode ruft einen Wert aus einem tief verschachtelten Array in "Punkt"-Notation ab:

use Illuminate\Support\Arr;

$array = ['products' => ['desk' => ['price' => 100]]];

$price = Arr::get($array, 'products.desk.price');

// 100

Die Arr::get-Methode akzeptiert auch einen Standardwert, der zurückgegeben wird, wenn der spezifische Schlüssel nicht gefunden wird:

use Illuminate\Support\Arr;

$discount = Arr::get($array, 'products.desk.discount', 0);

// 0

Die Arr::has-Methode prüft, ob ein bestimmtes Element oder bestimmte Elemente in einem Array in "Punkt"-Notation existieren:

use Illuminate\Support\Arr;

$array = ['product' => ['name' => 'Desk', 'price' => 100]];

$contains = Arr::has($array, 'product.name');

// true

$contains = Arr::has($array, ['product.price', 'product.discount']);

// false

Die Methode Arr::last gibt das letzte Element eines Arrays zurück, das einen gegebenen Wahrheitstest besteht:

use Illuminate\Support\Arr;

$array = [100, 200, 300, 110];

$last = Arr::last($array, function ($value, $key) {
    return $value >= 150;
});

// 300

Ein Standardwert kann als drittes Argument an die Methode übergeben werden. Dieser Wert wird zurückgegeben, wenn kein Wert den Wahrheitstest besteht:

use Illuminate\Support\Arr;

$last = Arr::last($array, $callback, $default);

Die Methode Arr::only gibt nur die angegebenen Schlüssel/Wertpaare aus dem angegebenen Array zurück:

use Illuminate\Support\Arr;

$array = ['name' => 'Desk', 'price' => 100, 'orders' => 10];

$slice = Arr::only($array, ['name', 'price']);

// ['name' => 'Desk', 'price' => 100]

Die Arr::pluck-Methode ruft alle Werte für einen gegebenen Schlüssel aus einem Array ab:

use Illuminate\Support\Arr;

$array = [
    ['developer' => ['id' => 1, 'name' => 'Taylor']],
    ['developer' => ['id' => 2, 'name' => 'Abigail']],
];

$names = Arr::pluck($array, 'developer.name');

// ['Taylor', 'Abigail']

Sie können auch angeben, wie die Ergebnisliste verschlüsselt werden soll:

use Illuminate\Support\Arr;

$names = Arr::pluck($array, 'developer.name', 'developer.id');

// [1 => 'Taylor', 2 => 'Abigail']

Die Arr::prepend-Methode schiebt ein Element an den Anfang eines Arrays:

use Illuminate\Support\Arr;

$array = ['one', 'two', 'three', 'four'];

$array = Arr::prepend($array, 'zero');

// ['zero', 'one', 'two', 'three', 'four']

Falls erforderlich, können Sie den Schlüssel angeben, der für den Wert verwendet werden soll:

use Illuminate\Support\Arr;

$array = ['price' => 100];

$array = Arr::prepend($array, 'Desk', 'name');

// ['name' => 'Desk', 'price' => 100]

Die Arr::pull-Methode gibt ein Schlüssel/Wert-Paar zurück und entfernt es aus einem Array:

use Illuminate\Support\Arr;

$array = ['name' => 'Desk', 'price' => 100];

$name = Arr::pull($array, 'name');

// $name: Desk

// $array: ['price' => 100]

Ein Standardwert kann als drittes Argument an die Methode übergeben werden. Dieser Wert wird zurückgegeben, wenn der Schlüssel nicht existiert:

use Illuminate\Support\Arr;

$value = Arr::pull($array, $key, $default);

Die Arr::random-Methode gibt einen Zufallswert aus einem Array zurück:

use Illuminate\Support\Arr;

$array = [1, 2, 3, 4, 5];

$random = Arr::random($array);

// 4 - (retrieved randomly)

Sie können auch die Anzahl der zurückzugebenden Elemente als optionales zweites Argument angeben. Beachten Sie, dass die Bereitstellung dieses Arguments ein Array zurückgibt, auch wenn nur ein Element gewünscht wird:

use Illuminate\Support\Arr;

$items = Arr::random($array, 2);

// [2, 5] - (retrieved randomly)

Die Arr::set-Methode setzt einen Wert innerhalb eines tief verschachtelten Arrays mit der "Punkt"-Notation:

use Illuminate\Support\Arr;

$array = ['products' => ['desk' => ['price' => 100]]];

Arr::set($array, 'products.desk.price', 200);

// ['products' => ['desk' => ['price' => 200]]]

Die Arr::sort-Methode sortiert ein Array nach seinen Werten:

use Illuminate\Support\Arr;

$array = ['Desk', 'Table', 'Chair'];

$sorted = Arr::sort($array);

// ['Chair', 'Desk', 'Table']

Sie können das Array auch nach den Ergebnissen des gegebenen Abschlusses (Closure) sortieren:

use Illuminate\Support\Arr;

$array = [
    ['name' => 'Desk'],
    ['name' => 'Table'],
    ['name' => 'Chair'],
];

$sorted = array_values(Arr::sort($array, function ($value) {
    return $value['name'];
}));

/*
    [
        ['name' => 'Chair'],
        ['name' => 'Desk'],
        ['name' => 'Table'],
    ]
*/

Die Methode Arr::sortRecursive sortiert ein Array rekursiv mit der Sortierfunktion für numerische Unterarrays und ksort für assoziative Unterarrays:

use Illuminate\Support\Arr;

$array = [
    ['Roman', 'Taylor', 'Li'],
    ['PHP', 'Ruby', 'JavaScript'],
    ['one' => 1, 'two' => 2, 'three' => 3],
];

$sorted = Arr::sortRecursive($array);

/*
    [
        ['JavaScript', 'PHP', 'Ruby'],
        ['one' => 1, 'three' => 3, 'two' => 2],
        ['Li', 'Roman', 'Taylor'],
    ]
*/

Die Arr::where-Methode filtert ein Array unter Verwendung der gegebenen Closure:

use Illuminate\Support\Arr;

$array = [100, '200', 300, '400', 500];

$filtered = Arr::where($array, function ($value, $key) {
    return is_string($value);
});

// [1 => '200', 3 => '400']

Die Arr::wrap-Methode wickelt den angegebenen Wert in ein Array ein. Wenn der angegebene Wert bereits ein Array ist, wird er nicht geändert:

use Illuminate\Support\Arr;

$string = 'Laravel';

$array = Arr::wrap($string);

// ['Laravel']

Wenn der angegebene Wert null ist, wird ein leeres Array zurückgegeben:

use Illuminate\Support\Arr;

$nothing = null;

$array = Arr::wrap($nothing);

// []

Die Funktion data_fill setzt einen fehlenden Wert innerhalb eines verschachtelten Arrays oder Objekts mit Hilfe der "Punkt"-Notation:

$data = ['products' => ['desk' => ['price' => 100]]];

data_fill($data, 'products.desk.price', 200);

// ['products' => ['desk' => ['price' => 100]]]

data_fill($data, 'products.desk.discount', 10);

// ['products' => ['desk' => ['price' => 100, 'discount' => 10]]]

Diese Funktion akzeptiert auch Sternchen als Platzhalter und füllt das Ziel entsprechend aus:

$data = [
    'products' => [
        ['name' => 'Desk 1', 'price' => 100],
        ['name' => 'Desk 2'],
    ],
];

data_fill($data, 'products.*.price', 200);

/*
    [
        'products' => [
            ['name' => 'Desk 1', 'price' => 100],
            ['name' => 'Desk 2', 'price' => 200],
        ],
    ]
*/

Die Funktion data_get ruft einen Wert aus einem verschachtelten Array oder Objekt mit der "Punkt"-Notation ab:

$data = ['products' => ['desk' => ['price' => 100]]];

$price = data_get($data, 'products.desk.price');

// 100

Die Funktion data_get akzeptiert auch einen Standardwert, der zurückgegeben wird, wenn der angegebene Schlüssel nicht gefunden wird:

$discount = data_get($data, 'products.desk.discount', 0);

// 0

Die Funktion akzeptiert auch Platzhalter mit Sternchen, die auf jeden Schlüssel des Arrays oder Objekts abzielen können:

$data = [
    'product-one' => ['name' => 'Desk 1', 'price' => 100],
    'product-two' => ['name' => 'Desk 2', 'price' => 150],
];

data_get($data, '*.name');

// ['Desk 1', 'Desk 2'];

Die Funktion data_set setzt einen Wert innerhalb eines verschachtelten Arrays oder Objekts mit der "Punkt"-Notation:

$data = ['products' => ['desk' => ['price' => 100]]];

data_set($data, 'products.desk.price', 200);

// ['products' => ['desk' => ['price' => 200]]]

Diese Funktion akzeptiert auch Wildcards und setzt die Werte auf dem Ziel entsprechend:

$data = [
    'products' => [
        ['name' => 'Desk 1', 'price' => 100],
        ['name' => 'Desk 2', 'price' => 150],
    ],
];

data_set($data, 'products.*.price', 200);

/*
    [
        'products' => [
            ['name' => 'Desk 1', 'price' => 200],
            ['name' => 'Desk 2', 'price' => 200],
        ],
    ]
*/

Standardmäßig werden alle vorhandenen Werte überschrieben. Wenn Sie einen Wert nur dann setzen möchten, wenn er nicht existiert, können Sie als viertes Argument false übergeben:

$data = ['products' => ['desk' => ['price' => 100]]];

data_set($data, 'products.desk.price', 200, false);

// ['products' => ['desk' => ['price' => 100]]]

Die head-Funktion gibt das erste Element im angegebenen Array zurück:

$array = [100, 200, 300];

$first = head($array);

// 100

Die last-Funktion gibt das letzte Element in dem angegebenen Array zurück:

$array = [100, 200, 300];

$last = last($array);

// 300