本文介绍在 php 7.4 环境下，利用内置的 sodium 扩展（无需 openssl）实现 ed25519 签名的方法，包括私钥解析、签名生成与输出，并强调安全编码注意事项。
本文介绍在 php 7.4 环境下，利用内置的 sodium 扩展（无需 openssl）实现 ed25519 签名的方法，包括私钥解析、签名生成与输出，并强调安全编码注意事项。
Ed25519 是一种高性能、高安全性的椭圆曲线数字签名算法，广泛用于现代密码学实践（如 SSH、TLS 1.3、区块链等）。PHP 自 7.2.0 起原生集成 Sodium 扩展（基于 libsodium），完全支持 Ed25519 —— 无需依赖外部工具或不稳定的第三方库，也无需配置 OpenSSL（其确实在 7.4 及更早版本中不支持 Ed25519）。
要正确使用 Ed25519 签名，关键在于理解密钥格式与函数语义：Sodium 要求私钥为 32 字节原始二进制（即 Ed25519 的 secret key，非 PKCS#8 或 PEM 封装格式）。你提供的 Base64 编码字符串实为 base64-encoded hex 表示的私钥（常见于某些 CLI 工具导出），因此需先 base64_decode，再 hex2bin 转为真正的二进制密钥。
以下是一个完整、可运行的签名示例：
<?php
// 示例私钥（Base64 编码的 hex 字符串）
$private_key_b64 = 'Y2E3YjYwYzRjMDRjMjk1ZDQ5ZTQzM2RlMTdjZjVkNGE0NGFjYzJmM2IzOWExNWZhMjViNGE4ZWJiZDBiMDVkYTIwNGU4MWE3ZWZmMTQ0NGE2ZmM2NjExNzRmNTY4M2I0YmYyMTk5YTkyY2UzOWRkZjdmMzhkNTFjYTNmM2Q3ZDU=';
// 步骤 1：解码为二进制私钥（32 字节）
$binary_private_key = hex2bin(base64_decode($private_key_b64));
if ($binary_private_key === false || strlen($binary_private_key) !== 32) {
throw new InvalidArgumentException('Invalid Ed25519 private key: must be exactly 32 bytes after decoding.');
}
// 步骤 2：待签名消息（任意 UTF-8 字符串，Sodium 自动处理字节流）
$message = "Hello!";
// 步骤 3：生成分离式签名（detached signature）
$signature = sodium_crypto_sign_detached($message, $binary_private_key);
// 步骤 4：输出十六进制格式便于调试或传输
echo "Signature (hex): " . bin2hex($signature) . "\n";
// 输出长度应为 64 字符（Ed25519 签名固定为 64 字节）
// ✅ 验证提示：配套验证需公钥（可从私钥派生：sodium_crypto_sign_publickey($binary_private_key)）
?>⚠️ 重要注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 密钥安全：切勿在代码中硬编码私钥；生产环境应通过安全配置管理器或环境变量注入，并严格限制文件权限。
- 密钥来源：确保输入私钥确实是 Ed25519 格式（32 字节 raw secret key）。若你持有的是 PEM 文件（如 -----BEGIN PRIVATE KEY-----），需先用 openssl pkey -in key.pem -ed25519 -text 提取 raw secret，或改用 sodium_crypto_sign_seed_keypair() 安全生成新密钥对。
- 函数选择：sodium_crypto_sign_detached() 返回仅签名字节（适合附加到消息后传输）；若需“签名+消息”绑定包，使用 sodium_crypto_sign()，但注意其输出含原始消息，体积更大。
- 扩展检查：执行前请确认 Sodium 已启用：var_dump(function_exists('sodium_crypto_sign_detached'));。若返回 false，请检查 php.ini 中是否启用了 extension=sodium（Windows 下可能为 extension=php_sodium.dll）。
掌握 Sodium 的 Ed25519 API，不仅可快速构建可信签名流程，也为后续实现密钥交换（X25519）、加密（crypto_box）等高级功能奠定基础。始终以二进制安全、密钥最小化暴露、输入校验为开发铁律。
