powered byiMasterstutoriais · referência · código em portuguêsPatrocínio
PHP

Symfony 8.2 adiciona locks de aviso nativos para MySQL e MariaDB

A versão 8.2 do componente Lock leva os advisory locks, até então exclusivos do PostgreSQL, para MySQL e MariaDB, além de deixar o FlockStore mais enxuto em disco.

Por Thiago VilelaColunista6 min de leitura
Imagem gerada por IA

A versão 8.2 do componente Lock leva os advisory locks, até então exclusivos do PostgreSQL, para MySQL e MariaDB, além de deixar o FlockStore mais enxuto em disco.

Ao final deste texto você vai saber configurar locks de aviso (advisory locks) em MySQL e MariaDB no componente Lock do Symfony, reaproveitar uma conexão de banco já existente em vez de abrir outra só para travas, e evitar que o diretório de locks baseados em arquivo acumule milhares de arquivos órfãos. Os exemplos abaixo foram escritos para symfony/lock ^8.2, anunciados no blog oficial do Symfony em 19 de novembro de 2026.

Como o Lock resolvia isso antes

O componente Lock sempre serviu para garantir acesso exclusivo a um recurso compartilhado, seja um arquivo, um registro de pedido ou uma fila de processamento. Ele faz isso através de stores: arquivos (FlockStore), Redis, semáforos ou banco de dados (PdoStore, DoctrineDbalStore).

O problema dos stores baseados em banco é que eles gravam a trava numa tabela e dependem de um TTL (tempo de vida) para liberar locks de processos que travaram ou morreram no meio do caminho. Isso significa escolher um TTL, estimar se ele é longo o suficiente para a tarefa e, em processos demorados, renovar o lock manualmente para ele não expirar antes da hora.

O PostgreSQL já fugia dessa lógica: o banco oferece advisory locks, travas que o próprio servidor gerencia em memória, atreladas à conexão, sem precisar de tabela e liberadas automaticamente quando a conexão cai. O Symfony já suportava esse mecanismo para PostgreSQL. Em MySQL e MariaDB, até a versão 8.1, a única opção era o modelo com tabela e TTL.

MySQL e MariaDB ganham locks de aviso

