[10.x] Add data_remove helper

[PhiloNL]

This PR adds a new helper to the Collection helper. In addition to the existing data_get, data_set, and data_fill, this will add the data_remove helper to remove keys from objects or arrays easily. This is ideal if you want to remove keys from nested objects or arrays using the wildcard helper.

For example:

$data = [
    'article' => [
        'title' => 'Foo',
        'comments' => [
            ['comment' => 'foo','name' => 'First'],
            ['comment' => 'bar','name' => 'Second'],
        ]
    ]
];

data_remove($data, 'article.comments.*.name');

// Result
$data = [
    'article' => [
        'title' => 'Foo',
        'comments' => [
            ['comment' => 'foo'],
            ['comment' => 'bar'],
        ]
    ]
];

I wasn't sure about naming the function data_forget instead of data_remove as both terms are used throughout the framework. Let me know if you want the name changed.

Have a great day! 🙌🏻

[milwad-dev]

I think you can use Collection!

[PhiloNL]

I think you can use Collection!

@milwad-dev can you please elaborate? The Illuminate\Support\Collection@forget method does not allow the usage of the dot notation or wildcards but I'm not sure if this is what you referring to.

[devajmeireles]

As per the fact that we have data_get, data_set and data_fill I agree with that. I think it will be very useful. Thanks.

Just a question: following the naming convention of existing helpers, why not data_unset instead of data_remove?

[PhiloNL]

@ajmeireles as mentioned in the PR, I wasn't sure about naming the function data_forget instead of data_remove as both terms are used throughout the framework. data_unset is also an option of course but I'll let the Laravel team decide :)

[milwad-dev]

@PhiloNL
You're right, great!

[oyepez003]

Why don't use just https://laravel.com/docs/10.x/helpers#method-array-forget

[huangdijia]

Why don't use just https://laravel.com/docs/10.x/helpers#method-array-forget

Arr::forget is limited to arrays, while data_forget can manipulate objects.

[cdinopol]

Had a package similar to this from long time ago: https://github.com/cdinopol/data-guard

[PhiloNL]

Why don't use just https://laravel.com/docs/10.x/helpers#method-array-forget

Arr::forget also doesn't support wildcards.