Beautiful Open-Source Form Builder
<?php
namespace App\Http\Controllers\Pdf;
use App\Exceptions\PdfNotSupportedException;
use App\Http\Controllers\Controller;
use App\Models\Forms\Form;
use App\Models\Forms\FormSubmission;
use App\Models\PdfTemplate;
use App\Service\Pdf\PdfCacheService;
use App\Service\Pdf\PdfGeneratorService;
use App\Service\Forms\SubmissionUrlService;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Facades\URL;
class PdfGenerateController extends Controller
{
public function __construct(
private PdfGeneratorService $generator,
private PdfCacheService $cache
) {
$this->middleware('auth')->only(['getTemplateSignedUrl', 'getPreviewSignedUrl']);
}
/**
* Get a signed URL for PDF download by template (primary endpoint).
* Returns a URL that can be used without auth (includes signature).
*/
public function getTemplateSignedUrl(
Request $request,
Form $form,
PdfTemplate $pdfTemplate,
string $submission_id
) {
$this->authorize('view', $form);
// Validate template belongs to form
if ($pdfTemplate->form_id !== $form->id) {
abort(404, 'Template not found.');
}
// Resolve submission
$submission = SubmissionUrlService::resolveSubmission($form, $submission_id);
if (!$submission) {
abort(404, 'Submission not found.');
}
$url = self::generateTemplateSignedUrl($form, $pdfTemplate, $submission);
return response()->json(['url' => $url]);
}
/**
* Get a signed URL for PDF preview by template.
*/
public function getPreviewSignedUrl(
Request $request,
Form $form,
PdfTemplate $pdfTemplate
) {
$this->authorize('update', $form);
if ($pdfTemplate->form_id !== $form->id) {
abort(404, 'Template not found.');
}
$url = URL::temporaryPublicSignedRoute(
'open.forms.pdf-templates.preview-signed',
now()->addMinutes(15),
[
'form' => $form->id,
'pdfTemplate' => $pdfTemplate->id,
]
);
return response()->json(['url' => $url]);
}
/**
* Generate and download PDF for a submission by template (signed URL).
*/
public function downloadByTemplate(
Request $request,
Form $form,
PdfTemplate $pdfTemplate,
string $submission_id
) {
// Validate template belongs to form
if ($pdfTemplate->form_id !== $form->id) {
abort(404, 'Template not found.');
}
// Resolve submission
$submission = SubmissionUrlService::resolveSubmission($form, $submission_id);
if (!$submission) {
abort(404, 'Submission not found.');
}
return $this->servePdfFromTemplate($form, $submission, $pdfTemplate, true);
}
/**
* Preview PDF using latest submission or empty data (signed URL, no auth).
*/
public function previewBySignature(
Request $request,
Form $form,
PdfTemplate $pdfTemplate
) {
if ($pdfTemplate->form_id !== $form->id) {
abort(404, 'Template not found.');
}
$submission = $form->submissions()->latest()->first();
if (!$submission) {
$submission = new FormSubmission([
'form_id' => $form->id,
'data' => [],
]);
$submission->id = 0;
}
return $this->servePdfFromTemplate($form, $submission, $pdfTemplate, false);
}
/**
* Serve PDF from template.
*/
private function servePdfFromTemplate(
Form $form,
FormSubmission $submission,
PdfTemplate $template,
bool $forceDownload = true
) {
// Validate submission belongs to form
if ($submission->form_id !== $form->id && $submission->id !== 0) {
abort(404, 'Submission not found.');
}
// Get or generate the PDF
try {
$pdfPath = $this->cache->getOrGenerateFromTemplate($form, $submission, $template, $this->generator);
} catch (PdfNotSupportedException $e) {
abort(422, $e->getMessage());
}
if (!Storage::exists($pdfPath)) {
abort(500, 'Failed to generate PDF.');
}
$filename = $template->resolveFilename($form, $submission);
if ($forceDownload) {
return Storage::download($pdfPath, $filename, [
'Content-Type' => 'application/pdf',
'Content-Disposition' => 'attachment; filename="' . $filename . '"',
]);
}
return Storage::response($pdfPath, $filename, [
'Content-Type' => 'application/pdf',
'Content-Disposition' => 'inline; filename="' . $filename . '"',
]);
}
/**
* Generate a signed URL for template-based PDF download.
*/
public static function generateTemplateSignedUrl(
Form $form,
PdfTemplate $template,
FormSubmission $submission
): string {
return SubmissionUrlService::buildPdfDownloadUrl($form, $template, $submission);
}
}