PHP在本地网络中安全传输文件（SCP）：两种实现方法详解

<?php
/**
 * 使用 shell_exec() 进行 SCP 文件传输
 *
 * 注意：实际使用时请替换为您的实际路径、用户名和IP。
 * 强烈推荐使用 SSH 密钥进行认证，而非在命令中暴露密码。
 */

// --- 配置参数 ---
$remoteUser = 'your_remote_username';
$remoteHost = '192.168.1.100'; // 远程主机的IP地址或域名
$sshKeyPath = '/path/to/your/private_ssh_key'; // 本地私钥文件的路径

// --- 上传文件示例 ---
$localFileToUpload = '/path/to/local/file_to_upload.txt'; // 本地待上传文件
$remoteDestinationPath = "/home/{$remoteUser}/uploaded_file.txt"; // 远程目标路径

if (!file_exists($localFileToUpload)) {
    echo "错误：本地文件 '{$localFileToUpload}' 不存在，无法上传。\n";
} else {
    // 构造 SCP 上传命令
    // -i 参数指定私钥文件，提高安全性并实现无密码认证
    $uploadCommand = "scp -i {$sshKeyPath} {$localFileToUpload} {$remoteUser}@{$remoteHost}:{$remoteDestinationPath}";

    echo "正在执行上传命令：{$uploadCommand}\n";
    $uploadOutput = shell_exec($uploadCommand . ' 2>&1'); // 重定向标准错误到标准输出

    if ($uploadOutput === null) {
        echo "上传命令执行失败或没有输出。\n";
    } else {
        echo "上传命令输出：\n";
        echo "<pre>{$uploadOutput}</pre>";
        // 可以根据输出内容判断是否成功，例如检查特定的成功消息或错误信息
        if (strpos($uploadOutput, 'No such file or directory') !== false) {
             echo "提示：远程路径可能不存在或权限不足。\n";
        } elseif (strpos($uploadOutput, 'Permission denied') !== false) {
             echo "提示：认证失败或权限不足。\n";
        } else {
             echo "提示：请检查输出判断上传结果。\n";
        }
    }
}

echo "\n----------------------------------------\n\n";

// --- 下载文件示例 ---
$remoteFileToDownload = "/home/{$remoteUser}/remote_file_to_download.txt"; // 远程待下载文件
$localDownloadPath = '/path/to/local/downloaded_file.txt'; // 本地保存路径

// 构造 SCP 下载命令
$downloadCommand = "scp -i {$sshKeyPath} {$remoteUser}@{$remoteHost}:{$remoteFileToDownload} {$localDownloadPath}";

echo "正在执行下载命令：{$downloadCommand}\n";
$downloadOutput = shell_exec($downloadCommand . ' 2>&1'); // 重定向标准错误到标准输出

if ($downloadOutput === null) {
    echo "下载命令执行失败或没有输出。\n";
} else {
    echo "下载命令输出：\n";
    echo "<pre>{$downloadOutput}</pre>";
    if (strpos($downloadOutput, 'No such file or directory') !== false) {
        echo "提示：远程文件可能不存在。\n";
    } elseif (strpos($downloadOutput, 'Permission denied') !== false) {
        echo "提示：认证失败或权限不足。\n";
    } else {
        echo "提示：请检查输出判断下载结果。\n";
    }
}
?>

composer require phpseclib/phpseclib

<?php
/**
 * 使用 phpseclib 库进行 SSH 连接和 SCP 文件传输
 *
 * 确保已通过 Composer 安装 phpseclib：composer require phpseclib/phpseclib
 */

require 'vendor/autoload.php'; // 引入 Composer 自动加载文件

use phpseclib3\Net\SSH2;
use phpseclib3\Net\SCP;

// --- 配置参数 ---
$host = '192.168.1.100'; // 远程主机IP或域名
$username = 'your_remote_username';
$password = 'your_remote_password'; // 远程主机的密码（不推荐用于生产环境）
$privateKeyPath = '/path/to/your/private_ssh_key'; // 本地私钥文件的路径

// 创建 SSH2 实例
$ssh = new SSH2($host);

// --- SSH 认证 ---
// 优先使用密钥认证（更安全，推荐用于生产环境）
try {
    // 加载私钥文件
    $key = \phpseclib3\Crypt\RSA::load(file_get_contents($privateKeyPath));
    if (!$ssh->login($username, $key)) {
        // 如果密钥认证失败，尝试密码认证（仅作示例，实际不建议混合使用）
        if (!$ssh->login($username, $password)) {
            exit("SSH 登录失败：密钥和密码认证均失败。\n");
        } else {
            echo "SSH 登录成功（密码认证）！\n";
        }
    } else {
        echo "SSH 登录成功（密钥认证）！\n";
    }
} catch (\Exception $e) {
    // 如果密钥文件有问题或无法加载，尝试密码认证
    echo "密钥加载或认证失败：{$e->getMessage()}\n";
    if (!$ssh->login($username, $password)) {
        exit("SSH 登录失败：密码认证失败。\n");
    } else {
        echo "SSH 登录成功（密码认证）！\n";
    }
}


// --- 执行远程命令示例 ---
echo "\n--- 执行远程命令 ---\n";
echo "执行 'pwd' 命令：\n";
echo $ssh->exec('pwd'); // 执行远程命令并获取输出

echo "\n执行 'ls -la' 命令：\n";
echo $ssh->exec('ls -la');

// --- SCP 文件传输示例 ---
$scp = new SCP($ssh); // 将已建立的 SSH2 连接传递给 SCP 实例

// 1. 上传文件
echo "\n--- 上传文件 ---\n";
$localFileToUpload = '/path/to/local/file_to_upload.txt'; // 本地待上传文件
$remoteDestinationPath = "/home/{$username}/uploaded_file_phpseclib.txt"; // 远程目标路径

if (file_exists($localFileToUpload)) {
    // put() 方法用于上传文件
    // 第一个参数是远程目标路径，第二个参数是本地文件路径或文件内容
    // SCP::SOURCE_LOCAL_FILE 指示第二个参数是本地文件路径
    if ($scp->put($remoteDestinationPath, $localFileToUpload, SCP::SOURCE_LOCAL_FILE)) {
        echo "文件 '{$localFileToUpload}' 已成功上传到 '{$remoteDestinationPath}'。\n";
    } else {
        echo "文件上传失败。错误信息：" . $ssh->getLastError() . "\n";
    }
} else {
    echo "错误：本地文件 '{$localFileToUpload}' 不存在，无法上传。\n";
}

// 2. 下载文件
echo "\n--- 下载文件 ---\n";
$remoteFileToDownload = "/home/{$username}/remote_file_to_download_phpseclib.txt"; // 远程待下载文件
$localDownloadPath = '/path/to/local/downloaded_file_phpseclib.txt'; // 本地保存路径

// get() 方法用于下载文件
// 第一个参数是远程文件路径，第二个参数是本地保存路径
if ($scp->get($remoteFileToDownload, $localDownloadPath)) {
    echo "文件 '{$remoteFileToDownload}' 已成功下载到 '{$localDownloadPath}'。\n";
} else {
    echo "文件下载失败。错误信息：" . $ssh->getLastError() . "\n";
}

// 在脚本结束时，phpseclib 会自动关闭连接。
// 如果需要显式断开，可以调用 $ssh->disconnect()，但在 phpseclib3 中通常不需要。
?>