php如何与Memcached交互？php连接和使用Memcached缓存系统

php-memcached

sudo apt install php-memcached

sudo yum install php-pecl-memcached

<?php
// 1. 实例化Memcached对象
$memcached = new Memcached();

// 2. 添加Memcached服务器
// 可以在这里添加多个服务器，Memcached客户端会自动进行数据分片和负载均衡
// 参数：主机名/IP, 端口, 权重 (可选，默认为1)
$memcached->addServer('127.0.0.1', 11211); // 默认端口11211
// $memcached->addServer('192.168.1.10', 11211, 50); // 也可以添加多个服务器

// 简单检查连接状态，虽然addServer不会立即报错
// 第一次实际操作时才会真正尝试连接，但getStats()可以快速探测服务器是否可达
if (!$memcached->getStats()) {
    // 实际应用中，这里应该有更完善的日志记录和备用方案，比如回退到数据库
    error_log("无法连接到Memcached服务器，请检查服务状态。");
    // 可以选择抛出异常或返回错误信息
    // die("系统维护中，请稍后再试。");
}

// 3. 存储数据 (set)
$key = 'user:profile:123';
$value = ['id' => 123, 'name' => 'Alice', 'email' => 'alice@example.com'];
$expiration = 3600; // 缓存1小时 (秒)。0表示永不过期，但Memcached会在内存不足时淘汰。

if ($memcached->set($key, $value, $expiration)) {
    echo "数据 '$key' 成功存储。\n";
} else {
    // 存储失败的原因有很多，比如服务器宕机、内存不足等
    echo "数据存储失败：Code " . $memcached->getResultCode() . ", Message: " . $memcached->getResultMessage() . "\n";
}

// 4. 获取数据 (get)
$cached_value = $memcached->get($key);
if ($cached_value !== false) {
    echo "从缓存中获取到数据：\n";
    print_r($cached_value);
} else {
    echo "缓存中没有 '$key' 对应的数据，或者数据已过期/不存在。\n";
    // 此时通常会去数据库查询，然后再次存入缓存，这就是所谓的“缓存穿透”后回源
    // $data_from_db = get_user_from_database(123);
    // if ($data_from_db) {
    //     $memcached->set($key, $data_from_db, $expiration);
    // }
}

// 5. 删除数据 (delete)
// 如果数据不再需要，或者需要强制刷新缓存
if ($memcached->delete($key)) {
    echo "数据 '$key' 成功删除。\n";
} else {
    // 删除失败可能是因为key不存在，或者服务器问题
    echo "数据删除失败或不存在：Code " . $memcached->getResultCode() . ", Message: " . $memcached->getResultMessage() . "\n";
}

// 尝试再次获取，应该获取不到
$cached_value_after_delete = $memcached->get($key);
if ($cached_value_after_delete === false) {
    echo "删除后，'$key' 对应的数据确实找不到了。\n";
}

// 6. 计数器操作 (increment/decrement)
// 这对于统计浏览量、点赞数等原子性操作非常有用
$counter_key = 'article:page_views:456';
// 初始化计数器，如果不存在则设置为0，永不过期
$memcached->add($counter_key, 0, 0); // add操作在key不存在时才成功设置

// 增加计数，默认步长为1
$new_value = $memcached->increment($counter_key);
echo "文章浏览量增加到：" . $new_value . "\n";

// 减少计数
$new_value = $memcached->decrement($counter_key);
echo "文章浏览量减少到：" . $new_value . "\n";

// 7. 清空所有缓存 (flush)
// 这个操作非常危险，会清空所有Memcached服务器上的所有数据，慎用！
// 生产环境中几乎不会直接调用，除非是灾难恢复或系统大版本升级
// $memcached->flush();
// echo "所有缓存已清空。\n";
?>

Memcached

Memcached

Memcached

$persistent_id

new Memcached('my_app_pool')

get()

false

get()

false

$memcached->getResultCode()

$memcached->getResultMessage()

app_name:module_name:object_id:field_name