matasarei/euspe

EUSign PHP 库的 OOP 接口

1.0.2 2024-08-26 18:24 UTC

This package is auto-updated.

Last update: 2024-08-26 18:25:39 UTC


README

CI workflow

EUSign PHP 库的 OOP 接口。 eusphpe 扩展包含在 版本发布 中。

使用方法

类似于 euspe_* 函数,但具有 OOP 接口。

解密已签名的数据

$crypto = new Matasar\Euspe\Crypto(); // initializes the library

// similar to EUSignTest.php \develop()
$result = $crypto->develop('path/to/private_key', 'password', 'encrypted_data');
var_dump($result->signInfo->data); // decrypted data

哈希数据以供签名

$crypto = new Matasar\Euspe\Crypto();

$hash = $crypto->hash('path/to/file', true); // hash a file
var_dump(base64_encode($hash));

$hash = $crypto->hash('qwerty', false); // hash a string
var_dump(base64_encode($hash));

测试和开发

测试不应该也不做任何真正的加密测试,因为这只是一个库的包装器。

  1. 安装供应商
docker run --rm -v $(pwd):/app -w /app composer:lts composer install --ignore-platform-reqs

重要

需要 --ignore-platform-reqs 标志以避免 ext-eusphpe 的要求。

  1. 运行测试
docker run --rm -v $(pwd):/app -w /app composer:lts vendor/bin/phpunit

安装 EUSign 库的建议

  1. 解压并复制库文件
cp .../eusphpe.ini /etc/php/7.4/mods-available/eusphpe.ini
cp -R .../eusphpe_extension /usr/lib/php/eusphpe_extension
  1. 创建指向配置文件的符号链接
ln -s /etc/php/7.4/mods-available/eusphpe.ini /etc/php/7.4/fpm/conf.d/20-eusphpe.ini
ln -s /etc/php/7.4/mods-available/eusphpe.ini /etc/php/7.4/cli/conf.d/20-eusphpe.ini
  1. 重新启动 FPM 服务
  2. 如果您有证书,请安装它们(默认在 /data/certificates 中,见 osplm.ini
ls -la /data/certificates/
-rw-rw-r-- 1 root root 876543 Feb 24 2022 CACertificates.p7b
-rw-rw-r-- 1 root root  12345 Feb 24 2022 CAs.json
-rw-rw-r-- 1 root root   1234 Feb 24 2022 EU-xxxxxx.cer
-rw-rw-r-- 1 root root   1234 Feb 24 2022 EU-xxxxxx.cer

重要

您可能需要原始的 osplm.ini 文件而不是库演示中提供的文件。由于 eusphpe 扩展针对 x86_64 架构编译,因此它不能在 ARM 上原生运行。