如何在phpseclib中使用带密码的私钥及非RSA算法密钥？

phpseclib 3.x 原生支持带密码加密的OpenSSH格式私钥，也支持ECDSA、Ed25519等非RSA密钥算法，你遇到的phpseclib3\Exception\NoKeyLoadedException异常通常是加载逻辑细节问题，可按照以下步骤排查修复：

带密码私钥加载失败排查 #

• 确认私钥内容完整：使用file_get_contents读取私钥文件时，先校验返回结果不为空，确保私钥包含完整的-----BEGIN OPENSSH PRIVATE KEY-----头部、-----END OPENSSH PRIVATE KEY-----尾部，且未丢失换行符。文件路径错误、权限不足导致读取内容不完整是最常见的报错原因。
• 确认密码传入正确：load()方法的第二个参数为私钥密码，需确保传入的是字符串类型，没有多余的空格、换行符等冗余内容。

ECDSA密钥加载失败排查 #

• 升级phpseclib到最新稳定版：3.0.12之前的版本存在ECDSA格式私钥适配缺陷，尤其是带密码的ECDSA密钥加载失败问题较多，升级到最新版本可解决绝大多数兼容性问题。
• 确认密钥使用标准曲线：ssh-keygen生成ECDSA密钥时仅支持NIST标准的P-256、P-384、P-521三种曲线，对应生成参数为-t ecdsa -b 256/384/521，非标准曲线的密钥无法被正常识别。

可正常运行的参考代码 #

<?php
use phpseclib3\Crypt\PublicKeyLoader;
use phpseclib3\Net\SFTP;

// 读取私钥文件
$privateKeyPath = '/your/private/key/path';
$privateKey = file_get_contents($privateKeyPath);
if (!$privateKey) {
    throw new \Exception('私钥读取失败，请检查路径与权限');
}

// 加载私钥，无密码则删除第二个参数即可
$loadedKey = PublicKeyLoader::load($privateKey, 'your_private_key_password');

// 建立SFTP连接并登录
$sftp = new SFTP('target_server_ip', 22);
if (!$sftp->login('ssh_username', $loadedKey)) {
    throw new \Exception('SFTP登录失败，请校验权限');
}

// 后续文件传输逻辑
// $sftp->put('/remote/path', '/local/path', SFTP::SOURCE_LOCAL_FILE);

注意：不要对私钥原始内容做转义、换行符替换等操作，存储在数据库、配置文件中的私钥需保持生成时的原始格式。

内容的提问来源于stack exchange，提问作者DevelJoe