[12.x] Allow migrate:status command to filter by status (Ran, Pending, Skipped)

[ziadoz]

This PR allows migrations to be filtered by status (Ran, Pending or Skipped) in the migrate:status command via a new --status flag.

This is handy now that Laravel allows migrations to be skipped: #55011

---

The command now distinguishes between Pending and Skipped:

❯ php artisan migrate:status 

  Migration name .......................................................... Batch / Status  
  0001_01_01_000000_foo .......................................................... [1] Ran  
  0001_01_01_000001_bar .......................................................... Pending  
  0001_01_01_000002_baz .......................................................... Skipped 

The command can be filtered using --status:

❯ php artisan migrate:status --status=pending --status=skipped

  Migration name .......................................................... Batch / Status  
  0001_01_01_000001_bar .......................................................... Pending  
  0001_01_01_000002_baz .......................................................... Skipped

The existing --pending flag is deprecated, but still works as before. It includes Pending and Skipped migrations, to avoid any breaking changes:

❯ php artisan migrate:status --pending

  Migration name .......................................................... Batch / Status  
  0001_01_01_000001_bar .......................................................... Pending  
  0001_01_01_000002_baz .......................................................... Skipped

Also, the command was supposed to return a status code when --pending was used, however that code would never trigger, because $this->option('pending') returns null or false. I've adjusted this so now the return code is 1 (matches) or 0 (no matches), which I assume was the intention.

[github-actions]

Thanks for submitting a PR!

Note that draft PR's are not reviewed. If you would like a review, please mark your pull request as ready for review in the GitHub user interface.

Pull requests that are abandoned in draft may be closed due to inactivity.

[taylorotwell]

Thanks for your pull request to Laravel!

Unfortunately, I'm going to delay merging this code for now. To preserve our ability to adequately maintain the framework, we need to be very careful regarding the amount of code we include.

If applicable, please consider releasing your code as a package so that the community can still take advantage of your contributions!

[ziadoz]

@taylorotwell Would a simpler PR that only adds the Skipped status, perhaps as Pending (Skipped), in the output be more acceptable?