Roteamento e reescrita de URLs

Da URL ao controlador

Route::parseURI() decompõe a URL sem necessidade de declarar rotas:

1. Converte tudo para minúsculas e troca - por _ (/reset-password → reset_password).
2. Se o primeiro segmento for admin e houver mais segmentos, remove-o e marca a rota como do painel (buscada em Controllers/Admin/).
3. Se o próximo segmento for o nome de um plugin ativo, remove-o e busca os controladores em plugins/<plugin>/src/Controllers/.
4. Enquanto os segmentos coincidirem com subpastas de Controllers/, são consumidos como pasta.
5. O que sobra é controlador/ação/argumentos….

Os argumentos chegam como parâmetros da ação, em ordem:

public function ver($id = null, $color = null) {
    $producto = TMProductos::find(intval($id));
    if (!$producto) {
        $this->Response->setCode(404);
        return;
    }
    $this->set(['producto' => $producto]);
}

Parâmetros especiais

• ?action=nome na query string (ou no POST) substitui a ação da URL.
• ?subaction=nome fica disponível em Route::get()['subaction'].

Consultar a rota atual

$route = Route::get();
// ['uri'=>'productos/ver/15', 'qs'=>'', 'plugin'=>'', 'controller'=>'Productos',
//  'action'=>'ver', 'raw_action'=>'ver', 'arguments'=>['15']]

Route::getDomain();     // 'https://meusite.com'
Route::setAction('outra');

Arquivos estáticos de plugins

Se a URL começa com o nome de um plugin e termina em .js, .css, .map ou uma extensão de imagem, o Koshkil entrega o arquivo diretamente de plugins/<plugin>/webroot/. Um .js que não existe como arquivo é tratado como a ação javascript do controlador, útil para gerar JavaScript a partir do PHP.

Regras de reescrita

Para URLs que não seguem a convenção, defina regras em config/rewrite.php (ou no do domínio) em System.Web.Rewrite. Elas são avaliadas antes do roteamento, em ordem, contra a URL sem a barra inicial.

<?php
$CONFIG = [
    'System' => [
        'Web' => [
            'Rewrite' => [
                // /negocios/padaria-lopes  ->  /negocios?nombre=padaria-lopes
                ['rule' => '^negocios/([a-z\-0-9]*)$', 'target' => '/negocios?nombre=$1', 'flags' => 'L,NC'],
                // apelido de uma seção do painel
                ['rule' => '^admin/usuarios/(editar|listado)$', 'target' => '/admin/sistema/usuarios/$1?subusuarios=1', 'flags' => 'L,NC'],
            ],
        ],
    ],
];

As regras também podem ser adicionadas por código, antes do roteamento:

RewriteManager::addRule('^ofertas$', '/productos/listado?oferta=1', 'L,NC');
RewriteManager::addRule('^promo$', '/productos/promo', 'L', true); // true: no início

Os plugins declaram suas regras em plugins/<plugin>/config/rewrite.php (array $RULES), adicionadas depois das globais. Com Debug.Rewrite em 5 ou mais, cada avaliação é registrada em tmp/logs/rewrite.log.

Gerar links

Nunca escreva caminhos absolutos à mão: o projeto pode estar em uma subpasta.

<a href="{Koshkil::getLink('/productos/ver/'|cat:$producto->prd_codigo)}">Ver</a>
<link rel="stylesheet" href="{Koshkil::getThemePath('css/theme.css')}">