feat: add Go, PHP, and Laravel SDKs
Some checks failed
Build & Deploy to Staging / Build & Deploy to Staging (push) Has been cancelled

- Go SDK: zero deps, functional options pattern, full endpoint coverage
- PHP SDK: PHP 8.1+, curl-based, PdfOptions class, PSR-4 autoloading
- Laravel package: ServiceProvider, Facade, config publishing
- All SDKs document complete PDF options including new v0.4.5 params
This commit is contained in:
DocFast Bot 2026-02-21 13:29:48 +00:00
parent 1545df9a7b
commit bc67c52d3a
13 changed files with 1133 additions and 0 deletions

114
sdk/laravel/README.md Normal file
View file

@ -0,0 +1,114 @@
# DocFast for Laravel
Official Laravel integration for the [DocFast](https://docfast.dev) HTML/Markdown to PDF API.
## Installation
```bash
composer require docfast/laravel
```
Add your API key to `.env`:
```env
DOCFAST_API_KEY=df_pro_your_api_key
```
Publish the config (optional):
```bash
php artisan vendor:publish --tag=docfast-config
```
## Usage
### Via Facade
```php
use DocFast\Laravel\Facades\DocFast;
// HTML to PDF
$pdf = DocFast::html('<h1>Invoice</h1><p>Total: €99.00</p>');
return response($pdf)
->header('Content-Type', 'application/pdf')
->header('Content-Disposition', 'inline; filename="invoice.pdf"');
```
### Via Dependency Injection
```php
use DocFast\Client;
class InvoiceController extends Controller
{
public function download(Client $docfast)
{
$pdf = $docfast->html(view('invoice')->render());
return response($pdf)
->header('Content-Type', 'application/pdf');
}
}
```
### Markdown to PDF
```php
$pdf = DocFast::markdown('# Report\n\nGenerated at ' . now());
```
### URL to PDF
```php
$pdf = DocFast::url('https://example.com');
```
### With PDF Options
```php
use DocFast\PdfOptions;
$options = new PdfOptions();
$options->format = 'Letter';
$options->landscape = true;
$options->margin = ['top' => '20mm', 'bottom' => '20mm'];
$pdf = DocFast::html($html, null, $options);
```
### Headers and Footers
```php
$options = new PdfOptions();
$options->displayHeaderFooter = true;
$options->footerTemplate = '<div style="font-size:9px;text-align:center;width:100%">Page <span class="pageNumber"></span></div>';
$options->margin = ['top' => '10mm', 'bottom' => '20mm'];
$pdf = DocFast::html(view('report')->render(), null, $options);
```
### Templates
```php
$pdf = DocFast::renderTemplate('invoice', [
'company' => 'Acme Corp',
'items' => [['name' => 'Widget', 'price' => 9.99]],
]);
```
## Configuration
```php
// config/docfast.php
return [
'api_key' => env('DOCFAST_API_KEY'),
'base_url' => env('DOCFAST_BASE_URL', 'https://docfast.dev'),
'timeout' => env('DOCFAST_TIMEOUT', 60),
];
```
## Links
- [PHP SDK](../php/) — standalone PHP client
- [Documentation](https://docfast.dev/docs)
- [API Reference](https://docfast.dev/openapi.json)
- [Get an API Key](https://docfast.dev)