{"id":5873,"date":"2026-04-08T13:17:34","date_gmt":"2026-04-08T16:17:34","guid":{"rendered":"https:\/\/thiagorossi.com.br\/blog\/?p=5873"},"modified":"2026-04-08T13:22:13","modified_gmt":"2026-04-08T16:22:13","slug":"rotas-no-cakephp","status":"publish","type":"post","link":"https:\/\/thiagorossi.com.br\/blog\/rotas-no-cakephp\/","title":{"rendered":"Rotas no CakePHP"},"content":{"rendered":"Tempo de leitura: <\/span> 5<\/span> minutos<\/span><\/span>\n

Rotas no CakePHP: A primeira impress\u00e3o de um site para um usu\u00e1rio \u2014 e para os motores de busca \u2014 n\u00e3o \u00e9 o design, mas a URL<\/strong>. Uma URL como meusite.com.br\/artigos\/visualizar\/1<\/code> \u00e9 funcional, mas meusite.com.br\/blog\/como-aprender-cakephp<\/code> \u00e9 profissional, leg\u00edvel e otimizada para SEO.<\/p>\n\n\n\n

Como especialista em CakePHP<\/strong>, preparei este d\u00e9cimo segundo artigo da nossa s\u00e9rie para ensinar voc\u00ea a dominar o Roteamento Avan\u00e7ado<\/strong>. Vamos transformar as rotas padr\u00e3o do framework em uma estrutura de URLs poderosa e personalizada, garantindo que seu projeto tenha a autoridade que ele merece.<\/p>\n\n\n\n

<\/div>\n\n\n\n

Roteamento Avan\u00e7ado: Criando URLs amig\u00e1veis e personalizadas no CakePHP<\/h2>\n\n\n\n

Rotas no CakePHP: No CakePHP, o sistema de roteamento \u00e9 o respons\u00e1vel por mapear uma requisi\u00e7\u00e3o HTTP (a URL que o usu\u00e1rio digita) para uma a\u00e7\u00e3o espec\u00edfica dentro de um Controller. Embora o framework j\u00e1 venha com rotas autom\u00e1ticas baseadas na conven\u00e7\u00e3o, o verdadeiro poder surge quando assumimos o controle do arquivo config\/routes.php<\/code>.<\/p>\n\n\n\n

Dominar o Roteamento Avan\u00e7ado<\/strong> permite que voc\u00ea crie slugs amig\u00e1veis, gerencie vers\u00f5es de APIs e proteja a estrutura interna das suas tabelas, escondendo IDs num\u00e9ricos e expondo apenas termos sem\u00e2nticos.<\/p>\n\n\n\n

<\/div>\n\n\n\n

1. A Anatomia de uma Rota no CakePHP<\/h2>\n\n\n\n

Antes de avan\u00e7armos, precisamos entender como uma rota \u00e9 declarada. O roteamento no CakePHP utiliza uma sintaxe fluida que conecta um “padr\u00e3o de URL” a um “destino”.<\/p>\n\n\n\n

O local onde toda essa configura\u00e7\u00e3o acontece \u00e9 o arquivo config\/routes.php<\/code>. Dentro do escopo de um RouteBuilder<\/code>, definimos nossas regras:<\/p>\n\n\n\n

PHP<\/p>\n\n\n\n

use Cake\\Routing\\RouteBuilder;\nuse Cake\\Routing\\Route\\DashedRoute;\n\n$routes->scope('\/', function (RouteBuilder $builder) {\n    \/\/ Rota padr\u00e3o para a Home\n    $builder->connect('\/', ['controller' => 'Paginas', 'action' => 'home']);\n    \n    \/\/ Rota personalizada\n    $builder->connect('\/contato', ['controller' => 'Contatos', 'action' => 'index']);\n    \n    $builder->fallbacks(DashedRoute::class);\n});\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
2. Criando URLs Amig\u00e1veis (Slugs)<\/h2>\n\n\n\n
Para um blog como o seu, usar o ID na URL (\/artigos\/view\/42<\/code>) \u00e9 p\u00e9ssimo para o SEO. O Google prioriza palavras-chave na URL. O objetivo \u00e9 chegar em \/blog\/titulo-do-artigo<\/code>.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Passo 1: Definindo a Rota com Par\u00e2metros<\/h3>\n\n\n\n
No seu arquivo de rotas, voc\u00ea pode definir que qualquer coisa ap\u00f3s \/blog\/<\/code> seja tratada como um par\u00e2metro chamado slug<\/code>:<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
$builder->connect('\/blog\/{slug}', \n    ['controller' => 'Artigos', 'action' => 'visualizar'],\n    ['_name' => 'artigo_view'] \/\/ Nomeando a rota para facilitar o uso no HtmlHelper\n)\n->setPatterns(['slug' => '[a-z0-9\\-]+']) \/\/ Regex para aceitar apenas letras, n\u00fameros e hifens\n->setPass(['slug']); \/\/ Passa o par\u00e2metro 'slug' diretamente para a fun\u00e7\u00e3o do Controller\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
Passo 2: Ajustando o Controller<\/h3>\n\n\n\n
Agora, seu Controller n\u00e3o busca mais pelo id<\/code>, mas pelo slug<\/code>:<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
public function visualizar($slug = null)\n{\n    $artigo = $this->Artigos->findBySlug($slug)->firstOrFail();\n    $this->set(compact('artigo'));\n}\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
3. Roteamento por Escopos (Scopes) e Prefixos<\/h2>\n\n\n\n
Se voc\u00ea est\u00e1 construindo um sistema SaaS ou um painel administrativo, voc\u00ea n\u00e3o quer que as URLs do administrador sejam misturadas com as do site p\u00fablico. O CakePHP resolve isso com Prefixos<\/strong>.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Configurando o Prefixo Admin<\/h3>\n\n\n\n
Imagine que voc\u00ea quer que todas as URLs que comecem com \/admin<\/code> apontem para controllers dentro de uma subpasta src\/Controller\/Admin\/<\/code>.<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
$builder->prefix('Admin', function (RouteBuilder $builder) {\n    \/\/ Agora as rotas aqui dentro apontam para o namespace App\\Controller\\Admin\n    $builder->connect('\/', ['controller' => 'Dashboards', 'action' => 'index']);\n    $builder->connect('\/usuarios', ['controller' => 'Usuarios', 'action' => 'listar']);\n    \n    $builder->fallbacks(DashedRoute::class);\n});\n<\/code><\/pre>\n\n\n\n
Isso organiza seu projeto de forma profissional:<\/p>\n\n\n\n