rustedf.cloud
Menú

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.

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

← Todos los artículos