xinyouhe/fdesk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

审批&PDF生成

Browse Source
This commit is contained in:
mzl
2025-09-08 11:34:19 +08:00
parent 8a4848bc75
commit 28368e27a7
30 changed files with 1269 additions and 980 deletions
Download Patch File Download Diff File Expand all files Collapse all files
app/common/utils/pdf/service/MpdfDriver.php
+118
View File
@@ -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];
}
}
app/common/utils/pdf/service/PdfGeneratorService.php
-179
View File
@@ -1,179 +0,0 @@
<?php
namespace app\common\utils\pdf\service;
use TCPDF;
use Exception;
class PdfGeneratorService
{
private $templatePath;
private $defaultOptions;
public function __construct()
{
// 设置模板基础路径
$this->templatePath = app_path() . '/common/utils/pdf/template/';
// 设置 TCPDF 默认选项
$this->defaultOptions = [
'page_orientation' => 'P', // PDF_PAGE_ORIENTATION
'unit' => 'mm', // PDF_UNIT
'page_format' => 'A4', // PDF_PAGE_FORMAT
'unicode' => true,
'encoding' => 'UTF-8',
// --- 修改字体设置 ---
// 'font' => 'dejavusans', // DejaVu 字体有时可能需要额外配置
'font' => 'stsongstdlight', // 使用 TCPDF 内置的简体中文支持字体
'font_style' => '', // 字体样式 (e.g., 'B' for bold)
'font_size' => 10,
// --- 字体设置结束 ---
'creator' => 'Your Company Internal System',
'author' => 'Your Company',
'margin_left' => 15,
'margin_right' => 15,
'margin_top' => 20,
'margin_bottom' => 20,
'margin_header' => 5,
'margin_footer' => 10,
];
}
/**
* 渲染模板并返回 HTML 字符串
*
* @param string $templateName 模板文件名 (不含 .php)
* @param array $data 注入模板的数据
* @return string 渲染后的 HTML
* @throws Exception
*/
private function renderTemplate(string $templateName, array $data): string
{
$templateFile = $this->templatePath . $templateName . '.php';
if (!file_exists($templateFile)) {
throw new Exception("PDF template file not found: {$templateFile}");
}
// 提取数据变量到当前作用域，供模板使用
extract($data);
// 开启输出缓冲
ob_start();
// 包含模板文件
include $templateFile;
// 获取缓冲区内容并清理缓冲区
$htmlContent = ob_get_clean();
if ($htmlContent === false) {
throw new Exception("Failed to render PDF template: {$templateName}");
}
return $htmlContent;
}
/**
* 生成 PDF
*
* @param string $templateName 模板文件名 (不含 .php)
* @param array $data 注入模板的数据
* @param array $options （可选）覆盖默认的 TCPDF 选项
* @return string PDF 二进制数据
* @throws Exception
*/
public function generate(string $templateName, array $data, array $options = []): string
{
// 合并选项
$options = array_merge($this->defaultOptions, $options);
// 渲染 HTML
$html = $this->renderTemplate($templateName, $data);
// 创建 TCPDF 实例
$pdf = new TCPDF(
$options['page_orientation'],
$options['unit'],
$options['page_format'],
$options['unicode'],
$options['encoding']
);
// 设置文档信息
$pdf->SetCreator($options['creator']);
$pdf->SetAuthor($options['author']);
$pdf->SetTitle($templateName . ' - Generated PDF');
// --- 修改字体设置 ---
// 使用支持中文的字体
// 'stsongstdlight' 是 TCPDF 内置的简体中文 CJK 字体
// 'cid0cs' 也是支持中文的字体，可以尝试
$pdf->SetFont($options['font'], $options['font_style'], $options['font_size'], '', true);
// --- 字体设置结束 ---
// 设置页边距
$pdf->SetMargins($options['margin_left'], $options['margin_top'], $options['margin_right']);
$pdf->SetHeaderMargin($options['margin_header']);
$pdf->SetFooterMargin($options['margin_footer']);
// 设置自动分页
$pdf->SetAutoPageBreak(TRUE, $options['margin_bottom']);
// 设置图像比例因子
$pdf->setImageScale(PDF_IMAGE_SCALE_RATIO);
// 添加首页
$pdf->AddPage();
// 写入 HTML 内容
$pdf->writeHTML($html, true, false, true, false, '');
// 结束最后一页
$pdf->endPage();
// 返回 PDF 字符串
return $pdf->Output('', 'S'); // 'S' 返回字符串
}
/**
* 保存 PDF 到文件
*
* @param string $templateName 模板文件名
* @param array $data 注入模板的数据
* @param string $filePath 保存的完整文件路径
* @param array $options （可选）TCPDF 选项
* @throws Exception
*/
public function saveToFile(string $templateName, array $data, string $filePath, array $options = [])
{
$options = array_merge($this->defaultOptions, $options);
$html = $this->renderTemplate($templateName, $data);
$pdf = new TCPDF(
$options['page_orientation'],
$options['unit'],
$options['page_format'],
$options['unicode'],
$options['encoding']
);
$pdf->SetCreator($options['creator']);
$pdf->SetAuthor($options['author']);
$pdf->SetTitle($templateName . ' - Saved PDF');
// --- 修改字体设置 ---
$pdf->SetFont($options['font'], $options['font_style'], $options['font_size'], '', true);
// --- 字体设置结束 ---
$pdf->SetMargins($options['margin_left'], $options['margin_top'], $options['margin_right']);
$pdf->SetAutoPageBreak(TRUE, $options['margin_bottom']);
$pdf->setImageScale(PDF_IMAGE_SCALE_RATIO);
$pdf->AddPage();
$pdf->writeHTML($html, true, false, true, false, '');
$pdf->endPage();
// 确保目录存在
$dir = dirname($filePath);
if (!is_dir($dir)) {
mkdir($dir, 0755, true);
}
$pdf->Output($filePath, 'F'); // 'F' 保存到文件
}
}
app/common/utils/pdf/service/PdfHelper.php
+80
View File
@@ -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();
}
}
app/common/utils/pdf/service/PdfStorage.php
+38
View File
@@ -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;
}
}
app/common/utils/pdf/service/document/ReimbursementDocumentService.php
-82
View File
@@ -1,82 +0,0 @@
<?php
namespace app\common\utils\pdf\service\document;
use app\common\utils\pdf\service\PdfGeneratorService;
use Exception;
class ReimbursementDocumentService
{
private $pdfGenerator;
public function __construct()
{
$this->pdfGenerator = new PdfGeneratorService();
}
/**
* 根据报销单 ID 生成 PDF 数据
* （这里模拟从数据库获取数据）
*
* @param int $reimbursementId
* @return string PDF 二进制数据
* @throws Exception
*/
public function generatePdfById(int $reimbursementId): string
{
// --- 模拟从数据库获取数据 ---
// 实际应用中，这里应该是查询数据库
$reimbursementData = $this->getMockReimbursementData($reimbursementId);
if (!$reimbursementData) {
throw new Exception("Reimbursement record not found for ID: {$reimbursementId}");
}
// --- 数据获取结束 ---
// 调用核心 PDF 服务生成 PDF
// 'reimbursement_template' 对应 app/view/pdf/reimbursement_template.php
return $this->pdfGenerator->generate('reimbursement', $reimbursementData);
}
/**
* 模拟获取报销单数据
* @param int $id
* @return array|null
*/
private function getMockReimbursementData(int $id)
{
if ($id <= 0) return null;
return [
'reimbursement_id' => 'REIM-' . str_pad($id, 5, '0', STR_PAD_LEFT),
'applicant_name' => '张三',
'department' => '技术部',
'application_date' => '2023-10-26',
'total_amount' => 1250.75,
'reason' => "参加北京技术研讨会的差旅费用。\n包括交通、住宿和餐饮。",
'items' => [
['date' => '2023-10-20', 'category' => '交通费', 'description' => '高铁二等座', 'amount' => 520.00, 'remark' => ''],
['date' => '2023-10-21', 'category' => '住宿费', 'description' => 'XX酒店 2 晚', 'amount' => 680.00, 'remark' => '含早餐'],
['date' => '2023-10-21', 'category' => '餐饮费', 'description' => '午餐晚餐', 'amount' => 50.75, 'remark' => '发票已附'],
]
];
}
/**
* 保存报销单 PDF 到服务器
* @param int $reimbursementId
* @param string $savePath 保存路径 (目录)
* @throws Exception
*/
public function savePdfToFile(int $reimbursementId, string $savePath)
{
$reimbursementData = $this->getMockReimbursementData($reimbursementId);
if (!$reimbursementData) {
throw new Exception("Reimbursement record not found for ID: {$reimbursementId}");
}
$filename = 'reimbursement_' . $reimbursementData['reimbursement_id'] . '_' . date('Ymd_His') . '.pdf';
$fullPath = rtrim($savePath, '/') . '/' . $filename;
$this->pdfGenerator->saveToFile('reimbursement_template', $reimbursementData, $fullPath);
}
}