Download the PHP package hnrazevedo/router without Composer
On this page you can find all versions of the php package hnrazevedo/router. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download hnrazevedo/router
More information about hnrazevedo/router
Files in hnrazevedo/router
Package router
Short Description Router is a simple friendly URL abstractor.
License MIT
Informations about the package router
# Router @HnrAzevedo
Router is a simple friendly URL abstractor. It can be used in an easy and practical way, either individually in a static way, or together as a middleware and now as an attribute with PHP 8. Its author is not a professional in the development area, just someone in the Technology area who is improving their knowledge.
O Router é um simples abstrator de URL amigável. Ele pode ser utilizada de maneira fácil e prática, tanto individualmente de forma estática, quanto em conjunto como middleware e agora como atributo com o PHP 8. Seu autor não é um profissional da área de desenvolvimento, apenas alguem da área de Tecnologia que está aperfeiçoando seus conhecimentos.
Highlights
- Easy to set up (Fácil de configurar)
- Easy information caching (Fácil cacheamento de informações)
- Follows standard PSR-15 (Segue padrão o PSR-15)
- Composer ready (Pronto para o composer)
Installation
Router is available via composer.json:
or in at terminal
Configure server
Nginx
nginx.conf
Apache
.htaccess
Documentation
For more details on the use and configuration of the Router, see the example folder with details on component targeting
Para mais detalhes sobre a utilização e configuração do Router, veja a pasta de exemplos com detalhes no diretório do componente
Errors
In the static use of the Router, if an inexistent page error is returned, an Exception will be thrown
When used as middleware, a 404 response is returned
Na utilização estática do Router, caso retorne erro de página inexistente, será lançada uma Exception Na utilização como middleware, é retornado uma resposta 404
Access methods
Available protocols
- get: URL access or get method
- post: post method
- ajax: called fetch or XMLHttpRequest
Ajax
To use the Ajax call, it is necessary to define REQUEST_METHOD as AJAX:
Para utilizar a chamada Ajax, é necessário a definição do REQUEST_METHOD como AJAX:
REST request
- post: REST request
- get: REST request
- put: REST requests
- delete: REST requests
- patch: REST requests
Router Attributes
Attribute routing works the same as role routing, with just a few caveats:
- Groups are not supported;
- Pre and post functions do not support anonymous functions;
- You must declare the classes with routes in a pipeline and load it with the router.
Both means of declaring routes can be used together.
O roteamento por atributo funciona da mesma forma que o roteamento por função, apenas com algumas resalvas:
- Não há suporte para grupos;
- As funções anteriores e posteriores não tem suporte à funções anônimas;
- Deve-se declarar as classes com rotas em uma pipeline e carrega-la com o roteador.
Ambos os meios de declaração de rotas podem ser usados em conjunto.
Example:
It is necessary to load the classes with routes in the same way as the route declaration files, it is interesting for both methods that the loading is done directly by composer.
Loading can be done directly with a class or with the directory.
É necessário fazer o carregamento das classes com rotas da mesma forma que os arquivos de declarações de rota, é interessante para ambos os métodos, que o carregamento seja feito diretamente pelo composer.
O carregamento pode ser feito diretamente com uma class ou com o diretório
Router methods
get
post
ajax
middleware
name
Defines a name for the route, if you want to call dynamically by name
attribute
Defines attributes to route, to be used dynamically
Returning an attribute
Returning all attributes
before
Runs before starting the work of the accessed route
after
Executes after completing the work of the accessed route
beforeAll
Runs before work on any route
NOTE: execute the beforeAll method before the before method
after All
Runs after completing work on any route
NOTE: execute the afterAll method before the after method
group
Set the group to use a common filter or before/after methods
groupAttribute
Defines attributes on all routes in the group
NOTE:If the attribute has already been defined directly on the route, it will be disregarded here
groupMiddlewares
Defines middleware for all group members
beforeGroup | afterGroup
Defines actions to be taken before and after any group member is triggered
REST
Parameters
Optional parameters
Regular Expression Constraints
Route definition
Protocols
Current route
load
run
Cache
Example of caching in SESSION
Definition order
Routing loading is a priority with static routes (without parameters)
O carregamento das rotas é prioritário com as rotas estáticas (sem paramêtros)
Support
Security: If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Se você descobrir algum problema relacionado à segurança, envie um e-mail para [email protected] em vez de usar o rastreador de problemas.
Credits
- Henri Azevedo (Developer)
License
The MIT License (MIT). Please see License File for more information.