Скачать rc router - rc router скачать исходный код

Что это?

Это rc router . Это простой маршрутизатор на основе регулярных выражений, который позволяет передавать переменные, используя заполнители в вашем маршруте.

Зачем писать это?

Я сделал это, чтобы размять свой мозг и получить полное представление о том, как работает маршрутизация в пространстве PHP. Вместо того, чтобы просто читать об этом и предполагать, что я знаю, что и что делает, я написал это, чтобы закрепить свои знания.

Установка пакета

Просто используйте композитор:

 composer require robert430404/rc-router

Как это работает?

Это пакет композитора, поэтому он использует композитор для автоматической загрузки классов. Затем вы создаете новый экземпляр объекта Router() и начинаете назначать ему маршруты. После определения маршрутов вы передаете Router() в Resolver(), и он обрабатывает ваши маршруты.

 <?php

use RcRouter  Router ;
use RcRouter  Utilities  Resolver ;
use RcRouter  Exceptions  RouteNotFoundException ;

include ' vendor/autoload.php ' ;

$ router = new Router ();

$ router -> request ([ ' GET ' ], ' / ' , function () {
    echo ' Closure Handler Test ' ;
});

$ uri    = $ _SERVER [ ' REQUEST_URI ' ];    // You do not have to use globals here if you have access to a different source.
$ method = $ _SERVER [ ' REQUEST_METHOD ' ]; // You simply need to pass these (uri and method) as strings to the Resolver.

try {
    new Resolver ( $ uri , $ method , $ router );
} catch ( RouteNotFoundException $ e ) {
    echo ' 404 not found ' ;
}

Каковы некоторые особенности?

Маршрутизатор поддерживает как строковые, так и целочисленные переменные URL-адреса и передает их вам в массиве. Вы можете расширить это дальше любым удобным для вас способом. Маршрутизатор очень гибок в использовании.

Вы можете передать замыкание или именованную функцию-обработчик каждому маршруту, чтобы контролировать, что происходит при совпадении маршрута.

Если маршрут не найден, преобразователь генерирует исключение RouteNotFoundException, которое позволяет вам перехватить и затем создать обработчик 404.

Теперь вы также можете написать свои собственные синтаксические анализаторы и передать их в преобразователь, чтобы сделать реализацию таких вещей, как вызов Controller@Action, намного проще и понятнее.

 <?php

use RcRouter  Router ;
use RcRouter  Utilities  Resolver ;
use RcRouter  Exceptions  RouteNotFoundException ;
use YourProject  Routing  CustomParser ;

include ' vendor/autoload.php ' ;

$ router = new Router ();

$ router -> request ([ ' GET ' ], ' / ' , function () {
    echo ' Closure Handler Test ' ;
});

$ uri    = $ _SERVER [ ' REQUEST_URI ' ];    // You do not have to use globals here if you have access to a different source.
$ method = $ _SERVER [ ' REQUEST_METHOD ' ]; // You simply need to pass these (uri and method) as strings to the Resolver.

try {
    new Resolver ( $ uri , $ method , $ router , new CustomParser ());
} catch ( RouteNotFoundException $ e ) {
    echo ' 404 not found ' ;
}

Если вы не передадите собственный синтаксический анализатор, по умолчанию будет использоваться встроенный парсер.

Как работают заполнители?

Если в вашем маршруте есть заполнители, они возвращаются вам в виде массива, к которому вы можете получить доступ в своем обработчике.

У вас есть доступ к заполнителям строк. Когда вы определяете свои маршруты, вы используете {} для определения заполнителей строк следующим образом:

 <?php

$ router -> request ([ ' GET ' ], ' /{placeholder} ' , function ( $ mapped ) {
    // Deal with returned data and route response here.
});

У вас также есть доступ к целочисленным заполнителям. Когда вы определяете свой маршрут, вы используете {:i} для определения целочисленных заполнителей следующим образом:

 <?php

$ router -> request ([ ' GET ' ], ' /{placeholder:i} ' , function ( $ mapped ) {
    // Deal with returned data and route response here.
});

