Como gerar PDF a partir de HTML em PHP e Laravel
Publicado em 2 min de leitura
Em PHP, transformar HTML em PDF costuma significar instalar uma biblioteca ou um binário no servidor e mantê-lo funcionando. Com uma API, é uma requisição HTTP, algo que o PHP já sabe fazer. Este guia mostra isso em PHP puro e em Laravel com a API do rustedf.cloud.
PHP puro com cURL
<?php
$payload = [ 'html' => '<h1>Fatura {{ number }}</h1><p>{{ customer }}</p>', 'data' => ['number' => '2025-0042', 'customer' => 'Ana Souza'],];
$ch = curl_init('https://api.rustedf.com/v1/render');curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ 'Authorization: Bearer ' . getenv('RUSTEDF_KEY'), 'Content-Type: application/json', ], CURLOPT_POSTFIELDS => json_encode($payload), CURLOPT_TIMEOUT => 40,]);
$body = curl_exec($ch);$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);curl_close($ch);
if ($status !== 200) { $error = json_decode($body, true)['error'] ?? []; throw new RuntimeException($error['message'] ?? "Falha ao gerar ($status)");}
file_put_contents('fatura.pdf', $body);O corpo de uma resposta bem-sucedida é o PDF. Em uma falha, é um JSON, com um code estável
para a sua lógica e uma message para as pessoas. Defina o tempo limite acima do limite do
seu plano, para que a sua própria requisição não desista antes do serviço.
Laravel
Guarde a chave no .env e leia-a pela configuração, nunca de uma view nem do navegador.
RUSTEDF_KEY=rfk_...
// config/services.php'rustedf' => [ 'key' => env('RUSTEDF_KEY'), 'url' => 'https://api.rustedf.com',],use Illuminate\Support\Facades\Http;
public function fatura(Fatura $fatura){ $response = Http::withToken(config('services.rustedf.key')) ->timeout(40) ->post(config('services.rustedf.url') . '/v1/render', [ 'template_id' => config('faturas.template_id'), 'locale' => 'pt-BR', 'data' => [ 'number' => $fatura->numero, 'customer' => ['name' => $fatura->cliente->nome], 'total' => (string) $fatura->total, ], ]);
if ($response->failed()) { report(new \RuntimeException($response->json('error.message') ?? 'Falha ao gerar')); abort(502, 'Não foi possível gerar a fatura.'); }
return response($response->body(), 200, [ 'Content-Type' => 'application/pdf', 'Content-Disposition' => 'inline; filename="fatura-' . $fatura->numero . '.pdf"', ]);}Para guardar o arquivo em vez de enviá-lo direto, use Storage::put("faturas/{$fatura->numero}.pdf", $response->body()).
Template salvo ou HTML direto
O exemplo acima chama um template salvo pelo id, que você edita no portal com pré-visualização ao vivo. É a melhor escolha quando o mesmo layout é gerado com frequência.
Para enviar o HTML por conta própria, coloque-o em html no lugar de template_id. Duas
precauções:
- O HTML é, ele mesmo, um template, então
{{ }}e{% %}nele são lidos pelo serviço. Passe tudo o que um usuário digitou pordata, que é escapado, em vez de colá-lo na string. - Se você gera o HTML com o Blade antes, lembre-se de que o resultado volta a ser tratado
como template. Um nome que contenha
{{seria interpretado, e não impresso.
Erros que vale tratar
| Status | code |
O que fazer |
|---|---|---|
| 401 | unauthorized |
A chave está ausente, errada ou revogada. |
| 402 | insufficient_credits |
Os créditos acabaram. Nada foi gerado. |
| 422 | invalid_template |
O template ou os dados falharam. Leia a message. |
| 429 | rate_limited |
Espere o cabeçalho Retry-After e tente de novo. |
| 503 | busy |
O serviço está ocupado. Espere o Retry-After e tente de novo. |
| 504 | render_timeout |
O documento levou mais do que o seu plano permite. |
Um crédito é tirado quando uma geração começa e devolvido se ela falha, então uma chamada com erro não custa nada.
Leia Gerar um PDF, Autenticação e Erros e limites.
Continue lendo
Código e integrações
Gerar PDF no ASP.NET Core: MVC, Razor Pages e minimal APIs
Transforme uma view Razor em PDF no ASP.NET Core com uma chamada de API: renderizador de views, view pronta para impressão, action MVC e handler do Razor Pages.
3 min de leitura
Código e integrações
Converter página web em PDF em C# sem navegador headless
Busque uma página com HttpClient e transforme o HTML em PDF com uma chamada de API em C#. Quais páginas isso atende, quais não e como conferir antes de depender.
3 min de leitura
Código e integrações
Gerador de relatório PDF em C#: tabela paginada com totais
Monte um relatório em PDF em C# a partir de uma lista de objetos: tabela com cabeçalho repetido em cada página, total, número de página e contagem de páginas.
3 min de leitura
Código e integrações
Salvar PDF em C#: em disco, como download ou em blob storage
Salve o PDF devolvido por uma chamada de renderização em C#: grave em disco, envie como download no ASP.NET Core, guarde um link assinado ou suba para o storage.
2 min de leitura