Annotations Router to use patterns as prefix

[zsilbi]

Hello!

• Type: performance tuning

In raising this pull request, I confirm the following:

• I have read and understood the Contributing Guidelines
• I have checked that another pull request for this purpose does not exist
• I wrote some tests for this PR
• I have updated the relevant CHANGELOG
• I have created a PR for the documentation about this change

To use Mvc\Router\Annotations, you have to add the resources that you want it to parse.
You can assign a prefix for every resource for faster handling.

$di->setShared(
     "router",
     function() {
         // Use the annotations router
         $router = new Annotations(false);

         // This will do the same as above but only if the handled uri starts with /robots
         $router->addResource("Robots", "/robots");

        return $router;
     }
);

Adding controllers with distinct prefixes will work great, even in a huge a project.

If you don't use prefixes, it will basicly need to check and parse every resource that you added. It will be a bit slow but will work good enough for small projects.

However, if you have a lot of controllers with prefixes that have parameters or placeholders in the beginning, you won't be able to use them.

For example if you have 75 controllers with prefixes like this:

• /clients/{clientId:[0-9]+}/
• /clients/{clientId:[0-9]+}/robots
• /clients/{clientId:[0-9]+}/parts
• ...

In this case, only the /clients prefix can be used for all the 75 controllers.

In my test runs, I used a total of 150 resources, 75 with the same prefix and the average route handling time was over 50ms. Without using any prefixes, it was around 90ms.

My idea would be to compile the prefixes as standard route patterns, so you could pass any type of pattern as a prefix along with your resource to the Router.

I repeated the same tests using this code, and my average route handling time was around 3ms which I find somewhat acceptable.

Thanks,
zsilbi

[ruudboon]

If you rebase probably your mysql will build again.

[codecov]

Codecov Report

Merging #14259 into 4.0.x will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##            4.0.x   #14259   +/-   ##
=======================================
  Coverage   67.78%   67.78%           
=======================================
  Files         478      478           
  Lines      112862   112921   +59     
=======================================
+ Hits        76506    76546   +40     
- Misses      36356    36375   +19

[niden]

Thank you @zsilbi