Некоторые примеры

Простой маршрут на основе закрытия:

 <?php

use RcRouter  Router ;
use RcRouter  Utilities  Resolver ;
use RcRouter  Exceptions  RouteNotFoundException ;

include ' vendor/autoload.php ' ;

$ router = new Router ();

$ router -> request ([ ' GET ' ], ' / ' , function () {
    echo ' Closure Handler Test ' ;
});

$ uri    = $ _SERVER [ ' REQUEST_URI ' ];    // You do not have to use globals here if you have access to a different source.
$ method = $ _SERVER [ ' REQUEST_METHOD ' ]; // You simply need to pass these (uri and method) as strings to the Resolver.

try {
    new Resolver ( $ uri , $ method , $ router );
} catch ( RouteNotFoundException $ e ) {
    echo ' 404 not found ' ;
}

Простой маршрут с именованным обработчиком:

 <?php

use RcRouter  Router ;
use RcRouter  Utilities  Resolver ;
use RcRouter  Exceptions  RouteNotFoundException ;

include ' vendor/autoload.php ' ;

$ router = new Router ();

$ router -> request ([ ' GET ' ], ' / ' , ' handler ' );

$ uri    = $ _SERVER [ ' REQUEST_URI ' ];    // You do not have to use globals here if you have access to a different source.
$ method = $ _SERVER [ ' REQUEST_METHOD ' ]; // You simply need to pass these (uri and method) as strings to the Resolver.

try {
    new Resolver ( $ uri , $ method , $ router );
} catch ( RouteNotFoundException $ e ) {
    echo ' 404 not found ' ;
}

function handler ()
{
    echo ' External Handler Test ' ;
}

Маршрут на основе закрытия Regex с переменными:

 <?php

use RcRouter  Router ;
use RcRouter  Utilities  Resolver ;
use RcRouter  Exceptions  RouteNotFoundException ;

include ' vendor/autoload.php ' ;

$ router = new Router ();

$ router -> request ([ ' GET ' ], ' /{id:i}/{post:i} ' , function ( $ mapped ) {
    echo ' <pre> ' ;
    var_dump ( $ mapped );
    echo ' </pre> ' ;

    echo ' Route Found ' ;
});

$ uri    = $ _SERVER [ ' REQUEST_URI ' ];    // You do not have to use globals here if you have access to a different source.
$ method = $ _SERVER [ ' REQUEST_METHOD ' ]; // You simply need to pass these (uri and method) as strings to the Resolver.

try {
    new Resolver ( $ uri , $ method , $ router );
} catch ( RouteNotFoundException $ e ) {
    echo ' 404 not found ' ;
}

Маршрут Regex с переменными и внешним обработчиком:

 <?php

use RcRouter  Router ;
use RcRouter  Utilities  Resolver ;
use RcRouter  Exceptions  RouteNotFoundException ;

include ' vendor/autoload.php ' ;

$ router = new Router ();

$ router -> request ([ ' GET ' ], ' /{id:i}/{post:i} ' , ' handler ' );

$ uri    = $ _SERVER [ ' REQUEST_URI ' ];    // You do not have to use globals here if you have access to a different source.
$ method = $ _SERVER [ ' REQUEST_METHOD ' ]; // You simply need to pass these (uri and method) as strings to the Resolver.

try {
    new Resolver ( $ uri , $ method , $ router );
} catch ( RouteNotFoundException $ e ) {
    echo ' 404 not found ' ;
}

function handler ( $ mapped )
{
    echo ' <pre> ' ;
    var_dump ( $ mapped );
    echo ' </pre> ' ;
    
    echo ' Route Found ' ;
}

Что находится в возвращаемых значениях?

Переменная «$mapped» возвращает подобную структуру:

 <?php

$ mapped = [
    ' all ' => [
        ' id '   => 0 ,
        ' name ' => ' Robert '
    ],
    ' int ' => [
        ' id ' => 0
    ],
    ' string ' => [
        ' name ' => ' Robert '
    ],
];