update email template

This commit is contained in:
baodev0
2026-09-09 16:56:22 +07:00
parent d3d9f76ba0
commit 2365ef72e9
210 changed files with 6335 additions and 4688 deletions
@@ -0,0 +1,69 @@
<?php
namespace App\Services\Email;
use App\Exceptions\InvalidTemplateVariableException;
use App\Models\Template;
/**
* Render Template subject/message: chỉ thay thế placeholder dạng {{key}} đã khai báo
* trong metadata.variables. Không eval(), không compile Blade/PHP.
*/
class EmailTemplateRenderer
{
private const PLACEHOLDER_PATTERN = '/\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*\}\}/';
/**
* @return array{subject: string, html: string}
*/
public function render(Template $template, array $data): array
{
$variables = $template->variables();
$this->assertKnownVariables($template->scenario ?? $template->name ?? 'unknown', (string) $template->subject, $variables);
$this->assertKnownVariables($template->scenario ?? $template->name ?? 'unknown', (string) $template->message, $variables);
return [
'subject' => $this->replace((string) $template->subject, $variables, $data),
'html' => $this->replace((string) $template->message, $variables, $data),
];
}
private function assertKnownVariables(string $scenario, string $content, array $variables): void
{
$used = $this->extractPlaceholders($content);
$invalid = array_values(array_diff($used, array_keys($variables)));
if ($invalid !== []) {
throw new InvalidTemplateVariableException($scenario, $invalid);
}
}
private function extractPlaceholders(string $content): array
{
preg_match_all(self::PLACEHOLDER_PATTERN, $content, $matches);
return array_values(array_unique($matches[1]));
}
private function replace(string $content, array $variables, array $data): string
{
return preg_replace_callback(self::PLACEHOLDER_PATTERN, function (array $match) use ($variables, $data) {
$key = $match[1];
$definition = $variables[$key] ?? [];
$value = $data[$key] ?? $definition['example'] ?? '';
return $this->formatValue((string) $value, $definition['type'] ?? 'string');
}, $content) ?? $content;
}
private function formatValue(string $value, string $type): string
{
return match ($type) {
// html: nội dung tin cậy do Email Builder sinh ra sẵn (đã được builder escape khi build).
'html' => $value,
'url' => filter_var($value, FILTER_VALIDATE_URL) ? htmlspecialchars($value, ENT_QUOTES, 'UTF-8') : '',
default => htmlspecialchars($value, ENT_QUOTES, 'UTF-8'),
};
}
}
@@ -0,0 +1,45 @@
<?php
namespace App\Services\Email;
use App\Jobs\Mail\SendTemplateEmailJob;
use App\Models\Template;
use Illuminate\Support\Facades\Cache;
/**
* Entry point chung để gửi email theo scenario. Load Template (có cache),
* render qua EmailTemplateRenderer, gửi qua queue (SendTemplateEmailJob).
*/
class EmailTemplateService
{
public function __construct(
private readonly EmailTemplateRenderer $renderer,
) {}
/**
* @param string|array<int, string> $to
*/
public function send(string $scenario, string|array $to, array $data = []): void
{
SendTemplateEmailJob::dispatch($scenario, is_array($to) ? $to : [$to], $data);
}
/**
* Render ngay (không gửi) — dùng cho preview trong Email Builder.
*
* @return array{subject: string, html: string}
*/
public function preview(string $scenario, array $data = []): array
{
return $this->renderer->render($this->loadTemplate($scenario), $data);
}
public function loadTemplate(string $scenario): Template
{
return Cache::remember(
Template::CACHE_PREFIX . $scenario,
3600,
fn () => Template::where('scenario', $scenario)->where('status', 1)->firstOrFail(),
);
}
}