05百融云策略引擎项目交付-laravel实战完整交付定义常量分文件配置-独立建立lib类处理-成功导出pdf-优雅草卓伊凡引言 此前只是把关于如何把查询内容导出pdf库的代码实现了,但是我们并没有完成整个项目,这最后一个步骤就是安装composer再安装tcpdf库,最后修改结构目录实现完整项目功能,查询得到结果导出pdf库,本篇调整目录结构,分文件实现代码,完整交付过程完成交付。 演示demo地址bairong.youyacao.com 实战开始我卓伊凡将为你提供完整的调整目录结构,分文件实现代码,完整交付过程,对待小项目也要如此,否则很多人永远敷衍了事永远成不了事。 首先上篇我们知道安装完成了 2. 调整目录结构建议的目录结构: / (项目根目录)├── composer.json├── composer.lock├── vendor/ (Composer自动生成)├── config/│ └── constants.php (常量配置)├── lib/│ ├── BairongAPI.php (API处理类)│ └── PDFGenerator.php (PDF生成类)├── temp/ (临时文件目录)├── assets/│ ├── css/│ ├── js/│ └── images/│ └── logo.png (企业logo)└── index.php (主入口文件)我们查看目录结构, 我们对应建立起来 其他文件夹 3. 分文件实现代码config/constants.php<?php// API配置常量define('API_CODE', '保密');define('APP_KEY', '保密');define('STRATEGY_ID', '保密');define('SANDBOX_URL', 'https://sandbox-api2.100credit.cn/infoverify/v3/info_verify');define('PRODUCTION_URL', 'https://api2.100credit.cn/infoverify/v3/info_verify');// 路径常量define('ROOT_PATH', dirname(__DIR__));define('TEMP_PATH', ROOT_PATH.'/temp');define('ASSETS_PATH', ROOT_PATH.'/assets');lib/BairongAPI.php<?phprequire_once ROOT_PATH.'/config/constants.php';class BairongAPI{ // ... 保持原有的BairongAPI类代码不变 ... // 只需将硬编码的配置改为使用常量,如: private $apiCode = API_CODE; private $appKey = APP_KEY; // ... 其他代码不变 ...}那么也就是 将我们在 constants.php中定义的常量 改过来 lib/PDFGenerator.php<?phprequire_once ROOT_PATH.'/vendor/autoload.php';require_once ROOT_PATH.'/config/constants.php';class PDFGenerator{ // ... 保持原有的PDFGenerator类代码不变 ... // 修改logo路径使用常量: $logoFile = ASSETS_PATH.'/images/logo.png'; // ... 其他代码不变 ...}这个就是主要的 类,其实我们之前就没有方logo 不过我们可以放个logo后面 index.php<?phprequire_once __DIR__.'/config/constants.php';require_once __DIR__.'/vendor/autoload.php';require_once __DIR__.'/lib/BairongAPI.php';require_once __DIR__.'/lib/PDFGenerator.php';// 确保临时目录存在if (!file_exists(TEMP_PATH)) { mkdir(TEMP_PATH, 0755, true);}// ... 保持原有的表单处理逻辑 ...// 修改PDF导出部分的文件路径:$pdfFile = TEMP_PATH.'/verify_result_'.date('YmdHis').'.pdf';// ... 其余代码不变 ...接下来这个是入口文件,index 我们修改为以下内容 改好后报错 Parse error: syntax error, unexpected token “<”, expecting end of file in /www/wwwroot/bairong.youyacao.com/lib/PDFGenerator.php on line 320 这个错误是因为在 PDFGenerator.php 类文件中直接包含了 HTML 代码,这是不允许的。HTML 导出按钮的代码应该放在 index.php 文件中,而不是 PDF 生成类中。 修正方案1. 修改 lib/PDFGenerator.php删除文件末尾的 HTML 代码部分,确保类文件只包含 PHP 代码: <?phprequire_once ROOT_PATH.'/vendor/autoload.php';require_once ROOT_PATH.'/config/constants.php';class PDFGenerator{ // ... 保持原有的 PDFGenerator 类代码 ... // 确保文件末尾没有 ?> 闭合标签和 HTML 代码 // 类定义结束后不要有任何其他内容}2. 在 index.php 中添加导出按钮在 index.php 的结果显示区域添加导出按钮代码: <!-- 在 index.php 的结果显示区域添加 --><?php if (isset($result)): ?> <?php echo (new BairongAPI())->formatResult($result); ?> <?php if (!isset($result['error'])): ?> <div class="mt-4 text-center"> <form method="post" style="display: inline;"> <input type="hidden" name="name" value="<?php echo htmlspecialchars($_POST['name'] ?? ''); ?>"> <input type="hidden" name="id_number" value="<?php echo htmlspecialchars($_POST['id_number'] ?? ''); ?>"> <input type="hidden" name="phone" value="<?php echo htmlspecialchars($_POST['phone'] ?? ''); ?>"> <button type="submit" name="export_pdf" class="btn btn-danger"> <i class="fas fa-file-pdf me-2"></i>导出PDF报告 </button> </form> </div> <?php endif; ?><?php endif; ?>3. 完整修正后的 lib/PDFGenerator.php<?phprequire_once ROOT_PATH.'/vendor/autoload.php';require_once ROOT_PATH.'/config/constants.php';class PDFGenerator{ /** * 生成查询结果PDF * @param array $result 查询结果数据 * @param array $queryParams 查询参数(姓名、身份证、手机号) * @return string PDF文件路径 */ public static function generateResultPDF($result, $queryParams) { // 创建TCPDF实例 $pdf = new TCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true, 'UTF-8', false); // 设置文档信息 $pdf->SetCreator('优雅草科技'); $pdf->SetAuthor('优雅草科技'); $pdf->SetTitle('百融云信息验证报告'); $pdf->SetSubject('信息验证结果'); $pdf->SetKeywords('百融云, 信息验证, 优雅草科技'); // 设置默认等宽字体 $pdf->SetDefaultMonospacedFont('courier'); // 设置边距 $pdf->SetMargins(15, 15, 15); $pdf->SetHeaderMargin(5); $pdf->SetFooterMargin(10); // 设置自动分页 $pdf->SetAutoPageBreak(TRUE, 25); // 设置图像比例 $pdf->setImageScale(PDF_IMAGE_SCALE_RATIO); // 添加页面 $pdf->AddPage(); // 生成封面 self::generateCoverPage($pdf, $queryParams); // 添加新页面放置详细内容 $pdf->AddPage(); // 生成基本信息部分 self::generateBasicInfo($pdf, $result, $queryParams); // 生成验证结果部分 self::generateVerificationResult($pdf, $result); // 生成手机验证部分 self::generatePhoneVerification($pdf, $result); // 生成特殊名单部分 self::generateSpecialList($pdf, $result); // 定义输出文件名 $filename = 'verify_result_'.date('YmdHis').'.pdf'; $filepath = TEMP_PATH.'/'.$filename; // 输出PDF文件 $pdf->Output($filepath, 'F'); return $filepath; } // ... 保持其他方法不变 ... // 注意:不要在此文件末尾包含任何HTML代码或PHP闭合标签}4. 完整实现流程初始化项目: mkdir myprojectcd myproject安装依赖: composer require tecnickcom/tcpdf创建目录结构: mkdir -p config lib temp assets/{css,js,images}添加配置文件: - 将上面的constants.php放入config/目录
- 将企业logo图片放入assets/images/目录
添加类文件: - 将BairongAPI.php放入lib/目录
- 将PDFGenerator.php放入lib/目录
设置权限: chmod -R 755 temp/修改index.php: 测试运行: - 确保PHP环境正常运行(建议PHP 7.4+)
- 访问index.php进行测试
5. 关键注意事项字体支持: - TCPDF默认不包含中文字体,需要手动添加
- 可以从vendor/tecnickcom/tcpdf/fonts/目录中选择或添加新字体
临时目录: - 确保Web服务器对temp/目录有写入权限
- 定期清理临时文件(可以设置cron任务)
生产环境: - 禁用测试环境URL
- 启用SSL证书验证
- 限制PDF生成频率防止滥用
错误处理: 性能优化: - 对于高并发场景,考虑缓存PDF结果
- 使用opcache提升PHP性能
完整修改后 我们成功可以访问了 也可以进行查询了 本项目完整了整个功能。
|