Você sabe o que é "softdelete"? Parte 3

Na primeira parte deste artigo, criamos o projeto, os métodos para listar registros e as respectivas rotas.

Na segunda parte, adicionamos os métodos para deletar, restaurar e consultar modelos deletados.

Nesta terceira e última parte veremos como remover de forma definitiva um registro do banco de dados.

Removendo registros permanentemente

Seguindo a mesma abordagem feita nas duas primeiras partes, vamos criar um método na controller...

public function forceDeleteInvoiceById($id)
{
    $invoice = Invoice::withTrashed()->find($id);

    if ($invoice) {
        $invoice->forceDelete();
        return response()->json(['message' => 'Invoice '.$id.' permanently deleted']);
    } else {
        return response(['message' => 'Invoice not found'], 404);
    }
}

...e em seguida a respectiva rota.

Route::delete('/{id}/forcedelete', 'forceDeleteInvoiceById');

Repare que instruímos o querybuilder a incluir registros deletados na consulta através o método withTrashed().

E acessando a rota passando um registro para deleção definitiva temos o seguinte resultado:

De acordo com a documentação oficial é possível agendar a exclusão definitiva de registros marcados como deletados fazendo uso de agendamento configurado na classe App\Console\Kernel.php.

Entretanto não abordaremos esta técnica neste artigo.

Conclusão

Se você chegou até aqui meu muito obrigado.
Espero que o projeto possa ajudá-lo de alguma forma, seja com conhecimento ou ideias para solucionar problemas do dia a dia.

Extensões utilizadas

Em desenvolvimento web, uma boa ferramenta para testar requisições api faz toda diferença.
Por isso deixo aqui o link para a extensão para VSCode Thunder RESTClient.
Na minha opinião não deixa nada a desejar para outras ferramentas pagas.
https://marketplace.visualstudio.com/items?itemName=rangav.vscode-thunder-client

Já para aplicações Laravel, a extensão Laravel Extra Intellisense ajuda muito na inclusão automática de referências.
https://marketplace.visualstudio.com/items?itemName=amiralizadeh9480.laravel-extra-intellisense

Repositório público

O projeto está publicado no github e pode ser acessado através deste endereço
https://github.com/MarcioPolicarpo/laravel9-soft-delete