PHP项目怎么实现电子签名？

wen java案例 2026-07-24 3

PHP项目实现电子签名的完整指南：从原理到实战

目录导读

电子签名的基础概念与法律效力
PHP实现电子签名的核心技术栈
主流方案对比：自建签名 vs 第三方API
实战步骤：基于OpenSSL生成数字签名
代码示例：签名生成与验证全过程
常见问答与性能优化建议
安全注意事项与合规性检查

电子签名的基础概念与法律效力

电子签名并非简单的“手写图片上传”，而是基于非对称加密算法的数字签名技术，根据《电子签名法》，可靠的电子签名需满足：签名人专有、签署时仅由签名人控制、签署后对签名任何改动能被发现，在PHP项目中实现电子签名，本质上是通过公钥基础设施（PKI）对文档进行哈希加密，确保完整性、真实性和不可抵赖性。

PHP项目怎么实现电子签名？

关键术语：

私钥：签名方独有，用于生成签名
公钥：公开验证，用于校验签名
哈希值：文档的“数字指纹”

PHP实现电子签名的核心技术栈

组件	推荐方案	用途
加密扩展	OpenSSL（PHP内置）	签名生成与验证
哈希算法	SHA-256（常用）	文档摘要计算
文档格式	PDF（带签名域）、JSON	常见签署对象
证书格式	X.509（PEM/P12）	身份凭证

PHP可通过 openssl_sign() 和 openssl_verify() 函数快速集成签名逻辑，无需额外依赖。

主流方案对比：自建签名 vs 第三方API

维度	自建（OpenSSL）	第三方API（如e签宝）
成本	免费（仅服务器开销）	按次收费
开发周期	3-5天	1-2天对接
法律效力	依赖证书权威性	内置CA认证
灵活性	完全控制算法	受接口限制
适用场景	企业内部系统	对公合同、严监管场景

中小型项目优先自建签名方案；涉及外部法律纠纷的合同签署建议使用第三方。

实战步骤：基于OpenSSL生成数字签名

1 准备密钥对

# 生成私钥（带密码保护）
openssl genrsa -aes256 -out private.pem 2048
# 提取公钥
openssl rsa -in private.pem -pubout -out public.pem

2 PHP签名流程

读取待签署文档 → 计算SHA-256哈希
使用私钥对哈希值加密 → 生成base64编码的签名串
将签名串附加到文档头部或独立存储

3 PHP验证流程

提取文档的原始哈希值
使用公钥解密签名串 → 得到解密后的哈希
比对两个哈希值是否一致

代码示例：签名生成与验证全过程

<?php
class DigitalSigner {
    private $privateKey;
    private $publicKey;
    public function __construct($privKeyPath, $pubKeyPath) {
        $this->privateKey = openssl_get_privatekey(file_get_contents($privKeyPath), 'yourPassword');
        $this->publicKey = openssl_get_publickey(file_get_contents($pubKeyPath));
    }
    // 生成签名
    public function sign($data) {
        $hashed = hash('sha256', $data, true);
        openssl_sign($hashed, $signature, $this->privateKey, OPENSSL_ALGO_SHA256);
        return base64_encode($signature);
    }
    // 验证签名
    public function verify($data, $signature) {
        $hashed = hash('sha256', $data, true);
        $decodedSig = base64_decode($signature);
        return openssl_verify($hashed, $decodedSig, $this->publicKey, OPENSSL_ALGO_SHA256) === 1;
    }
}
// 使用示例
$signer = new DigitalSigner('private.pem', 'public.pem');
$document = file_get_contents('contract.pdf');
$sig = $signer->sign($document);
echo "签名结果: " . $sig . "\n";
echo "验证结果: " . ($signer->verify($document, $sig) ? '有效' : '无效');
?>

注意：实际项目中需添加错误处理，且私钥应存储在环境变量或HSM硬件中。