PHPackages                             erichfournier/html-to-image-php - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image &amp; Media](/categories/media)
4. /
5. erichfournier/html-to-image-php

ActiveLibrary[Image &amp; Media](/categories/media)

erichfournier/html-to-image-php
===============================

v1.0.4(2mo ago)05PHPPHP &gt;=8.1

Since Mar 3Pushed 2mo agoCompare

[ Source](https://github.com/erichfr/html-to-image-php)[ Packagist](https://packagist.org/packages/erichfournier/html-to-image-php)[ RSS](/packages/erichfournier-html-to-image-php/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

HTML to Image PHP
=================

[](#html-to-image-php)

Uma biblioteca leve e eficiente para converter strings HTML em imagens (JPEG) utilizando o **Google Chrome em modo Headless**.

---

✨ Características
-----------------

[](#-características)

- **Conversão Direta:** Transforma HTML/CSS complexos em imagens de alta qualidade.
- **Controle de Dimensões:** Defina largura e altura customizadas para cada captura.
- **Otimizado para Windows/Linux:** Inclui flags de estabilidade para evitar erros comuns de inicialização do navegador.
- **Fácil Integração:** Interface fluida e estática para implementação rápida em projetos Laravel ou PHP puro.

---

🚀 Instalação
------------

[](#-instalação)

Instale o pacote via **Composer**:

```
composer require erichfournier/html-to-image-php
```

Este pacote requer que o Google Chrome ou Chromium esteja instalado no servidor ou na máquina local.

---

🛠️ Requisitos de Sistema
------------------------

[](#️-requisitos-de-sistema)

- PHP: 8.1 ou superior.
- Extensões: ext-sockets habilitada.
- Navegador: Google Chrome instalado e disponível no PATH do sistema.

---

📖 Como usar
-----------

[](#-como-usar)

```
use ErichFournier\HtmlToImagePhp\HtmlConverter;

$html = "Olá Mundo!Gerando imagem com PHP.";

HtmlConverter::make($html)
    ->setDimensions(500, 600)
    ->save('caminho/do/arquivo.jpg');
```

```
try {
    $html = view('recibos.venda', compact('venda'))->render();
    $path = public_path('recibos/recibo_' . $venda->id . '.jpg');

    \ErichFournier\HtmlToImagePhp\HtmlConverter::make($html)
        ->setDimensions(500, 650)
        ->save($path);

    return response()->json(['message' => 'Imagem gerada com sucesso!']);
} catch (\Exception $e) {
    return response()->json(['error' => $e->getMessage()], 500);
}
```

[![Gravando 2026-03-03 114633](https://private-user-images.githubusercontent.com/67141847/557559401-61c5adf6-16e4-47ab-834a-1eb6e95d4e5d.gif?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU0MTk5ODksIm5iZiI6MTc3NTQxOTY4OSwicGF0aCI6Ii82NzE0MTg0Ny81NTc1NTk0MDEtNjFjNWFkZjYtMTZlNC00N2FiLTgzNGEtMWViNmU5NWQ0ZTVkLmdpZj9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA1VDIwMDgwOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTE4Y2FkMGVmZTk3M2FlYjc0YzNlZTJhNzkwYzJlMGYxZmZlNTUyOWMwOTJhMjAxNGNjMjU2NGMyOWU5NDcxYzkmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.KUg0bAYxdjNVM3HbD74digzeBp2kEF9cqVlf1E4sQ7c)](https://private-user-images.githubusercontent.com/67141847/557559401-61c5adf6-16e4-47ab-834a-1eb6e95d4e5d.gif?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3NzU0MTk5ODksIm5iZiI6MTc3NTQxOTY4OSwicGF0aCI6Ii82NzE0MTg0Ny81NTc1NTk0MDEtNjFjNWFkZjYtMTZlNC00N2FiLTgzNGEtMWViNmU5NWQ0ZTVkLmdpZj9YLUFtei1BbGdvcml0aG09QVdTNC1ITUFDLVNIQTI1NiZYLUFtei1DcmVkZW50aWFsPUFLSUFWQ09EWUxTQTUzUFFLNFpBJTJGMjAyNjA0MDUlMkZ1cy1lYXN0LTElMkZzMyUyRmF3czRfcmVxdWVzdCZYLUFtei1EYXRlPTIwMjYwNDA1VDIwMDgwOVomWC1BbXotRXhwaXJlcz0zMDAmWC1BbXotU2lnbmF0dXJlPTE4Y2FkMGVmZTk3M2FlYjc0YzNlZTJhNzkwYzJlMGYxZmZlNTUyOWMwOTJhMjAxNGNjMjU2NGMyOWU5NDcxYzkmWC1BbXotU2lnbmVkSGVhZGVycz1ob3N0In0.KUg0bAYxdjNVM3HbD74digzeBp2kEF9cqVlf1E4sQ7c)

---

⚙️ Configurações de Estabilidade
--------------------------------

[](#️-configurações-de-estabilidade)

O método save() implementa automaticamente flags para garantir a execução estável em ambientes como Docker, Laragon ou XAMPP:

- --disable-gpu: Essencial para servidores sem interface gráfica.
- --no-sandbox: Melhora a compatibilidade em kernels Linux.
- --remote-debugging-port=9222: Garante a comunicação estável via DevTools.
- Render Delay: Utiliza um usleep() estratégico para aguardar o carregamento de fontes e CSS antes do screenshot.

---

📄 Licença
---------

[](#-licença)

Distribuído sob a licença MIT. Veja LICENSE para mais informações.

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance85

Actively maintained with recent releases

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

76d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f44072d8e40a43d3bcfbbd0140fb1ceaa2b60aa7ed686f75ec12016810beb186?d=identicon)[erichfr](/maintainers/erichfr)

---

Top Contributors

[![erichfr](https://avatars.githubusercontent.com/u/67141847?v=4)](https://github.com/erichfr "erichfr (12 commits)")

### Embed Badge

![Health badge](/badges/erichfournier-html-to-image-php/health.svg)

```
[![Health](https://phpackages.com/badges/erichfournier-html-to-image-php/health.svg)](https://phpackages.com/packages/erichfournier-html-to-image-php)
```

###  Alternatives

[milon/barcode

Barcode generator like Qr Code, PDF417, C39, C39+, C39E, C39E+, C93, S25, S25+, I25, I25+, C128, C128A, C128B, C128C, 2-Digits UPC-Based Extention, 5-Digits UPC-Based Extention, EAN 8, EAN 13, UPC-A, UPC-E, MSI (Variation of Plessey code)

1.5k13.3M39](/packages/milon-barcode)[bkwld/croppa

Image thumbnail creation through specially formatted URLs for Laravel

510496.0k23](/packages/bkwld-croppa)[saasykit/laravel-open-graphy

An awesome open graph image (social cards) generator package for Laravel.

13057.0k](/packages/saasykit-laravel-open-graphy)[goat1000/svggraph

Generates SVG graphs

132849.6k3](/packages/goat1000-svggraph)[cohensive/embed

Media Embed (for Laravel or as a standalone).

120370.4k](/packages/cohensive-embed)[netresearch/rte-ckeditor-image

Image support in CKEditor for the TYPO3 ecosystem - by Netresearch

63991.3k4](/packages/netresearch-rte-ckeditor-image)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
