@@ -0,0 +1,118 @@
+<?php
+// app/service/pdf/MpdfDriver.php
+namespace app\common\utils\pdf\service;
+
+use Mpdf\Mpdf;
+use Mpdf\Config\ConfigVariables;
+use Mpdf\Config\FontVariables;
+use Mpdf\HTMLParserMode;
+
+class MpdfDriver
+{
+
+    public function htmlToPdf(string $html, array $options = []): string
+    {
+        $opts = array_merge([
+            'format'        => 'A4',
+            'orientation'   => 'L',
+            'margin_top'    => 12,
+            'margin_bottom' => 12,
+            'margin_left'   => 10,
+            'margin_right'  => 10,
+            'tempDir'       => runtime_path('mpdf'),
+            'header_html'   => '',
+            'footer_html'   => '',
+            'watermark_text'=> '',
+            'css_files'     => [],
+            'default_font'  => 'notosanssc',
+            'font_dirs'     => [public_path('fonts')],
+            'font_data'     => [
+                'notosanssc' => ['R'=>'NotoSansSC-Regular.ttf','B'=>'NotoSansSC-Bold.ttf'],
+            ],
+            'asset_base'    => '',
+            'enable_html5_parser' => true,
+        ], $options);
+
+        $defaultConfig     = (new ConfigVariables())->getDefaults();
+        $defaultFontConfig = (new FontVariables())->getDefaults();
+
+        $fontDirs = array_merge($defaultConfig['fontDir'], $opts['font_dirs']);
+        $fontData = array_merge($defaultFontConfig['fontdata'], $opts['font_data']);
+
+        $mpdf = new Mpdf([
+            'format'        => $opts['format'],
+            'orientation'   => $opts['orientation'],
+            'margin_left'   => $opts['margin_left'],
+            'margin_right'  => $opts['margin_right'],
+            'margin_top'    => $opts['margin_top'],
+            'margin_bottom' => $opts['margin_bottom'],
+            'tempDir'       => $opts['tempDir'],
+            'fontDir'       => $fontDirs,
+            'fontdata'      => $fontData,
+            'default_font'  => $opts['default_font'],
+            'enable_html5_parser' => $opts['enable_html5_parser'],
+        ]);
+
+        if ($opts['header_html']) $mpdf->SetHTMLHeader($opts['header_html']);
+        if ($opts['footer_html']) $mpdf->SetHTMLFooter($opts['footer_html']);
+
+        if (!empty($opts['watermark_text'])) {
+            $mpdf->SetWatermarkText($opts['watermark_text']);
+            $mpdf->showWatermarkText = true;
+            $mpdf->watermarkTextAlpha = 0.08;
+        }
+
+        // 资源绝对化（如果你有相对路径的图片等）
+        $html = PdfHelper::absolutizeAssetUrls($html, $opts['asset_base']);
+
+        // === 关键改动：把 <style>…</style> 抽出来，作为 HEADER_CSS 写入 ===
+        [$inlineCss, $cleanHtml] = $this->extractCssAndCleanHtml($html);
+
+        // 先写外部 css_files
+        if (!empty($opts['css_files'])) {
+            foreach ($opts['css_files'] as $cssFile) {
+                if (is_file($cssFile)) {
+                    $mpdf->WriteHTML(file_get_contents($cssFile), HTMLParserMode::HEADER_CSS);
+                }
+            }
+        }
+        // 再写内联 <style> 的 CSS
+        if ($inlineCss !== '') {
+            $mpdf->WriteHTML($inlineCss, HTMLParserMode::HEADER_CSS);
+        }
+
+        // 最后写 HTML 正文（已剔除 <style>，避免任何情况下把 CSS 当文字打印）
+        $mpdf->WriteHTML($cleanHtml, HTMLParserMode::HTML_BODY);
+
+        return $mpdf->Output('', \Mpdf\Output\Destination::STRING_RETURN);
+    }
+
+    /**
+     * 把所有 <style>...</style> 的内容拼成一段 CSS，并把这些 <style> 标签从 HTML 中移除
+     * @return array{0:string,1:string} [css, htmlWithoutStyle]
+     */
+    private function extractCssAndCleanHtml(string $html): array
+    {
+        $cssParts = [];
+        // 抓取所有 <style ...>...</style>，DOTALL 支持跨行
+        if (preg_match_all('/<style\b[^>]*>(.*?)<\/style>/is', $html, $m)) {
+            foreach ($m[1] as $block) {
+                // 去掉 HTML 注释，以防注释把 CSS 包起来
+                $block = preg_replace('/<!--|-->/', '', $block);
+                $cssParts[] = trim($block);
+            }
+            // 从 HTML 删除所有 <style> 块
+            $html = preg_replace('/<style\b[^>]*>.*?<\/style>/is', '', $html);
+        }
+        $css = implode("\n\n", $cssParts);
+
+        // 额外保险：把 <head> 也清理掉，防止某些解析器把 head 里残余文本当正文
+        $html = preg_replace('/<head\b[^>]*>.*?<\/head>/is', '', $html);
+
+        // 确保剩余 HTML 有 <body>，没有就包一层
+        if (!preg_match('/<body\b/i', $html)) {
+            $html = '<body>' . $html . '</body>';
+        }
+        return [$css, $html];
+    }
+}
@@ -0,0 +1,80 @@
+<?php
+// app/service/pdf/PdfHelper.php
+namespace app\common\utils\pdf\service;
+
+class PdfHelper
+{
+    /** 从文件加载 HTML（支持占位符 {{key}} 简单替换） */
+    public static function loadTemplate(string $file, array $vars = []): string
+    {
+        if (!is_file($file)) {
+            throw new \RuntimeException("Template not found: {$file}");
+        }
+        $html = file_get_contents($file);
+        if ($vars) {
+            $search = [];
+            $replace = [];
+            foreach ($vars as $k => $v) {
+                $search[] = '{{' . $k . '}}';
+                $replace[] = htmlspecialchars((string)$v, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
+            }
+            $html = str_replace($search, $replace, $html);
+        }
+        return $html;
+    }
+
+    /**
+     * 把 HTML 里的相对资源路径（img/link/script href/src）改成绝对路径
+     * 仅处理以 ./  ../ 或非 http(s) 的相对量；base 传 public/assets/pdf 等目录
+     */
+    public static function absolutizeAssetUrls(string $html, string $baseDir): string
+    {
+        $baseDir = rtrim($baseDir, DIRECTORY_SEPARATOR);
+        // img src
+        $html = preg_replace_callback('#(<img[^>]+src=["\'])([^"\']+)(["\'])#i', function($m) use ($baseDir){
+            $u = $m[2];
+            if (preg_match('#^https?://#i', $u) || strpos($u, 'data:') === 0) return $m[0];
+            $abs = realpath($baseDir . DIRECTORY_SEPARATOR . ltrim($u, '/')) ?: ($baseDir . '/' . ltrim($u, '/'));
+            return $m[1] . $abs . $m[3];
+        }, $html);
+
+        // link href（如果你在 HTML 里写了 <link>，通常建议走 css_files 方式，这里也兼容）
+        $html = preg_replace_callback('#(<link[^>]+href=["\'])([^"\']+)(["\'])#i', function($m) use ($baseDir){
+            $u = $m[2];
+            if (preg_match('#^https?://#i', $u)) return $m[0];
+            $abs = realpath($baseDir . DIRECTORY_SEPARATOR . ltrim($u, '/')) ?: ($baseDir . '/' . ltrim($u, '/'));
+            return $m[1] . $abs . $m[3];
+        }, $html);
+
+        return $html;
+    }
+
+
+    /**
+     * 渲染一个原生 PHP 模板为字符串
+     * @param string $file 模板路径（如 resource/templates/stock-order.php）
+     * @param array  $vars 将在模板中以变量名存在（如 $data）
+     * @return string 完整 HTML
+     */
+    public static function render(string $file, array $vars = []): string
+    {
+        if (!is_file($file)) {
+            throw new \RuntimeException("Template not found: {$file}");
+        }
+        // 将键名导出为同名变量，例如 'data' => [...] 变为 $data
+        extract($vars, EXTR_OVERWRITE);
+
+        // 开启缓冲，将 include 的输出抓取为字符串
+        ob_start();
+        ob_implicit_flush(false);
+        try {
+            /** @noinspection PhpIncludeInspection */
+            include $file;
+        } catch (\Throwable $e) {
+            // 清理缓冲并抛出更清晰的异常
+            ob_end_clean();
+            throw $e;
+        }
+        return ob_get_clean();
+    }
+}
@@ -0,0 +1,38 @@
+<?php
+namespace app\common\utils\pdf\service;
+
+final class PdfStorage
+{
+    /**
+     * @param string $pdfBin   PDF 二进制
+     * @param string|null $dir 保存目录，默认 runtime/pdf
+     * @param string|null $name 文件名（不含目录），默认：stock-order-YYYYmmdd-His-uniqid.pdf
+     * @return string 绝对路径
+     */
+    public static function saveBinary(string $pdfBin, ?string $dir = null, ?string $name = null): string
+    {
+        $dir  = $dir  ?: runtime_path('pdf');
+        if (!is_dir($dir)) {
+            if (!@mkdir($dir, 0775, true) && !is_dir($dir)) {
+                throw new \RuntimeException("Failed to create dir: {$dir}");
+            }
+        }
+
+        // 生成安全文件名
+        $name = $name ?: ('stock-order-' . date('Ymd-His') . '-' . substr(uniqid('', true), -6) . '.pdf');
+        $name = preg_replace('/[^a-zA-Z0-9_\-.]/', '_', $name); // 简易净化
+        $path = rtrim($dir, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . $name;
+
+        // 先写入临时文件，再原子重命名，避免并发/写入中被读取
+        $tmp  = $path . '.part';
+        if (file_put_contents($tmp, $pdfBin, LOCK_EX) === false) {
+            throw new \RuntimeException("Failed to write temp file: {$tmp}");
+        }
+        if (!@rename($tmp, $path)) {
+            @unlink($tmp);
+            throw new \RuntimeException("Failed to move temp to: {$path}");
+        }
+        @chmod($path, 0664);
+        return $path;
+    }
+}