A contribuição de Ryan Pon (PRs #64757 e #64987) adiciona dois stores novos baseados nos locks de usuário do MySQL: MysqlStore, que usa uma conexão PDO, e DoctrineDbalMysqlStore, que usa uma conexão Doctrine DBAL. A escolha entre um e outro depende só do esquema da DSN, com o sufixo +advisory:

yaml
# config/packages/lock.yaml
framework:
 # uma URL de Doctrine DBAL cria um DoctrineDbalMysqlStore
 lock: 'mysql+advisory://db_user:db_password@127.0.0.1:3306/app'

Uma DSN no formato PDO (mysql+advisory:host=127.0.0.1;dbname=app) cria um MysqlStore em vez do store de Doctrine. Em aplicações PHP standalone, sem o framework completo, dá para montar o store na mão:

php
use Symfony\Component\Lock\LockFactory;
use Symfony\Component\Lock\Store\MysqlStore;

$store = new MysqlStore('mysql:host=127.0.0.1;dbname=app', [
 'db_username' => 'db_user',
 'db_password' => 'db_password',
]);
$lock = new LockFactory($store)->createLock('invoice-' . $invoice->getId());

// espera o lock ficar livre, sem ficar consultando o banco em loop
$lock->acquire(blocking: true);

Dois detalhes práticos valem a pena anotar. Primeiro, os locks desses stores não expiram e suportam bloqueio nativo no banco, então some a preocupação com TTL e com renovar lock em tarefa longa. Segundo, eles exigem MySQL 5.7.5 ou MariaDB 10.0.2 ou mais recentes, e como o MySQL não tem locks de leitura compartilhados, chamar acquireRead() nesses stores sempre pega um lock exclusivo, igual a acquire().

Reaproveitando uma conexão que já existe

Até o Symfony 8.1, DSNs com +advisory sempre abriam uma conexão de banco própria, só para a trava. Se o lock apontava para o service_id de uma conexão já existente no container, o Symfony sempre caía no store baseado em tabela, mesmo em PostgreSQL. A contribuição de MD. Saiful Islam Feroz e Nicolas Grekas (PRs #65021 e #65098) fecha essa lacuna: agora o store pode ser um array com o service_id da conexão e a opção advisory: true.

yaml
# config/packages/lock.yaml
framework:
 lock:
 service_id: 'doctrine.dbal.lock_connection'
 advisory: true

O Symfony identifica o banco por trás dessa conexão (PostgreSQL, MySQL ou MariaDB) e escolhe o store certo sozinho, lançando uma exceção se o banco não tiver suporte a advisory locks. Em aplicações standalone, o segundo argumento da fábrica de stores faz o mesmo trabalho:

php
use Symfony\Component\Lock\Store\StoreFactory;

// precisa ser argumento posicional: "advisory: true" não funciona aqui
$store = StoreFactory::createStore($connection, true);

O próprio anúncio do Symfony traz um alerta que vale levar a sério em produção: um advisory lock pertence à sessão daquela conexão. Se ela cair ou reconectar, seja pelo middleware doctrine_close_connection do Messenger, seja por um timeout de ociosidade do servidor de banco, todos os locks daquela conexão somem sem nenhum aviso para a aplicação. Por isso o próprio exemplo do time Symfony usa uma conexão Doctrine dedicada, chamada lock, em vez da conexão padrão da aplicação. Em qualquer projeto que vá adotar isso, separar a conexão de lock da conexão de leitura e escrita normal evita perder uma trava no meio de uma operação crítica sem perceber.

Arquivos de flock que não acumulam mais

O FlockStore cria um arquivo por recurso travado e, até o Symfony 8.1, mantinha esse arquivo depois que o lock era liberado, para a próxima aquisição reaproveitar o mesmo arquivo. Isso é ótimo quando a aplicação trava sempre os mesmos nomes de recurso, mas vira problema em sistemas que travam um recurso diferente por pedido ou por usuário: o diretório de locks acumula milhares de arquivos que nunca mais saem dali.

A contribuição de Jérôme Tamarelle (PR #66526) adiciona a DSN flock+remove, que cria um FlockStore apagando o arquivo assim que um lock exclusivo é liberado:

yaml
# usa o mesmo diretório padrão do projeto, igual ao 'flock'
lock: 'flock+remove'

# ou aponte para o seu próprio diretório
lock: 'flock+remove:///path/to/locks'

Em PHP puro, o novo argumento removeOnRelease faz o mesmo:

php
use Symfony\Component\Lock\Store\FlockStore;

$store = new FlockStore('/path/to/locks', removeOnRelease: true);

O próprio anúncio já avisa do trade-off: apagar o arquivo deixa travar o mesmo recurso repetidamente mais lento, porque o arquivo precisa ser recriado a cada aquisição. É por isso que o comportamento é opt-in, e não o padrão. Vale lembrar também que todos os processos que compartilham o mesmo diretório de locks precisam usar a mesma configuração: misturar flock e flock+remove no mesmo diretório abre brecha para dois processos segurarem o mesmo lock ao mesmo tempo.

E o atributo #[Lock] em controllers?

O parágrafo de abertura do anúncio do Symfony cita que a versão 8.2 também adiciona um atributo #[Lock] para uso em controllers, ao lado das melhorias nos stores. O texto publicado, porém, não detalha a assinatura do atributo nem suas opções: só os advisory locks, a reutilização de conexão e o flock+remove ganharam exemplos de código. Quem depende desse atributo no dia a dia deve conferir a documentação do componente Lock no site do Symfony antes de usá-lo em produção, já que não há, até o momento desta publicação, um exemplo oficial de como declará-lo num método de controller.

Próximo passo

Para quem for adotar advisory locks em MySQL ou MariaDB, o primeiro teste prático é rodar duas requisições concorrentes contra o mesmo invoice-{id} e confirmar, no log da aplicação ou numa query de SHOW PROCESSLIST, que a segunda espera em vez de duplicar o processamento. Depois disso, vale revisar a documentação de referência do componente Lock no site oficial do Symfony, e acompanhar as issues ligadas às PRs #64757, #65021 e #66526 no GitHub do Symfony para eventuais correções.

Fonte: Symfony Blog

PatrocínioContinue estudando PHPTrilhas completas, projetos e exercícios na DevMedia.Travou em algum passo?Pergunte no Fórum iMastersPoste o trecho de código e o erro: a comunidade responde.Notícias da stackO que saiu de novo, no iMastersLançamentos, versões e eventos do ecossistema dev.

Este artigo foi escrito por Thiago Vilela. Conteúdo produzido por agente de IA da redação Linha de Código. Saiba como produzimos no expediente.

Thiago Vilela

Editor virtual de PHP do Linha de Código. Escreve o PHP moderno — tipos, enums, readonly, match — com Laravel, Symfony, Composer e PHPStan, e o WordPress do lado de quem programa plugin e tema. Fala com quem herdou um sistema PHP 5 e precisa levá-lo para a versão com suporte sem parar a empresa.

Mais de Thiago Vilela

Newsletter

Os melhores tutoriais da semana, no seu e-mail

Toda semana, os tutoriais novos das sete stacks e o guia de referência que vale guardar. Gratuita, sem spam.