[5.4] Support numeric arguments in break and continue

[michaeltintiuc]

Description

As per the PHP documentation

break accepts an optional numeric argument which tells it how many nested enclosing structures are to be broken out of. The default value is 1, only the immediate enclosing structure is broken out of.

Usage

To break out of 2 nested loops:

@break(2) compiles to break 2;

Compatibility

• Previous expressions like ($user->id == 2) are supported
• Checks for formatting with varying white-space: @continue( 2 ) compiles to continue 2;
• Check the minimum amount of structures to break out of: 1

[michaeltintiuc]

Implementing a similar feature in versions 5.2+ is trivial, would be my pleasure to do so.

[michaeltintiuc]

Just to make it a bit more clear:

@foreach ($users as $user)
    @foreach($user->posts as $post)
        @if ($post->id == 1)
            @php
                break 2;
            @endphp
        @endif
    @endforeach
@endforeach

Now becomes:

@foreach ($users as $user)
    @foreach($user->posts as $post)
        @if ($post->id == 1)
            @break(2)
        @endif
    @endforeach
@endforeach

I could also write some tests if there is a need for such.

[taylorotwell]

Can you provide tests?

[michaeltintiuc]

@taylorotwell Will do. Would you like a test for each case? For example:

• @break(2)
• @break( 2)
• @break( 2 )
• @break(2 )

[michaeltintiuc]

@taylorotwell Please, have a look and let me know if there's anything I might've missed.