API Route Auto Discovery

[johntrickett86]

This PR introduces a new feature to the laravel-orion package that enables automatic route discovery and registration. This eliminates the need to manually register routes for each controller, making the package more convenient to use and reducing boilerplate code.

This is something that I found I was implementing on my own projects so I could move quickly when building simple APIs.

Key Features

• Automatic Controller Discovery: The package now automatically scans specified directories for controllers and registers their routes.
• Configurable Paths: You can specify which directories to scan for controllers in the config file.
• Opt-out Mechanism: Controllers can opt out of automatic route discovery by using the DisableRouteDiscovery trait.
• Customizable Route Configuration: Controllers can customize their route prefix, middleware, and other settings.

Implementation Details

• Added HandlesRouteDiscovery trait to provide route registration functionality
• Added DisableRouteDiscovery trait to allow controllers to opt out
• Updated BaseController to include the route discovery functionality
• Enhanced OrionServiceProvider to discover and register controllers
• Added configuration options in config/orion.php

If you believe this would be a useful feature, then I would be happy to submit a PR to the docs to update.

[johntrickett86]

Just to note: the use of the switch expression in the HandlesRouteDiscovery trait made me sick in my mouth a bit, but as the minimum supported PHP version is pre version 8.0, using a match statement was not possible!

[johntrickett86]

@alexzarbn Let me know your thoughts