alrahma_sunday_school_api/app/Services/Certificates/CertificatePdfService.php

<?php

declare(strict_types=1);

namespace App\Services\Certificates;

class CertificatePdfService
{
    private string $fontDir;
    private string $imgDir;

    public function __construct()
    {
        $this->fontDir = public_path('assets/certificates/fonts') . DIRECTORY_SEPARATOR;
        $this->imgDir  = public_path('assets/certificates/images') . DIRECTORY_SEPARATOR;
    }

    /**
     * @param  array<array{firstname: string, lastname: string, grade: string}>  $students
     */
    public function generate(array $students, string $certDate): string
    {
        $edwardianFont = \TCPDF_FONTS::addTTFfont($this->fontDir . 'Edwardian Script ITC Regular.ttf', 'TrueTypeUnicode', '', 32);
        $garamondBold  = \TCPDF_FONTS::addTTFfont($this->fontDir . 'Garamond Bold.ttf',                'TrueTypeUnicode', '', 32);
        $ebGaramond    = \TCPDF_FONTS::addTTFfont($this->fontDir . 'EBGaramond-Regular.ttf',           'TrueTypeUnicode', '', 32);

        $pdf = new \TCPDF('L', 'pt', 'A4', true, 'UTF-8', false);
        $pdf->SetCreator('Al Rahma Sunday School');
        $pdf->SetTitle('Student Certificates');
        $pdf->SetMargins(0, 0, 0, true);
        $pdf->SetAutoPageBreak(false, 0);
        $pdf->setPrintHeader(false);
        $pdf->setPrintFooter(false);
        $pdf->SetHeaderMargin(0);
        $pdf->SetFooterMargin(0);

        $W = $pdf->getPageWidth();
        $H = $pdf->getPageHeight();

        foreach ($students as $student) {
            $pdf->AddPage();
            $name  = $student['firstname'] . ' ' . $student['lastname'];
            $grade = $this->formatGrade((string) ($student['grade'] ?? ''));
            $this->drawCertificate($pdf, $W, $H, $name, $grade, $certDate, $edwardianFont, $garamondBold, $ebGaramond);
        }

        return (string) $pdf->Output('', 'S');
    }

    private function drawCertificate(
        \TCPDF $pdf,
        float  $W,
        float  $H,
        string $name,
        string $grade,
        string $certDate,
        string $edwardianFont,
        string $garamondBold,
        string $ebGaramond
    ): void {
        $pdf->Image($this->imgDir . 'title.png',      126, 0,   600);
        $pdf->Image($this->imgDir . 'background.png', 280, 176, 291, 340);
        $pdf->Image($this->imgDir . 'signature.png',  140, 399,  90,  90);

        $pdf->SetFont('times', 'B', 24);
        $pdf->SetTextColor(0, 0, 0);
        $pdf->SetXY(0, 151);
        $pdf->Cell($W, 24, 'Presented to:', 0, 0, 'C');

        $pdf->SetFont($edwardianFont, '', 38);
        $pdf->SetDrawColor(0, 0, 0);
        $pdf->setTextRenderingMode(0.4, true, false);
        $pdf->SetXY(0, 219);
        $pdf->Cell($W, 38, $name, 0, 0, 'C');
        $pdf->setTextRenderingMode(0, true, false);

        $pdf->SetFont('times', '', 20);
        $pdf->SetXY(0, 243);
        $pdf->Cell(600, 20, '___________________________________', 0, 0, 'R');

        $pdf->SetFont($ebGaramond, '', 20);
        $pdf->SetXY(0, 273);
        $pdf->Cell($W, 20, 'for successfully completing the requirements of', 0, 0, 'C');

        $pdf->SetFont($garamondBold, '', 20);
        $pdf->SetXY(0, 310);
        $pdf->Cell($W, 20, $grade, 0, 0, 'C');

        $pdf->SetFont('times', '', 20);
        $pdf->SetXY(0, 343);
        $pdf->Cell($W, 20, 'at', 0, 0, 'C');

        $pdf->SetFont($garamondBold, '', 20);
        $pdf->SetXY(0, 375);
        $pdf->Cell($W, 20, 'Al Rahma Sunday School', 0, 0, 'C');

        $this->drawGradientText($pdf, $edwardianFont, 26, $certDate, 598, 453);

        $pdf->SetFont('times', '', 20);
        $pdf->SetXY(0, 463);
        $pdf->Cell(742, 20, '_________________', 0, 0, 'R');
        $pdf->SetXY(650, 492);
        $pdf->Cell(80, 20, 'Date', 0, 0, 'C');

        $pdf->SetXY(106, 463);
        $pdf->Cell(200, 20, '_________________', 0, 0, 'L');
        $pdf->SetXY(106, 492);
        $pdf->Cell(168, 20, 'Signature', 0, 0, 'C');
    }

    private function drawGradientText(\TCPDF $pdf, string $fontName, float $fontSize, string $text, float $x, float $y): void
    {
        $pdf->SetFont($fontName, '', $fontSize);

        for ($i = 0; $i < 6; $i++) {
            $pdf->setAlpha(($i + 1) * 25 / 255);
            $pdf->SetTextColor(0, 0, 0);
            $pdf->Text($x + $i / 5, $y + $i / 5, $text);
        }

        $pdf->setAlpha(1);
        $pdf->SetTextColor(0, 0, 0);
        $pdf->Text($x, $y, $text);
    }

    private function formatGrade(string $raw): string
    {
        $clean = trim($raw);
        $lower = strtolower($clean);

        if (preg_match('/^\d+$/', $clean) && (int) $clean >= 1 && (int) $clean <= 9) {
            return 'Grade ' . $clean;
        }
        if ($lower === 'youth') {
            return 'Youth';
        }
        if ($lower === 'kg') {
            return 'Kindergarten';
        }

        return $clean;
    }
}