Cómo generar un PDF desde HTML en PHP y Laravel
Publicado el 2 min de lectura
En PHP, convertir HTML en PDF suele significar instalar una biblioteca o un binario en el servidor y mantenerlo funcionando. Con una API es una petición HTTP, algo que PHP ya sabe hacer. Esta guía lo muestra en PHP puro y en Laravel con la API de rustedf.cloud.
PHP puro con cURL
<?php
$payload = [ 'html' => '<h1>Factura {{ 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'] ?? "Error al generar ($status)");}
file_put_contents('factura.pdf', $body);El cuerpo de una respuesta correcta es el PDF. En un fallo es un JSON, con un code estable
para tu lógica y un message para las personas. Fija el tiempo límite por encima del límite
de tu plan, para que tu propia petición no se rinda antes que el servicio.
Laravel
Guarda la clave en .env y léela a través de la configuración, nunca desde una vista ni desde
el navegador.
RUSTEDF_KEY=rfk_...
// config/services.php'rustedf' => [ 'key' => env('RUSTEDF_KEY'), 'url' => 'https://api.rustedf.com',],use Illuminate\Support\Facades\Http;
public function factura(Factura $factura){ $response = Http::withToken(config('services.rustedf.key')) ->timeout(40) ->post(config('services.rustedf.url') . '/v1/render', [ 'template_id' => config('facturas.template_id'), 'locale' => 'es-ES', 'data' => [ 'number' => $factura->numero, 'customer' => ['name' => $factura->cliente->nombre], 'total' => (string) $factura->total, ], ]);
if ($response->failed()) { report(new \RuntimeException($response->json('error.message') ?? 'Error al generar')); abort(502, 'No se pudo generar la factura.'); }
return response($response->body(), 200, [ 'Content-Type' => 'application/pdf', 'Content-Disposition' => 'inline; filename="factura-' . $factura->numero . '.pdf"', ]);}Para guardar el archivo en lugar de enviarlo directamente, usa Storage::put("facturas/{$factura->numero}.pdf", $response->body()).
Plantilla guardada o HTML directo
El ejemplo anterior llama a una plantilla guardada por su id, que editas en el portal con vista previa en vivo. Es la mejor opción cuando el mismo diseño se genera con frecuencia.
Para enviar el HTML por tu cuenta, ponlo en html en lugar de template_id. Dos
precauciones:
- El HTML es, él mismo, una plantilla, así que
{{ }}y{% %}en él los lee el servicio. Pasa todo lo que haya escrito un usuario pordata, que se escapa, en lugar de pegarlo en la cadena. - Si generas el HTML con Blade antes, recuerda que el resultado vuelve a tratarse como
plantilla. Un nombre que contenga
{{se interpretaría, no se imprimiría.
Errores que conviene tratar
| Estado | code |
Qué hacer |
|---|---|---|
| 401 | unauthorized |
La clave falta, es incorrecta o está revocada. |
| 402 | insufficient_credits |
Se acabaron los créditos. No se generó nada. |
| 422 | invalid_template |
La plantilla o los datos fallaron. Lee el message. |
| 429 | rate_limited |
Espera la cabecera Retry-After y reintenta. |
| 503 | busy |
El servicio está ocupado. Espera el Retry-After y reintenta. |
| 504 | render_timeout |
El documento tardó más de lo que permite tu plan. |
Un crédito se toma cuando empieza una generación y se devuelve si falla, así que una llamada con error no cuesta nada.
Consulta Generar un PDF, Autenticación y Errores y límites.
Sigue leyendo
Código e integraciones
Generar un PDF en ASP.NET Core: MVC, Razor Pages y minimal APIs
Convierte una vista Razor en PDF en ASP.NET Core con una llamada a la API: renderizador de vistas, vista lista para imprimir, acción MVC y handler de Razor Pages.
3 min de lectura
Código e integraciones
Convertir una página web a PDF en C# sin navegador headless
Descarga una página con HttpClient y convierte su HTML en PDF con una llamada a la API en C#. Qué páginas admite, cuáles no y cómo comprobarlo de antemano.
3 min de lectura
Código e integraciones
Generador de informes PDF en C#: tabla paginada con totales
Crea un informe PDF en C# a partir de una lista de objetos: tabla con la cabecera repetida en cada página, total, números de página y recuento de páginas.
3 min de lectura
Código e integraciones
Guardar un PDF en C#: en disco, como descarga o en blob storage
Guarda el PDF que devuelve una llamada de renderizado en C#: escríbelo en disco, envíalo como descarga en ASP.NET Core, usa un enlace firmado o súbelo al storage.
2 min de lectura