本文介绍在 php 7.4.3 环境下，利用内置的 sodium 扩展（无需 openssl）实现 ed25519 数字签名的方法，涵盖私钥解析、消息签名与签名输出全流程，并提供可直接运行的示例代码。
本文介绍在 php 7.4.3 环境下，利用内置的 sodium 扩展（无需 openssl）实现 ed25519 数字签名的方法，涵盖私钥解析、消息签名与签名输出全流程，并提供可直接运行的示例代码。
PHP 原生 openssl_sign() 函数确实不支持 Ed25519（截至 OpenSSL 3.0 之前版本），但自 PHP 7.2.0 起，Sodium 扩展已作为核心加密组件默认启用并深度集成，其底层基于 libsodium，原生支持高性能、抗侧信道攻击的 Ed25519 签名算法。
要完成 Ed25519 签名，关键在于正确处理密钥格式：问题中提供的私钥是 Base64 编码的十六进制字符串（实际为 64 字节原始私钥的 Base64 表示），需先 Base64 解码，再 hex2bin() 转为二进制 —— 这是因为 Sodium 的 sodium_crypto_sign_detached() 严格要求输入 32 字节的原始私钥（Ed25519 私钥长度为 32 字节；注意：此处给出的 Base64 字符串解码后若为 64 字节，说明它可能是「扩展私钥」（即 seed + pubkey 拼接），而 Sodium 仅需前 32 字节 seed。实践中更推荐使用 sodium_crypto_sign_keypair() 生成标准密钥对，或确认输入私钥是否为纯 seed）。
以下是完整、安全、可复用的签名示例：
<?php
// 示例私钥（Base64 编码的 32 字节 seed，注意：请确保此为真实 seed，非扩展私钥）
$base64_private_seed = 'Y2E3YjYwYzRjMDRjMjk1ZDQ5ZTQzM2RlMTdjZjVkNGE0NGFjYzJmM2IzOWExNWZhMjViNGE4ZWJiZDBiMDVkYTIwNGU4MWE3ZWZmMTQ0NGE2ZmM2NjExNzRmNTY4M2I0YmYyMTk5YTkyY2UzOWRkZjdmMzhkNTFjYTNmM2Q3ZDU=';
// 步骤 1：Base64 解码 → 得到 64 字节字符串（若为扩展私钥）或 32 字节（若为纯 seed）
$decoded = base64_decode($base64_private_seed);
// 步骤 2：验证长度并提取有效 seed（Ed25519 签名仅需前 32 字节）
if (strlen($decoded) >= 32) {
$private_key = substr($decoded, 0, 32); // 取前 32 字节作为 seed
} else {
throw new InvalidArgumentException('Invalid private key length: expected at least 32 bytes.');
}
// 步骤 3：待签名消息
$message = "Hello!";
// 步骤 4：执行 Ed25519 分离式签名（返回二进制签名）
$signature = sodium_crypto_sign_detached($message, $private_key);
// 步骤 5：输出十六进制格式便于传输/存储
echo "Signature (hex): " . bin2hex($signature) . "\n";
// 输出示例：a1b2c3...（64 字节 hex 字符串）
// ✅ 验证签名（可选，用于调试）
$public_key = sodium_crypto_sign_publickey_from_secretkey($private_key);
$is_valid = sodium_crypto_sign_verify_detached($signature, $message, $public_key);
var_dump($is_valid); // bool(true)
?>⚠️ 重要注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 密钥安全性：切勿在代码中硬编码私钥；应通过环境变量、安全密钥管理服务或受控配置文件加载。
- 密钥格式澄清：Ed25519 私钥本质是 32 字节随机 seed。若你持有的 Base64 字符串解码后为 64 字节，它很可能是「扩展私钥」（seed + public key），此时必须截取前 32 字节；否则将导致 sodium_crypto_sign_detached() 报错或签名无效。
- PHP 版本兼容性：PHP 7.4.3 完全支持 Sodium，但请确认扩展已启用：运行 php -m | grep sodium 或检查 phpinfo() 中 Sodium 模块状态。
- 签名类型选择：sodium_crypto_sign_detached() 生成分离式签名（签名与消息独立），适用于需要单独传输签名的场景；如需签名内联消息，可用 sodium_crypto_sign()，但会返回拼接后的二进制数据。
掌握 Sodium 的 Ed25519 签名能力，是构建现代 Web 应用零信任身份验证、API 请求完整性校验及区块链交互的基础技能。务必结合公钥验证步骤进行端到端测试，确保签名流程鲁棒可靠。
