spatie · freekmurze · Nov 21, 2022 · Nov 20, 2022
diff --git a/README.md b/README.md
@@ -31,6 +31,12 @@ You can also use an arbitrary html input, simply replace the `url` method with `
 Browsershot::html('<h1>Hello world!!</h1>')->save('example.pdf');
 ```
 
+If your HTML input is already in a file locally use the :
+
+```php
+Browsershot::htmlFromFilePath('/local/path/to/file.html')->save('example.pdf');
+```
+
 Browsershot also can get the body of an html page after JavaScript has been executed:
 
 ```php

diff --git a/src/Browsershot.php b/src/Browsershot.php
@@ -4,6 +4,7 @@
 
 use Spatie\Browsershot\Exceptions\CouldNotTakeBrowsershot;
 use Spatie\Browsershot\Exceptions\ElementNotFound;
+use Spatie\Browsershot\Exceptions\FileDoesNotExistException;
 use Spatie\Browsershot\Exceptions\FileUrlNotAllowed;
 use Spatie\Browsershot\Exceptions\HtmlIsNotAllowedToContainFile;
 use Spatie\Browsershot\Exceptions\UnsuccessfulResponse;
@@ -66,6 +67,11 @@ public static function html(string $html)
         return (new static())->setHtml($html);
     }
 
+    public static function htmlFromFilePath(string $filePath): self
+    {
+        return (new static())->setHtmlFromFilePath($filePath);
+    }
+
     public function __construct(string $url = '', bool $deviceEmulate = false)
     {
         $this->url = $url;
@@ -247,6 +253,19 @@ public function setUrl(string $url)
         return $this;
     }
 
+    public function setHtmlFromFilePath(string $filePath): self
+    {
+        if(false === file_exists($filePath)){
+            throw new FileDoesNotExistException($filePath);
+        }
+
+        $this->url = 'file://'.$filePath;
+        $this->html = '';
+
+        return $this;
+
+    }
+
     public function setProxyServer(string $proxyServer)
     {
         $this->proxyServer = $proxyServer;
@@ -675,14 +694,14 @@ public function applyManipulations(string $imagePath)
 
     public function createBodyHtmlCommand(): array
     {
-        $url = $this->html ? $this->createTemporaryHtmlFile() : $this->url;
+        $url = $this->getFinalContentsUrl();
 
         return $this->createCommand($url, 'content');
     }
 
     public function createScreenshotCommand($targetPath = null): array
     {
-        $url = $this->html ? $this->createTemporaryHtmlFile() : $this->url;
+        $url = $this->getFinalContentsUrl();
 
         $options = [
             'type' => $this->screenshotType,
@@ -706,7 +725,7 @@ public function createScreenshotCommand($targetPath = null): array
 
     public function createPdfCommand($targetPath = null): array
     {
-        $url = $this->html ? $this->createTemporaryHtmlFile() : $this->url;
+        $url = $this->getFinalContentsUrl();
 
         $options = [];
 
@@ -733,7 +752,7 @@ public function createPdfCommand($targetPath = null): array
 
     public function createEvaluateCommand(string $pageFunction): array
     {
-        $url = $this->html ? $this->createTemporaryHtmlFile() : $this->url;
+        $url = $this->getFinalContentsUrl();
 
         $options = [
             'pageFunction' => $pageFunction,
@@ -990,4 +1009,10 @@ private function isWindows()
     {
         return strtoupper(substr(PHP_OS, 0, 3)) === 'WIN';
     }
+
+    private function getFinalContentsUrl(): string
+    {
+        $url = $this->html ? $this->createTemporaryHtmlFile() : $this->url;
+        return $url;
+    }
 }
diff --git a/src/Exceptions/FileDoesNotExistException.php b/src/Exceptions/FileDoesNotExistException.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace Spatie\Browsershot\Exceptions;
+
+use Exception;
+
+class FileDoesNotExistException extends Exception
+{
+    public function __construct($file)
+    {
+        parent::__construct("The file `{$file} does not exist");
+    }
+}
diff --git a/tests/BrowsershotTest.php b/tests/BrowsershotTest.php
@@ -1555,3 +1555,22 @@
 
     expect('application/pdf')->toEqual($mimeType);
 });
+
+
+it('can set html contents from a file', function () {
+    $inputFile = __DIR__.'/temp/test.html';
+    $inputHtml = '<html><head></head><body><h1>Hello World</h1></body></html>';
+
+    file_put_contents($inputFile, $inputHtml);
+
+
+    $outputHtml = Browsershot::htmlFromFilePath($inputFile)
+        ->usePipe()
+        ->bodyHtml();
+
+    expect($outputHtml)->toEqual($inputHtml);
+});
+
+it('can not set html contents from a non-existent file', function () {
+    Browsershot::htmlFromFilePath(__DIR__.'/temp/non-existent-file.html');
+})->throws(\Spatie\Browsershot\Exceptions\FileDoesNotExistException::class);