phpseclib 3.x SSH2/SFTP连接自动断开，求持久化解决方案

核心问题分析 #

你遇到的连接自动断开，除了__destruct调用disconnect()外，更可能是对象被PHP垃圾回收机制回收（即使移除析构函数，对象无引用时仍会被销毁，底层连接也会断开），或者服务器端主动超时。以下是可行解决方案：

方案1：继承重写析构函数 + 单例容器持有对象 #

不要直接修改phpseclib源码，通过继承类空实现析构函数，同时在Spryker的依赖注入容器中将实例注册为单例，确保对象始终有引用不会被回收：

// 自定义SFTP类，重写析构函数
class PersistentSFTP extends \phpseclib3\Net\SFTP
{
    public function __destruct()
    {
        // 空实现，不自动调用disconnect()
    }
}

// 在你的DependencyProvider中注册为单例
public function provideBusinessLayerDependencies(Container $container): Container
{
    $container->setShared('persistent.sftp.client', function () {
        $ssh = new \phpseclib3\Net\SSH2('your-sftp-host');
        if (!$ssh->login('username', 'password')) {
            throw new \RuntimeException('SFTP login failed');
        }
        // 启用保活（调整参数适配服务器）
        $ssh->setKeepAlive(30, 5);
        
        return new PersistentSFTP($ssh);
    });
    
    return $container;
}

之后在业务逻辑中通过容器获取这个单例对象，连接会一直保持，直到你手动调用$sftp->disconnect()。

方案2：手动维持对象引用 + 定期保活 #

如果无法用单例容器，确保在需要保持连接的整个生命周期内，SFTP/SSH2对象始终被变量引用（比如存储在全局数组、Spryker的Session容器中）。同时定期执行轻量操作避免服务器主动断开：

// 存储对象到Spryker Session（Web环境）
$session = $container->get(SessionClientInterface::class);
$session->set('sftp_connection', $sftpClient);

// 定期执行保活操作（比如每25秒执行一次）
function keepSftpAlive($sftpClient)
{
    // 执行无副作用的操作，比如获取当前目录
    $sftpClient->pwd();
}

方案3：排查服务器端超时配置 #

即使客户端启用保活，部分SFTP服务器会强制断开长时间连接。联系服务器管理员确认：

• SSH服务器的ClientAliveInterval和ClientAliveCountMax配置
• SFTP服务的连接超时限制

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