实现网站多用户内存共享：PHP大文件读取缓存优化问题

问题背景 #

需要从硬盘读取一个7MB的静态文件，希望仅读取一次并将内容存储到内存中，供所有访问用户共享使用。尝试过session（用户独立，无法共享）、APC和Memcached，但每次用户访问都会重新读取文件，日志中反复出现Read File记录。

问题排查 #

你误以为是Memcached实例独立导致的问题，但实际上Memcached是独立的服务端程序，PHP中的Memcached类只是客户端连接，所有用户的请求都会连接到同一个Memcached服务。问题的核心是Memcached连接失败或缓存设置未成功，导致每次get操作都返回false，进而触发文件重读。

解决方案 #

1. 先确认Memcached服务状态

• 检查Memcached服务是否运行：

  # 查看进程
  ps aux | grep memcached
  # 测试连接
  telnet localhost 11211
  

• 确认PHP的Memcached扩展已安装：

  php -m | grep memcached
  

  也可以通过phpinfo()页面查看扩展状态。

2. 修复代码的错误检查逻辑

Memcached默认不会抛出异常，原代码的try-catch无法捕获连接或缓存操作失败的问题，需要手动添加状态检查：

<?php
class CountryFromIP {
    private static $csvArray;    

    // 静态初始化方法，确保内容仅加载一次
    public static function init() {
        if (self::$csvArray !== null) {
            return;
        }

        $memcached = new Memcached();
        // 检查是否已添加服务器
        $servers = $memcached->getServerList();
        if (empty($servers)) {
            $memcached->addServer('localhost', 11211);
            // 验证服务器连接状态
            $status = $memcached->getServerStatus('localhost', 11211);
            if ($status === 0) {
                error_log("Memcached连接失败，降级为直接读取文件");
                self::$csvArray = file('IpToCountry.txt');
                return;
            }
        }

        self::$csvArray = $memcached->get('ip_to_country_data');
        if (!self::$csvArray) {
            self::$csvArray = file('IpToCountry.txt');
            error_log("首次读取文件");
            // 设置缓存并检查操作结果，同时设置长期过期时间（文件不变可设30天）
            $setSuccess = $memcached->set('ip_to_country_data', self::$csvArray, 30*24*3600);
            if (!$setSuccess) {
                error_log("Memcached缓存设置失败: " . $memcached->getLastErrorMessage());
            }
        }
    }

    function __construct() {
        self::init();
    }
     
    function GetCountryName($ip) {
         // 此处编写IP匹配国家的业务逻辑
    }
}

$ipaddress = getenv('HTTP_X_FORWARDED_FOR') ?: getenv('REMOTE_ADDR');
// 提前初始化，避免实例化时重复执行
CountryFromIP::init();
$object = new CountryFromIP();
$countryName = $object->GetCountryName($ipaddress); 
?>

3. 备选方案：利用OPcache缓存

如果Memcached配置复杂，可直接使用PHP内置的OPcache（默认开启，需确保配置正确），它会将静态文件内容缓存到内存中：

<?php
class CountryFromIP {
    private static $csvArray;

    public static function init() {
        if (self::$csvArray === null) {
            // OPcache会自动缓存文件读取结果
            self::$csvArray = file('IpToCountry.txt');
        }
    }

    // 其余方法同前
}

需确保php.ini中OPcache配置正确：

opcache.enable = 1
opcache.memory_consumption = 64 ; 内存分配至少大于文件大小
opcache.validate_timestamps = 0 ; 文件不变时关闭时间验证，避免重复检查

4. 备选方案：静态文件转PHP数组

将文件内容预编译为PHP数组文件，利用require_once的特性实现共享：

1. 生成ip_data.php：

<?php
// 仅执行一次，生成后无需再修改
return file('IpToCountry.txt');
?>

2. 主文件调用：

<?php
class CountryFromIP {
    private static $csvArray;

    public static function init() {
        if (self::$csvArray === null) {
            // require_once在OPcache下只会加载一次
            self::$csvArray = require_once 'ip_data.php';
        }
    }

    // 其余方法同前
}

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