{"id":5867,"date":"2026-04-07T19:10:34","date_gmt":"2026-04-07T22:10:34","guid":{"rendered":"https:\/\/thiagorossi.com.br\/blog\/?p=5867"},"modified":"2026-04-07T19:14:29","modified_gmt":"2026-04-07T22:14:29","slug":"relacionando-tabelas-no-cakephp","status":"publish","type":"post","link":"https:\/\/thiagorossi.com.br\/blog\/relacionando-tabelas-no-cakephp\/","title":{"rendered":"Relacionando tabelas no CakePHP"},"content":{"rendered":"Tempo de leitura: <\/span> 5<\/span> minutos<\/span><\/span>\n

Relacionando tabelas no CakePHP: Chegamos a um dos pilares mais poderosos do CakePHP<\/strong>. Se voc\u00ea j\u00e1 entende a diferen\u00e7a entre Tables e Entities, agora precisa aprender como conect\u00e1-las. No mundo real, os dados n\u00e3o vivem isolados; um artigo pertence a uma categoria, um autor possui muitos posts e um produto pode ter v\u00e1rias etiquetas.<\/p>\n\n\n\n

Como especialista em desenvolvimento web, preparei este d\u00e9cimo artigo para ensinar voc\u00ea a dominar as Associa\u00e7\u00f5es<\/strong> no ORM do CakePHP. Esque\u00e7a as JOINs manuais complexas no SQL; vamos aprender a relacionar tabelas como um verdadeiro profissional, garantindo integridade e performance ao seu blog ou SaaS.<\/p>\n\n\n\n

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

Associa\u00e7\u00f5es (HasMany, BelongsTo): Relacionando tabelas como um profissional no CakePHP<\/h2>\n\n\n\n

Relacionando tabelas no CakePHP: No desenvolvimento de sistemas, a modelagem de dados \u00e9 o que define o sucesso da aplica\u00e7\u00e3o. O CakePHP brilha nesse aspecto ao oferecer uma camada de abstra\u00e7\u00e3o que permite definir relacionamentos complexos com apenas algumas linhas de c\u00f3digo. Atrav\u00e9s das Associa\u00e7\u00f5es<\/strong>, o framework entende como navegar entre as tabelas, buscando dados relacionados de forma autom\u00e1tica e inteligente.<\/p>\n\n\n\n

Neste artigo, vamos focar nos dois tipos de associa\u00e7\u00f5es mais comuns: BelongsTo<\/strong> (Pertence a) e HasMany<\/strong> (Tem muitos), al\u00e9m de dar uma pincelada no HasOne<\/strong> e BelongsToMany<\/strong>.<\/p>\n\n\n\n

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

1. O que s\u00e3o Associa\u00e7\u00f5es no ORM?<\/h2>\n\n\n\n

Associa\u00e7\u00f5es s\u00e3o defini\u00e7\u00f5es l\u00f3gicas no seu Table Object<\/strong> que dizem ao CakePHP como uma tabela se conecta a outra. Quando voc\u00ea define um relacionamento, o ORM ganha “superpoderes” para realizar consultas recursivas.<\/p>\n\n\n\n

Por exemplo, se voc\u00ea buscar um “Artigo”, o CakePHP pode trazer automaticamente a “Categoria” ligada a ele e tamb\u00e9m todos os “Coment\u00e1rios” que aquele artigo recebeu. Tudo isso sem que voc\u00ea precise escrever uma \u00fanica linha de SQL JOIN<\/code>.<\/p>\n\n\n\n

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

2. BelongsTo: O Relacionamento “Filho para Pai”<\/h2>\n\n\n\n

A associa\u00e7\u00e3o BelongsTo<\/strong> \u00e9 usada quando a tabela atual cont\u00e9m a chave estrangeira (foreign key<\/code>) que aponta para outra tabela. \u00c9 o caso cl\u00e1ssico de um Artigo que pertence a uma Categoria.<\/p>\n\n\n\n

A Conven\u00e7\u00e3o:<\/strong> Para que o CakePHP identifique isso automaticamente, sua tabela artigos<\/code> deve ter uma coluna chamada categoria_id<\/code>.<\/p>\n\n\n\n

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

Configurando no Table Object (ArtigosTable.php<\/code>)<\/h3>\n\n\n\n

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

namespace App\\Model\\Table;\n\nuse Cake\\ORM\\Table;\n\nclass ArtigosTable extends Table \n{\n    public function initialize(array $config): void\n    {\n        parent::initialize($config);\n\n        \/\/ Um Artigo pertence a uma Categoria\n        $this->belongsTo('Categorias', [\n            'foreignKey' => 'categoria_id',\n            'joinType' => 'INNER', \/\/ Garante que s\u00f3 traga artigos que tenham categoria\n        ]);\n    }\n}\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
O que isso faz na pr\u00e1tica?<\/strong><\/p>\n\n\n\n
Quando voc\u00ea estiver no seu ArtigosController<\/code> e fizer uma busca usando o m\u00e9todo contain<\/code>, o CakePHP trar\u00e1 o objeto da categoria dentro da entidade do artigo:<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
$artigo = $this->Artigos->find()\n    ->contain(['Categorias'])\n    ->first();\n\necho $artigo->categoria->nome; \/\/ A m\u00e1gica acontece aqui!\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
3. HasMany: O Relacionamento “Pai para Filhos”<\/h2>\n\n\n\n
A associa\u00e7\u00e3o HasMany<\/strong> \u00e9 o inverso da anterior. Ela \u00e9 definida na tabela que “\u00e9 dona” da rela\u00e7\u00e3o, ou seja, na tabela que n\u00e3o<\/strong> tem a chave estrangeira. Uma Categoria tem muitos Artigos.<\/p>\n\n\n\n
<\/div>\n\n\n\n
Configurando no Table Object (CategoriasTable.php<\/code>)<\/h3>\n\n\n\n
PHP<\/p>\n\n\n\n
namespace App\\Model\\Table;\n\nuse Cake\\ORM\\Table;\n\nclass CategoriasTable extends Table \n{\n    public function initialize(array $config): void\n    {\n        parent::initialize($config);\n\n        \/\/ Uma Categoria possui muitos Artigos\n        $this->hasMany('Artigos', [\n            'foreignKey' => 'categoria_id',\n            'dependent' => true, \/\/ Se deletar a categoria, deleta os artigos (opcional)\n            'cascadeCallbacks' => true,\n        ]);\n    }\n}\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
Resultado:<\/strong><\/p>\n\n\n\n
Ao buscar uma Categoria, voc\u00ea pode listar todos os seus artigos de uma vez:<\/p>\n\n\n\n
PHP<\/p>\n\n\n\n
$categoria = $this->Categorias->get($id, ['contain' => ['Artigos']]);\n\nforeach ($categoria->artigos as $artigo) {\n    echo $artigo->titulo;\n}\n<\/code><\/pre>\n\n\n\n
<\/div>\n\n\n\n
4. Diferen\u00e7a entre HasOne e BelongsTo<\/h2>\n\n\n\n
Muitos desenvolvedores confundem esses dois. A regra de ouro para nunca mais errar \u00e9 olhar onde est\u00e1 a chave estrangeira<\/strong>:<\/p>\n\n\n\n