Laravel收到账单PDF后,先确认提取字段,再写入业务表

账单PDF识别出金额后,不应立即写入正式业务表。先把候选字段和原文件放在一起确认,能避免将缺失日期、零折扣或错误金额静默带入系统。
本例用教学账单BILL-271,金额135.60元、折扣0.00、到期日未填写。
解析结果与候选字段分开
先用ComPDF全文解析接口取得实际输出。本次JSON包含正文和表格;应用再针对这个教学模板提取金额与折扣。不要把应用的正则映射说成接口已经直接返回了账单业务对象。
本次实际解析结果的相关部分如下,只省略了坐标和其他内容,没有把字段改成自定义业务对象。可先保存为invoice.json,复现候选映射与确认测试:
{
"result": {
"pages": [
{
"page_id": 1,
"structured": [
{
"type": "paragraph_title",
"text": "## 教学账单 BILL-271"
},
{
"type": "text",
"text": "供应商:教学服务方。账单号:BILL-271。实付金额:135.60。币种:CNY。折扣金额:0.00。到期日未填写。"
}
]
}
]
}
}
在本地运行完整确认示例
准备PHP 8.4.1以上及Laravel正常扩展,尤其是mbstring与PDO SQLite。新建空目录,保存以下composer.json:
{"require":{"php":"^8.4.1","laravel/framework":"12.69.3"}}
composer install
mkdir -p bootstrap/cache storage/framework/views storage/logs
把下面完整程序保存为review-check.php。第二个参数是原文件,只用于生成本地去重测试的文件哈希;复现应用测试时可以用自己的小型PDF作为输入,但不能据此声称其内容已经被解析。
<?php
use Illuminate\Foundation\Application;
use Illuminate\Contracts\Console\Kernel;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\ValidationException;
require __DIR__.'/vendor/autoload.php';
try {
$app=Application::configure(basePath: __DIR__)->create();$app->make(Kernel::class)->bootstrap();
$app['config']->set('database.default','sqlite');
$app['config']->set('database.connections.sqlite',['driver'=>'sqlite','database'=>':memory:','prefix'=>'']);
DB::statement('CREATE TABLE reviewed (id INTEGER PRIMARY KEY, source_hash TEXT UNIQUE NOT NULL, amount TEXT NOT NULL, discount TEXT NOT NULL, due_date TEXT NULL)');
// These candidates are mapped by the application from this teaching sample's parsed text.
$parsed=json_decode(file_get_contents($argv[1]),true,512,JSON_THROW_ON_ERROR);
$text=implode("\n",array_column($parsed['result']['pages'][0]['structured'],'text'));
if(!preg_match('/实付金额:([0-9.]+)/u',$text,$a)||!preg_match('/折扣金额:([0-9.]+)/u',$text,$b))throw new RuntimeException('Missing expected fields');
$candidate=['amount'=>$a[1],'discount'=>$b[1],'due_date'=>null];
$hash=hash_file('sha256',$argv[2]);
function confirm(array $input,string $hash):int {
$v=Validator::make($input,['amount'=>['required','regex:/^\d+\.\d{2}$/'],'discount'=>['required','regex:/^\d+\.\d{2}$/'],'due_date'=>['nullable','date_format:Y-m-d']])->validate();
return DB::transaction(function()use($hash,$v){
$old=DB::table('reviewed')->where('source_hash',$hash)->first();
if($old)return (int)$old->id;
return DB::table('reviewed')->insertGetId(['source_hash'=>$hash,'amount'=>$v['amount'],'discount'=>$v['discount'],'due_date'=>$v['due_date']??null]);
});
}
$before=DB::table('reviewed')->count();$first=confirm($candidate,$hash);$again=confirm($candidate,$hash);
$checks=['nothing_saved_before_confirmation'=>$before===0,'duplicate_confirmation_same_record'=>$first===$again&&DB::table('reviewed')->count()===1,'zero_discount_preserved'=>DB::table('reviewed')->first()->discount==='0.00','missing_date_stays_null'=>DB::table('reviewed')->first()->due_date===null];
try{confirm(['amount'=>'not-a-number','discount'=>'0.00'],'other');$checks['invalid_amount_rejected']=false;}catch(ValidationException $e){$checks['invalid_amount_rejected']=true;}
if(in_array(false,$checks,true))throw new RuntimeException('Review test failed');
echo json_encode(['php'=>PHP_VERSION,'laravel'=>$app->version(),'candidate'=>$candidate,'checks'=>$checks],JSON_PRETTY_PRINT|JSON_UNESCAPED_UNICODE).PHP_EOL;
} catch (Throwable $e) { fwrite(STDERR, get_class($e).': '.$e->getMessage().PHP_EOL); exit(1); }
php review-check.php invoice.json input.pdf
这一步使用正文中的实际解析片段,不重新调用ComPDF API。先观察候选为135.60、0.00、null,再看五项检查是否全部为true。它验证的是应用确认层,不代表你新放入的PDF已得到同样的识别结果。
接入自己的账单时,应先调用全文解析接口,取回并解压真正的结果,再以该PDF及其结果成对运行。这个模板使用中文标签匹配金额,换模板后必须调整映射与缺项处理;匹配不到就停止,不能用默认零值补齐。
确认后才进入事务
金额用带两位小数的字符串校验,本例存储也用字符串;生产表可以选择适当的定点类型。不要先转成浮点数再计算。
$validated = Validator::make($input, [
'amount' => ['required', 'regex:/^\d+\.\d{2}$/'],
'discount' => ['required', 'regex:/^\d+\.\d{2}$/'],
'due_date' => ['nullable', 'date_format:Y-m-d'],
])->validate();
0.00是明确的零值,未填写的到期日保持null。确认接口还应使用应用既有的登录、权限和CSRF保护;教学CLI没有替代这些入口控制。

图:原文值、候选字段与确认要求逐项对应;依据实际解析及Laravel测试整理,非产品界面
确认界面应让人核对什么
只显示两个输入框,确认人员仍不知道它们从哪里来。界面至少把原页、原文标签、币种、候选值和修改后值放在一起;缺失日期显示“原件未提供”,不要预填今天。存储时保留原解析片段与确认记录,人工补充的日期标记为人工输入。
例如折扣0.00是明确数字,不能用PHP的empty()把它和空字符串、null混为一谈。金额校验通过只说明格式正确,仍需核对该字段是否对应实付金额,以及币种、业务期间和单据编号。
重复确认不要重复建记录
教学表对源文件哈希设置唯一约束,同一文件再次确认返回已有记录。正式应用还应加上租户范围和业务版本规则;文件内容相同并不总表示业务操作相同。
确认写入放在事务内,并记录原始解析结果与人工修改,不覆盖原件。示例只覆盖顺序重复确认,不用它证明并发请求已经处理完善。
验收读回的数据
本次PHP 8.4.27、Laravel 12.69.3检查通过:确认前没有记录、重复确认只有一条、折扣仍是0.00、日期仍为空、非法金额被拒绝。框架检查与ComPDF解析结果要分别保存,便于定位问题。
后续需要多模板、分类或更完整处理流程时,可评估DocSlight。本例没有测试DocSlight企业功能,也没有作财务合规或全自动入账承诺。
本作品采用《CC 协议》,转载必须注明作者和本文链接
关于 LearnKu
推荐文章: