如何在远程服务器实现HTML缓存的保存与加载？本地缓存代码改造方案咨询

当然有可行的方案！你可以通过FTP/SFTP协议或者云存储SDK来实现把缓存文件存到远程服务器，同时从远程加载缓存内容。下面我会给出具体的实现步骤和代码示例：

一、核心思路 #

原来的本地缓存逻辑是「检查本地缓存文件是否有效 → 有效则输出缓存，否则生成页面并写入本地缓存」，现在需要把这个逻辑中的本地文件操作替换为远程服务器的文件操作，主要分为两步：

1. 页面加载前，先检查远程服务器上的缓存文件是否在有效期内，有效则直接输出远程缓存内容。
2. 页面生成完成后，把页面内容上传到远程服务器作为新的缓存文件。

二、方案1：使用FTP协议（适合普通远程服务器） #

FTP是最常用的远程文件传输方式，大部分服务器都支持。需要先确保你的PHP环境启用了ftp扩展（默认通常已启用）。

修改后的页眉代码 #

<?php
// 远程FTP服务器配置，请替换为你的实际信息
$ftp_host = 'your-remote-host.com';
$ftp_username = 'your-ftp-username';
$ftp_password = 'your-ftp-password';
$remote_cache_dir = '/var/www/remote-cache/'; // 远程服务器上的缓存目录，确保有读写权限

// 生成缓存文件名（和原来逻辑一致）
$url = $_SERVER["SCRIPT_NAME"];
$break = explode('/', $url);
$file = $break[count($break) - 1];
$cache_filename = 'cached-'.substr_replace($file ,"",-4).'.html';
$remote_cache_path = $remote_cache_dir . $cache_filename;
$cache_expire_time = 18000; // 缓存有效期，单位：秒

$serve_from_remote_cache = false;

// 连接远程FTP服务器
$ftp_connection = ftp_connect($ftp_host);
$login_success = ftp_login($ftp_connection, $ftp_username, $ftp_password);

if ($ftp_connection && $login_success) {
    // 开启被动模式（大部分FTP服务器需要此设置）
    ftp_pasv($ftp_connection, true);
    
    // 获取远程缓存文件的最后修改时间
    $remote_file_mtime = ftp_mdtm($ftp_connection, $remote_cache_path);
    
    // 检查缓存是否有效
    if ($remote_file_mtime !== -1 && (time() - $cache_expire_time < $remote_file_mtime)) {
        // 读取远程缓存内容并输出
        echo "<!-- Cached copy, generated ".date('H:i', $remote_file_mtime)." -->\n";
        ob_start();
        ftp_get($ftp_connection, 'php://output', $remote_cache_path, FTP_BINARY);
        $cached_content = ob_get_clean();
        echo $cached_content;
        $serve_from_remote_cache = true;
    }
    
    // 关闭FTP连接
    ftp_close($ftp_connection);
}

// 如果缓存有效，直接退出，不执行后续页面逻辑
if ($serve_from_remote_cache) {
    exit;
}

// 缓存无效或连接失败，继续生成页面
ob_start();
?>

修改后的页脚代码 #

<?php
// 获取当前页面的输出内容
$page_content = ob_get_contents();
ob_end_flush(); // 先把内容输出给浏览器

// 再次连接FTP服务器，上传缓存内容
$ftp_connection = ftp_connect($ftp_host);
$login_success = ftp_login($ftp_connection, $ftp_username, $ftp_password);

if ($ftp_connection && $login_success) {
    ftp_pasv($ftp_connection, true);
    
    // 先把内容写入本地临时文件，再上传到远程（避免内存占用过高）
    $temp_local_file = tempnam(sys_get_temp_dir(), 'remote-cache');
    file_put_contents($temp_local_file, $page_content);
    
    // 上传到远程服务器
    ftp_put($ftp_connection, $remote_cache_path, $temp_local_file, FTP_BINARY);
    
    // 删除本地临时文件
    unlink($temp_local_file);
    
    ftp_close($ftp_connection);
}
?>

三、方案2：使用SFTP协议（更安全，适合需要加密传输的场景） #

如果你的远程服务器支持SSH，可以用SFTP（基于SSH的文件传输协议），安全性比FTP更高。需要确保PHP环境安装了ssh2扩展（部分服务器需要手动安装）。

修改后的页眉代码 #

<?php
// 远程SSH服务器配置
$ssh_host = 'your-remote-host.com';
$ssh_username = 'your-ssh-username';
$ssh_password = 'your-ssh-password';
$remote_cache_dir = '/var/www/remote-cache/';
$cache_filename = 'cached-'.substr_replace($file ,"",-4).'.html';
$remote_cache_path = $remote_cache_dir . $cache_filename;
$cache_expire_time = 18000;

$serve_from_remote_cache = false;

// 连接SSH服务器
$ssh_connection = ssh2_connect($ssh_host, 22);
if (ssh2_auth_password($ssh_connection, $ssh_username, $ssh_password)) {
    // 初始化SFTP会话
    $sftp_session = ssh2_sftp($ssh_connection);
    $remote_file_handle = "ssh2.sftp://{$sftp_session}{$remote_cache_path}";
    
    // 检查远程缓存文件是否存在且有效
    if (file_exists($remote_file_handle)) {
        $remote_file_mtime = filemtime($remote_file_handle);
        if (time() - $cache_expire_time < $remote_file_mtime) {
            echo "<!-- Cached copy, generated ".date('H:i', $remote_file_mtime)." -->\n";
            readfile($remote_file_handle);
            $serve_from_remote_cache = true;
        }
    }
}

if ($serve_from_remote_cache) {
    exit;
}

ob_start();
?>

修改后的页脚代码 #

<?php
$page_content = ob_get_contents();
ob_end_flush();

// 连接SSH并上传缓存
$ssh_connection = ssh2_connect($ssh_host, 22);
if (ssh2_auth_password($ssh_connection, $ssh_username, $ssh_password)) {
    $sftp_session = ssh2_sftp($ssh_connection);
    $remote_file_handle = "ssh2.sftp://{$sftp_session}{$remote_cache_path}";
    
    // 写入远程缓存文件
    $file_stream = fopen($remote_file_handle, 'w');
    fwrite($file_stream, $page_content);
    fclose($file_stream);
}
?>

四、注意事项 #

• 权限配置：确保远程服务器的缓存目录对FTP/SSH用户有读写权限，否则会导致缓存写入失败。
• 错误处理：可以在代码中添加错误判断逻辑，当远程连接失败时，fallback到本地缓存逻辑，避免影响页面正常加载。
• 云存储替代：如果使用AWS S3、阿里云OSS等云存储服务，可以直接使用官方SDK来上传/下载缓存文件，稳定性和扩展性会更好。
• 扩展依赖：使用SFTP时，需要确认PHP已安装ssh2扩展；使用FTP时，确保ftp扩展已启用。

内容的提问来源于stack exchange，提问作者Md Rakib Khan