Laravel Pint: Como Padronizar Seu Código com Qualidade Profissional

Manter a padronização do código é um dos pilares da qualidade em projetos de software. Em times de desenvolvimento, essa prática evita conflitos desnecessários em pull requests e torna o código mais legível, escalável e fácil de manter.

No universo Laravel, surgiu uma ferramenta oficial que facilita esse processo de forma elegante: o Laravel Pint.

Neste artigo, você vai aprender como o Laravel Pint funciona, por que ele é tão importante, como instalá-lo, configurá-lo e aplicá-lo em seus projetos para alcançar um nível profissional de organização.

O que é o Laravel Pint?

O Laravel Pint é uma ferramenta de formatação automática de código, desenvolvida oficialmente pela equipe do Laravel. Ele utiliza como base o PHP-CS-Fixer, mas oferece uma configuração simplificada e otimizada para projetos Laravel e PHP modernos.

Sua missão é simples: garantir que todo o seu código siga um padrão de estilo uniforme, automaticamente.

Por que usar o Laravel Pint?

Aqui estão alguns motivos para adotá-lo no seu fluxo de desenvolvimento:

• Evita divergências de estilo entre membros da equipe;
• Facilita revisões de código;
• Torna o código mais limpo e fácil de manter;
• Automatiza a formatação, poupando tempo com ajustes manuais;
• Padroniza a base de código desde o início do projeto.

Como instalar o Laravel Pint

A instalação é simples e rápida. Basta executar:

composer require laravel/pint --dev

Depois disso, você poderá rodar o comando:

./vendor/bin/pint

Esse comando varre seu projeto e formata todos os arquivos PHP com base nas regras padrão.

Configurando o Laravel Pint

Por padrão, o Pint já vem configurado com boas práticas. No entanto, é possível personalizar as regras criando um arquivo chamado pint.json na raiz do projeto:

{
  "preset": "laravel",
  "rules": {
    "array_syntax": { "syntax": "short" },
    "binary_operator_spaces": { "default": "align_single_space_minimal" }
  },
  "exclude": [
    "storage",
    "vendor"
  ]
}

Você pode optar por presets prontos como:

• laravel (padrão)
• psr12
• symfony

Como rodar o Laravel Pint no projeto

Com o Pint instalado, você pode executá-lo sempre que quiser formatar o código:

./vendor/bin/pint

Ou se preferir, adicione um script no composer.json para facilitar:

"scripts": {
  "format": "pint"
}

Agora, basta rodar:

composer format

Automatizando com Git Hooks

Quer garantir que todo push ou commit tenha o código formatado? Use o Husky ou o pacote CaptainHook para integrar o Pint com seus Git Hooks.

Exemplo com Husky:

npx husky-init && npm install
npx husky add .husky/pre-commit "composer format"

Com isso, todo commit irá formatar automaticamente o seu código.

Antes e Depois do Laravel Pint

Antes:

public function store(Request $request){$data=$request->all();User::create($data);}

Depois:

public function store(Request $request)
{
    $data = $request->all();
    User::create($data);
}

Simples, organizado e elegante.

Benefícios em times de desenvolvimento

• Reduz conflitos de merge causados por espaçamento e estilo;
• Garante consistência em todo o projeto, independentemente do programador;
• Melhora a experiência durante code reviews;
• Aumenta a produtividade eliminando discussões sobre formatação.

O Laravel Pint é mais do que uma ferramenta de formatação: é um aliado da produtividade e da qualidade de código. Seja em projetos pessoais ou em equipes grandes, usá-lo pode elevar o padrão da sua base de código e otimizar seu fluxo de trabalho.

📣 E agora, é sua vez!

Já está usando o Laravel Pint no seu projeto?

Compartilhe sua experiência nos comentários ou envie este post para aquele colega de equipe que sempre esquece de alinhar o código!