PHP 连接 Memcached 服务（保姆级教程）

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战(已更新的所有项目都能学习) / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

• 新开坑项目:《Spring AI 项目实战》 正在持续爆肝中，基于 Spring AI + Spring Boot 3.x + JDK 21...， 点击查看 ;
• 《从零手撸：仿小红书（微服务架构）》 已完结，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;演示链接： http://116.62.199.48:7070 ;
• 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在现代 Web 开发中，缓存技术是提升应用性能的核心工具之一。PHP 连接 Memcached 服务，能够帮助开发者高效地实现数据缓存，减少数据库负载，缩短用户等待时间。本文将从零开始，逐步讲解如何在 PHP 中连接并使用 Memcached，涵盖基础配置、核心操作、常见问题及优化技巧。无论是刚接触缓存技术的编程新手，还是希望系统化掌握 Memcached 的中级开发者，都能通过本文找到实用的知识点与解决方案。

一、Memcached 是什么？为什么需要它？

Memcached 是一个高性能的分布式内存对象缓存系统，其核心作用是将频繁访问的数据（如用户会话、查询结果、静态文件等）暂存到内存中，避免重复从数据库或磁盘读取。
形象比喻：如果把数据库比作“图书馆”，那么 Memcached 就像一个“快递员”，它会将读者（程序）频繁借阅的书籍（数据）预先放在图书馆门口的暂存架（内存）中，当读者再次请求时，直接从暂存架取书，大幅缩短等待时间。

Memcached 的核心优势

二、PHP 连接 Memcached 的准备工作

1. 安装 Memcached 服务

在开始之前，需确保本地或服务器已安装 Memcached 服务。以 Ubuntu 系统为例，执行以下命令：

sudo apt-get update  
sudo apt-get install memcached  

安装完成后，可通过 memcached -v 检查服务状态。

2. 安装 PHP 的 Memcached 扩展

PHP 需要通过扩展库与 Memcached 交互。推荐使用 memcached 扩展（注意与 memcache 的区别，前者功能更全面）。安装步骤如下：

sudo apt-get install php-memcached  

sudo systemctl restart apache2  # 若使用 Apache  
sudo systemctl restart php8.1-fpm  # 若使用 Nginx + PHP-FPM  

安装完成后，在 PHP 文件中通过 phpinfo() 验证扩展是否生效。

三、PHP 连接 Memcached 的基础操作

1. 连接 Memcached 服务器

使用 Memcached 类创建连接实例，代码示例如下：

<?php  
// 创建 Memcached 实例  
$memcached = new Memcached();  

// 连接 Memcached 服务（默认端口 11211）  
$memcached->addServer('localhost', 11211);  

// 检查连接是否成功  
if ($memcached->getStats()) {  
    echo "Connected to Memcached successfully!";  
} else {  
    echo "Failed to connect to Memcached.";  
}  
?>  

参数说明：

• addServer() 方法可添加多个服务器节点，支持分布式缓存。
• 可通过 setOption() 配置超时时间、持久化连接等参数，例如：

  $memcached->setOption(Memcached::OPT_CONNECT_TIMEOUT, 2000);  // 连接超时 2 秒  
  

2. 存储数据到 Memcached

Memcached 使用键值对（Key-Value）存储数据，支持字符串、数组、对象等多种类型。

// 存储用户信息  
$user_data = [  
    'id' => 1,  
    'name' => 'Alice',  
    'email' => 'alice@example.com'  
];  

// 设置键为 "user:1"，值为序列化后的数组，有效期 3600 秒  
$memcached->set('user:1', $user_data, 3600);  

注意：

• 非标量类型（如数组、对象）需先序列化（serialize）再存储，读取时反序列化（unserialize）。
• set() 方法返回布尔值，表示操作是否成功。

3. 从 Memcached 中获取数据

// 获取用户信息  
$user = $memcached->get('user:1');  

if ($user) {  
    echo "Name: " . $user['name'];  
} else {  
    echo "Data expired or not found.";  
}  

关键点：

• 若键不存在或数据已过期，get() 返回 false。
• 可通过 getMulti() 一次性获取多个键的值。

四、进阶操作与案例

1. 增量/减量操作（CAS 机制）

Memcached 支持原子操作，适用于计数场景（如商品库存）。

// 初始化库存为 100  
$memcached->set('stock:product1', 100);  

// 原子减 1（CAS 机制）  
$cas_token = $memcached->cas('stock:product1', 99);  

if ($cas_token) {  
    echo "Inventory decreased to " . ($value - 1);  
} else {  
    echo "Operation failed, data may have changed.";  
}  

CAS（Compare And Swap）原理：
Memcached 会比较内存中的值与预期值是否一致，若一致则执行操作，否则失败。这避免了并发修改时的“竞态条件”。

2. 实战案例：电商商品缓存

假设有一个电商系统，商品详情页需要频繁查询数据库。通过 Memcached 缓存，可显著减少数据库压力。

// 获取商品详情  
function getProductDetails($productId) {  
    $memcached = new Memcached();  
    $memcached->addServer('localhost', 11211);  

    // 尝试从缓存读取  
    $product = $memcached->get("product:{$productId}");  

    if (!$product) {  
        // 缓存未命中，从数据库查询  
        $product = queryDatabase("SELECT * FROM products WHERE id = ?", [$productId]);  

        // 存入缓存，有效期 2 小时  
        $memcached->set("product:{$productId}", $product, 7200);  
    }  

    return $product;  
}  

优化点：

• 使用唯一键（如 product:123）确保数据隔离。
• 设置合理过期时间，避免缓存“脏数据”。

五、常见问题与解决方案

1. 连接失败的排查

错误提示：Failed to connect to Memcached
可能原因：

• Memcached 服务未启动：运行 systemctl status memcached 检查服务状态。
• 端口被占用或防火墙拦截：确保 11211 端口开放。

2. 数据未按预期存储

现象：get() 返回 false，但 set() 未报错。
可能原因：

• 数据过期：检查设置的过期时间是否合理。
• 键名拼写错误：Memcached 对大小写敏感，需确保键名完全一致。

3. 内存不足时的策略

当 Memcached 内存耗尽时，会自动根据 LRU 算法淘汰旧数据。可通过以下方式优化：

• 提高缓存命中率：对高频数据设置更长的过期时间。
• 扩展内存容量：增加物理内存或添加更多 Memcached 节点。

六、性能优化技巧

1. 合理设计键名

• 规范命名：使用 module:type:id 格式，如 user:profile:123。
• 避免特殊字符：键名中不要包含空格或控制字符。

2. 使用连接池

通过 addServers() 预先配置多个 Memcached 节点，实现负载均衡：

$memcached->addServers([  
    ['server1', 11211],  
    ['server2', 11211],  
]);  

3. 数据压缩与序列化

对大体积数据启用压缩：

$memcached->setOption(Memcached::OPT_COMPRESSION, true);  

注意：压缩会增加 CPU 开销，需权衡使用场景。

结论

通过本文，读者已掌握 PHP 连接 Memcached 的核心步骤、常见操作及优化方法。Memcached 的高效缓存机制，能显著提升 Web 应用的响应速度与并发能力。建议开发者在实际项目中，结合业务场景灵活运用其功能，并持续监控缓存命中率与内存使用情况，以达到最佳性能。

延伸思考：

• 如何结合 Redis 实现更复杂的缓存策略？
• 在高并发场景下，Memcached 与数据库事务如何保证一致性？

掌握 PHP 连接 Memcached 服务的技能后，开发者将能更从容地应对大规模应用的性能挑战。