[8.x] Change whereStartsWith, DocBlock to reflect that array is supported

[tanthammar]

A non-breaking change to avoid IDE warnings

whereStartsWith, whereDoesntStartWith and thatStartWith DocBlocks says it only accepts a string, but an array also works, as it's being passed to Str::startsWith($haystack, $needles) which accepts an array too.

I also changed the variable name from $string to $needles for better code readability.
That could potentially be a breaking change if php8 users have started to use named properties...

Would suggest that official documentation is updated to help others save time.

User benefits:

Due to my IDE and official docs, I thought I had to do this:

<input  {{ $attributes->whereDoesntStartWith('wire:model')->whereDoesntStartWith('x-model') }}  />

When I discovered that this is supported:

<input  {{ $attributes->whereDoesntStartWith(['wire:model', 'x-model']) }}  />

Creds to @ryangjchandler who told me :)

[taylorotwell]

Tests are failing on this one.

[morloderex]

@tanthammar Looks like you didn't change the use variable in the closures.

[tanthammar]

@tanthammar Looks like you didn't change the use variable in the closures.

@morloderex so true, thank you :)

[ryangjchandler]

I don't think you can change the parameter names on a minor release, would need to target 9.x / master or keep the names the same. Correct me if I'm wrong though.

[tanthammar]

I don't think you can change the parameter names on a minor release, would need to target 9.x / master or keep the names the same. Correct me if I'm wrong though.

I don't mind changing it.
Didn't read anywhere that Laravel framework has "locked" its parameter names yet?

Guess @taylorotwell has the last say in the matter.

I'll gladly change it back, that part is not important, just better to read.

[driesvints]

I don't think you can change the parameter names on a minor release, would need to target 9.x / master or keep the names the same. Correct me if I'm wrong though.

@ryangjchandler we don't consider named arguments part of the public API: https://laravel.com/docs/8.x/releases#named-arguments

[ryangjchandler]

Thanks for clarifying @driesvints 🤗