feat: new command shield:extend

[warcooft]

Description
This PRs provide a new command shield:extend to easily extend any controller.

The Command's Usage

shield:extend

The Command's Options

protected $options = [
        '-i' => 'The index of shield controllers to be extending in your app.',
        '-f' => 'Force overwrite ALL existing files in destination.',
    ];

Example:

this@PC playground % php spark shield:extend   

CodeIgniter v4.5.3 Command Line Tool - Server Time: 2024-07-09 05:32:31 UTC+07:00

List of the controller that will be extend:

  [1] LoginController
  [2] MagicLinkController
  [3] RegisterController

Please select one of these (1/2/3) : 3

  Created: APPPATH/Controllers/RegisterController.php
  After extending, don't forget to change the route. See https://shield.codeigniter.com/customization/route_config

Example when the controller already exists:

this@PC playground % php spark shield:extend        

CodeIgniter v4.5.3 Command Line Tool - Server Time: 2024-07-09 05:30:57 UTC+07:00

List of the controller that will be extend:

  [1] LoginController
  [2] MagicLinkController
  [3] RegisterController

Please select one of these (1/2/3) : 3
  File 'APPPATH/Controllers/RegisterController.php' already exists in destination. Overwrite? [n, y]: y

  Created: APPPATH/Controllers/RegisterController.php
  After extending, don't forget to change the route. See https://shield.codeigniter.com/customization/route_config

Or we can use the full option as below:

this@PC playground % php spark shield:extend -i 3 -f

CodeIgniter v4.5.3 Command Line Tool - Server Time: 2024-07-09 05:27:18 UTC+07:00


  Created: APPPATH/Controllers/RegisterController.php
  After extending, don't forget to change the route. See https://shield.codeigniter.com/customization/route_config

Checklist:

• Securely signed commits
• Component(s) with PHPDoc blocks, only if necessary or adds value
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide

[kenjis]

Why do you need to have examples?
I think we should avoid maintaining both the original controller and the controller in Examples.

[warcooft]

I created an example to provide a simple way to create an extended controller because in some cases we need to customize the controller. I did not copy all the methods from the source, only some parts that most likely need to be modified.

This is quite helpful for novice users like me, if you guys do not agree with this way, feel free to close this PRs.

[kenjis]

Also, please fix errors in GitHub Action checks, and add test code.
Reference: https://github.com/codeigniter4/CodeIgniter4/blob/develop/contributing/pull_request.md