Cómo usar las herramientas wkhtmltopdf y wkhtmltoimage en tu hosting cPanel

En este artículo te mostramos cómo utilizar las herramientas wkhtmltopdf y wkhtmltoimage en tu cuenta de hosting con cPanel para convertir contenido HTML en archivos PDF o imágenes (como PNG o JPG). Ambas herramientas están basadas en el motor de renderizado WebKit y funcionan de forma muy similar desde la línea de comandos.

🛠️ Estas herramientas son ideales para desarrolladores que necesitan generar archivos en forma automatizada a partir de contenido web o plantillas HTML.

¿Qué son wkhtmltopdf y wkhtmltoimage?

• wkhtmltopdf: convierte páginas HTML (o archivos HTML locales) en documentos PDF.
• wkhtmltoimage: convierte páginas HTML (o archivos HTML locales) en imágenes, por defecto en formato PNG, pero también puede exportar en JPG, BMP, entre otros.

Requisitos para usarlas

Estas herramientas están disponibles para que las puedas utilizar, a partir de nuestros planes Cloud Hosting. Si eres usuario de hosting compartido o Hosting Reseller, deberás realizar un cambio de plan o aislar el sitio web donde quieras utilizarla en esta plataforma.

Tu cuenta de hosting deberá permitir la ejecución de comandos desde terminal, ya sea mediante SSH o scripts PHP que ejecuten binarios.

Esta extensión suele consumir buena cantidad de los recursos de procesamiento de tu plan, con lo que si este no cuenta con las características necesarias, podría generar una saturación y degradar la experiencia de navegación de tu web.

Ejemplos de uso

Convertir una página web en PDF

/usr/local/bin/wkhtmltopdf https://www.tudominio.com salida.pdf

Este comando descargará la página web y la convertirá en un archivo PDF llamado "salida.pdf".

Convertir una página web en imagen PNG

/usr/local/bin/wkhtmltoimage https://www.tudominio.com salida.png

Por defecto, la imagen se generará en formato PNG en el archivo "salida.png".

A continuación te mostraremos ejemplos de uso para diferentes opciones, como PHP, terminal o tarea cron. Los ejemplos son utilizando wkhtmltopdf pero son similares si quisieras utilizar wkhtmltoimage.

Cómo usar wkhtmltopdf desde PHP

Para convertir una URL web a PDF desde PHP con la extensión wkhtmltopdf, introduce estas líneas de código en tu script:

<?php
exec("/usr/local/bin/wkhtmltopdf https://www.tudominio.com /home/TU-USUARIO-CPANEL/public_html/output.pdf");
?>

Recuerda reemplazar "tudominio.com" por tu dominio real, y "TU-USUARIO-CPANEL" por el nombre de usuario de tu cuenta cPanel.

Cómo usar wkhtmltopdf desde consola SSH

Si por el contrario quieres utilizar la extensión para realizar una tarea específica desde la consola de SSH de tu hosting, sigue estos pasos:

Accede a tu panel de control cPanel y luego ve a Terminal, dentro del grupo Avanzada para abrir la terminal SSH.

Corriendo este comando, convertiremos una URL a pdf:

/usr/local/bin/wkhtmltopdf https://www.tudominio.com /home/TU-USUARIO-CPANEL/public_html/output.pdf

Al igual que en el ejemplo anterior, recuerda reemplazar "tudominio.com" por tu dominio real, y "TU-USUARIO-CPANEL" por el nombre de usuario de tu cuenta cPanel.

Cómo crear una tarea cron para correr wkhtmltopdf

Si quieres crear una tarea o trabajo de cron para generar un pdf de manera programada, ve entonces a Trabajos de cron dentro del grupo Avanzada de tu panel de control cPanel.

Luego, agrega la tarea especificando en Comando la siguiente línea:

/usr/local/bin/wkhtmltopdf https://tudominio.com /home/TU-USUARIO-CPANEL/public_html/output.pdf

Ten en cuenta no utilizar intervalos de tiempo demasiado cortos por el motivo de la saturación de recursos que genera esta extensión en tu plan.