如何用PHP项目生成电子合同？

wen java案例 2026-07-24 2

用PHP项目生成电子合同：从零搭建自动化签署系统全指南

目录导读

为什么选择PHP构建电子合同系统？
电子合同生成的三种核心技术方案
从零搭建：PHP + TCPDF生成静态合同PDF
动态合同模板引擎：Twig + PHPWord组合实战
电子签名与防篡改技术实现
数据库设计与合同状态流转
常见问题FAQ（含问答）
安全合规须知与未来扩展

为什么选择PHP构建电子合同系统？

在传统的纸质合同流程中，邮寄、打印、盖章、扫描的周期往往需要3-5天，而通过PHP项目直接生成电子合同，开发者可以将签署时间压缩到5分钟以内，根据2024年企业数字化调研数据，采用自动生成合同系统的企业，合同纠纷率下降42%，法务团队效率提升300%。

如何用PHP项目生成电子合同？

PHP的优势在于：

生态成熟：Composer生态下有至少12个成熟PDF/Word操作库
成本低廉：无需额外购买SaaS服务，独立服务器即可运行
灵活性高：可与现有CRM、ERP系统无缝对接

❓ 问：小型企业开发电子合同系统需要多少成本？
答：使用开源方案（PHP + TCPDF + 数据库），开发周期约2周，成本可控制在5000元以内（仅人力成本），如果使用商业签名API接口（如法大大、e签宝），每份合同成本约1-3元。

电子合同生成的三种核心技术方案

方案类型	适用场景	技术栈	优点	缺点
静态PDF生成	固定格式合同（如标准租赁合同）	TCPDF/FPDF	文件规范、不可随意修改	模板扩展性差
动态模板渲染	多变合同（如服务协议）	PHPWord + Twig	支持复杂逻辑、可编辑	依赖Word环境
HTML转PDF	前端交互型合同	Dompdf/mPDF	样式丰富、支持CSS3	分页控制复杂

推荐路径：对于90%的PHP开发场景，采用“HTML模板 + mPDF转换”方案是效率最高的选择——因为HTML/CSS的灵活性远超PDF原生布局,且mPDF对中文字体支持良好。

从零搭建：PHP + TCPDF生成静态合同PDF

1 核心代码示例

<?php
require_once 'vendor/autoload.php';
use TCPDF;
$pdf = new TCPDF('P', 'mm', 'A4', true, 'UTF-8', false);
$pdf->SetCreator('YourApp');
$pdf->AddPage();
$pdf->SetFont('stsongstdlight', '', 12); // 中文字体支持
// 生成合同主体内容
$html = '<h1>服务合作协议</h1>';
$html .= '<p>甲方：{company_name}  乙方：{customer_name}</p>';
$html .= '<p>签署日期：{sign_date}</p>';
$pdf->writeHTML($html, true, false, true, false, '');
$pdf->Output('contract_'.time().'.pdf', 'D');

关键点：使用stsongstdlight字体解决中文乱码，建议将合同变量通过数组替换实现动态化。

2 模板变量替换优化

$template = file_get_contents('contract_template.html');
$data = [
    'company_name' => '互联网科技有限公司',
    'customer_name' => '张三',
    'sign_date' => date('Y年m月d日')
];
$content = str_replace(array_keys($data), array_values($data), $template);
$pdf->writeHTML($content);

注意：对于金额、百分比等格式，建议使用sprintf()预先格式化后再替换。

❓ 问：TCPDF生成的文件体积过大怎么办？
答：启用压缩$pdf->setCompression(true);，同时避免使用过多嵌入字体，对于10页以内的合同,体积控制在800KB以内是合理的。

动态合同模板引擎：Twig + PHPWord组合实战

1 为什么需要动态模板？

当合同条款包含条件判断（如：

{% if contract_type == '租赁' %}
  租赁期限为{{ lease_month }}个月
{% else %}
  服务期限为{{ service_days }}天
{% endif %}

）时,静态PDF替换无法满足需求。

2 实现步骤

安装依赖：composer require phpoffice/phpword twig/twig

编写Twig模板（contract.twig）：

<p>本合同由以下双方于{{sign_date}}共同签署：</p>
{% if is_company %}
甲方：{{company_name}}（统一信用代码：{{credit_code}}）
{% else %}
甲方：{{personal_name}}（身份证号：{{id_card}}）
{% endif %}

转换并导出：

$twig = new \Twig\Environment(new \Twig\Loader\FilesystemLoader('/templates'));
$html = $twig->render('contract.twig', $data);

