rustedf.cloud
Menu

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.

.env
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 por data, 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.

  • 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

← Todos os posts