wip

docs/advanced-usage/generating-pdfs-on-aws-lambda.md

@@ -3,4 +3,25 @@ title: Generating PDFs on AWS Lambda
 weight: 3
 ---
 
-Coming soon...
+Generating PDFs locally can be resource intensive. If you're having to generate a lot of PDFs, or having troubles to install the necessary dependencies on your server, you may want to consider using AWS Lambda to generate your PDFs.
+
+In order to generate PDFs on AWS Lambda, you must install these two packages in your app.
+
+- [hammerstone/sidecar](https://hammerstone.dev/sidecar/docs/main/overview): this allows you to  execute AWS Lambda functions from your Laravel applicatio
+- [wnx/sidecar-browsershot](https://github.com/wnx/sidecar-browsershot): this package contains a version of Browsershot that can run on AWS Lambda via Sidecar.
+
+With these two packages installed, you can generate PDFs on AWS Lambda like this:
+
+```php
+Pdf::view('pdf.invoice', $data)
+    ->generateOnLambda()
+    ->save('invoice.pdf');
+```
+
+If you want to create all PDFs in your app on Lambda, you can [set it as a default](https://spatie.be/docs/laravel-pdf/v1/basic-usage/setting-defaults) like this:
+
+```php
+// typically, in a service provider
+
+Pdf::default()->generateOnLambda();
+```

src/PdfBuilder.php

@@ -45,7 +45,7 @@ class PdfBuilder implements Responsable
         'Content-Type' => 'application/pdf',
     ];
 
-    protected bool $useLambda = false;
+    protected bool $generateOnLambda = false;
 
     public function view(string $view, array $data = []): self
     {
@@ -207,9 +207,9 @@ public function withBrowsershot(callable $callback): self
         return $this;
     }
 
-    public function useLambda(): self
+    public function generateOnLambda(): self
     {
-        $this->useLambda = true;
+        $this->generateOnLambda = true;
 
         return $this;
     }
@@ -264,7 +264,7 @@ protected function getFooterHtml(): ?string
 
     protected function getBrowsershot(): Browsershot
     {
-        $browsershotClass = $this->useLambda
+        $browsershotClass = $this->generateOnLambda
             ? BrowsershotLambda::class
             : Browsershot::class;