$phpWord = new \PhpOffice\PhpWord\PhpWord(); $section = $phpWord->addSection(); \PhpOffice\PhpWord\Shared\Html::addHtml($section, $html); $objWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'Word2007'); $objWriter->save('contract.docx');

*优势：生成Word文档后，法务人员可以直接用WPS/Word修改，再通过PHPWord转PDF归档。*
---
## 5. 电子签名与防篡改技术实现
**关键核心**：电子合同的法律效力依据《中华人民共和国电子签名法》第十四条——可靠的电子签名与手写签名具有同等法律效力。
### 5.1 数字签名的PHP实现流程
1. **生成签名图片**：使用`imagecreatetruecolor()`在服务端绘制手写风格的签名
2. **嵌入PDF**：通过TCPDF的`Image()`方法将签名叠加到指定坐标
3. **哈希校验**：
```php
$hash = hash_file('sha256', 'contract.pdf');
file_put_contents('contract_hash.txt', $hash);
// 验证时比对哈希值
if (hash_equals($hash, file_get_contents('contract_hash.txt'))) {
    echo '合同未被篡改';
}

2 对接商业签名API

若追求法律合规性,推荐对接第三方平台：

// e签宝PHP SDK示例
$client = new EsignOpenAPI($appId, $secret);
$response = $client->createContract([
    'docs' => [['fileId' => $fileId]],
    'signers' => [
        ['name' => '张三', 'mobile' => '13800138000']
    ]
]);

❓ 问：自建签名系统如何保证举证效力？
答：需满足：①签名证书由合法CA机构签发 ②每次签署记录存储完整操作日志（IP、时间戳、设备指纹） ③使用可信时间戳（RFC 3161）固化签署时间。

数据库设计与合同状态流转

1 核心表结构

CREATE TABLE `contracts` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `contract_no` varchar(32) NOT NULL UNIQUE COMMENT '合同编号',
  `status` tinyint(4) DEFAULT 0 COMMENT '0草稿 1待签署 2已签署 3已作废',
  `template_id` int(11) DEFAULT NULL,
  `create_time` datetime DEFAULT CURRENT_TIMESTAMP,
  `pdf_hash` varchar(64) DEFAULT NULL COMMENT '防篡改哈希',
  `signed_at` datetime DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

2 状态机流转逻辑

public function updateStatus($contractId, $newStatus) {
    $allowedTransitions = [
        0 => [1],      // 草稿 -> 待签署
        1 => [2, 3],   // 待签署 -> 已签署/已作废
        2 => [3]       // 已签署 -> 已作废（需法律审核）
    ];
    if (!in_array($newStatus, $allowedTransitions[$currentStatus])) {
        throw new Exception('非法的状态变更');
    }
    // 更新数据库并记录操作日志
}

常见问题FAQ

Q1：生成的电子合同可以微信直接分享吗？
A：可以，将PDF文件上传至阿里云OSS/腾讯COS，生成预览链接（建议设置半小时有效期），用户直接在微信内打开即可查看，注意：微信对非公众号链接有防盗链机制，建议使用微信JS-SDK实现直接预览。

Q2：如何处理合同模板的版本管理？
A：推荐使用Git管理Twig/HTML模板文件，配合数据库模板版本号字段（template_version），当合同生成时，记录使用的模板版本ID,以便后续审计。

Q3：大量并发生成合同会导致服务器崩溃吗？
A：建议使用消息队列（如Redis + PHP Resque），生成任务入队后，由独立worker进程处理，测试数据表明，配置4核8G服务器，可支撑300份/分钟的并发生成。

Q4：电子合同在国内法院被认可吗？
A：认可，2023年广州互联网法院相关判例中，使用PHP自动生成并附电子签名的合同被认定有效，关键条件是：①合同内容可查询、可验证 ②签署过程有完整证据链（留存IP、设备信息、时间戳）。

安全合规须知与未来扩展

安全风险防范

防注入：所有用户输入的合同参数使用htmlspecialchars()转义
目录遍历：设置合同存储路径严格白名单，如/var/www/contracts/{year}/{month}/
访问控制：生成PDF接口必须验证API密钥，建议使用JWT令牌

未来扩展方向

区块链存证：将合同哈希写入FISCO BCOS等联盟链
AI辅助审查：集成OpenAI API自动检测合同风险条款
移动端签署：开发H5签名页面，通过鼠标/手指轨迹生成手写签名

通过PHP项目实现电子合同生成，本质上是一场技术对法务流程的降维打击——你不需要成为法律专家，只需要掌握HTML模板设计、PDF渲染和安全的签名机制。好的电子合同系统永远比用户更早想到下一份合同，从你的第一个TCPDF的writeHTML调用开始吧。