在 ServBay 中使用 Memcached 进行 PHP 数据缓存

ServBay 作为一款强大的本地 Web 开发环境，预置了高性能的 Memcached 软件包（Memcached server）以及相应的 PHP 扩展，方便开发者在 PHP 应用中实现高效的数据缓存，显著提升应用性能。

本文将详细介绍如何在 ServBay 中确认并使用 Memcached 及其对应的 PHP 扩展。

Memcached 简介

Memcached 是一个高性能、分布式的内存对象缓存系统。它通过在内存中临时存储数据（如数据库查询结果、API 调用响应、页面片段等），减少了对后端数据存储（如数据库）的访问次数，从而加快了动态 Web 应用的响应速度和吞吐量。

主要特点

高性能：数据存储在内存中，读写速度极快。
分布式：支持在多个服务器之间构建分布式缓存池，易于扩展。
简单易用：协议简单，客户端库丰富，集成方便。
减少数据库负载：有效降低了数据库的查询压力，特别是在高并发场景下。

`memcache` 和 `memcached` PHP 扩展的区别

在 PHP 中，有两个常用的扩展用于连接 Memcached 服务器：memcache 和 memcached。虽然名称相似，但它们是两个不同的扩展，提供了不同的 API 和功能：

memcache 扩展：
- 较早的 PHP 扩展。
- 主要提供面向过程的 API (memcache_connect(), memcache_set(), etc.)。
- 功能相对基础，不支持一些高级特性，如一致性哈希（虽然部分客户端库实现了）。
memcached 扩展：
- 较新的 PHP 扩展（由 libmemcached 库提供支持）。
- 提供面向对象的 API (Memcached 类)。
- 支持更多高级功能，如一致性哈希、二进制协议、SASL 认证、更灵活的序列化选项等。
- 通常推荐使用 memcached 扩展，因为它功能更强大且维护更活跃。

ServBay 默认提供并推荐使用功能更丰富的 memcached PHP 扩展。

ServBay 中的 Memcached 软件包与 PHP 扩展

ServBay 不仅集成了 Memcached 服务器作为可管理的软件包，还为集成的各个 PHP 版本预装并默认启用了 memcached PHP 扩展。

这意味着在大多数情况下，您安装 ServBay 后，Memcached 服务器和 PHP 扩展就已经准备就绪，无需额外编译或配置 PHP。

确认 Memcached 软件包状态：

您可以在 ServBay 的主界面或软件包管理界面中找到 Memcached 软件包，并确认其状态为“正在运行”。如果未运行，请尝试启动它。

确认 memcached PHP 扩展已加载：

要确认特定 PHP 版本是否成功加载了 memcached 扩展，最简单的方法是使用 phpinfo() 函数：

在 ServBay 的网站根目录（默认为 /Applications/ServBay/www）下创建一个新的 PHP 文件，例如 info.php。
在文件中添加以下内容：
php
```
<?php
phpinfo();
?>
```
1
2
3
通过 ServBay 配置的本地网站访问此文件（例如，如果您的网站域名是 servbay.demo，则访问 http://servbay.demo/info.php）。
在打开的 phpinfo 页面中，搜索 "memcached"。如果您看到一个名为 "memcached" 的部分，其中列出了配置信息和版本号，则表示该扩展已成功加载并可用。

在 PHP 代码中使用 Memcached

确认 Memcached 服务器正在运行且 memcached PHP 扩展已加载后，您就可以在 PHP 应用中使用 Memcached 类来连接服务器并执行缓存操作了。

Memcached 服务器默认运行在 localhost 的标准端口 11211 上。

示例代码

以下是一个简单的 PHP 代码示例，演示如何使用 Memcached 类连接到本地 Memcached 服务器并进行数据的设置和获取：

将以下代码保存为 ServBay 网站目录下的一个 PHP 文件（例如 /Applications/ServBay/www/memcached_test.php）：

php

<?php

// Memcached 服务器信息
$memcached_host = 'localhost';
$memcached_port = 11211;

// 创建 Memcached 客户端实例
$memcached = new Memcached();

// 添加 Memcached 服务器到客户端连接池
// addServer() 方法返回布尔值指示是否成功添加到列表，不代表连接成功
if (!$memcached->addServer($memcached_host, $memcached_port)) {
    // 注意：addServer 失败通常是配置问题，不是服务器连不上
    die("无法将 Memcached 服务器添加到客户端连接列表。请检查主机和端口配置。");
}

// 尝试获取一个不存在的键来测试连接（可选，但推荐）
// get() 返回 false 或空数组表示键不存在或连接有问题
// Memcached::getResultCode() 可以获取更详细的状态码
$test_key = 'servbay_memcached_connection_test';
$memcached->get($test_key); // 尝试获取一个不存在的键
$result_code = $memcached->getResultCode();

if ($result_code !== Memcached::RES_NOTFOUND && $result_code !== Memcached::RES_SUCCESS) {
     // 如果不是 RES_NOTFOUND 或 RES_SUCCESS，可能表示连接有问题
     // 注意：RES_SUCCESS 可能是获取空值时返回
     // 更严谨的连接检查可能需要更多的逻辑或依赖特定的客户端行为
     // 对于本地开发，通常 addServer 成功且后续操作不报错即可认为连接正常
     echo "注意：连接 Memcached 服务器时可能存在问题。Result Code: " . $result_code . "<br>";
     // 实际应用中可能需要更详细的错误处理
} else {
    echo "成功连接到 Memcached 服务器 ({$memcached_host}:{$memcached_port})。<br>";
}


// --- 缓存操作示例 ---

// 要缓存的数据
$key = 'user_profile_1234';
$data = [
    'id' => 1234,
    'username' => 'servbay-demo',
    'email' => '[email protected]',
    'status' => 'active'
];
$expiration = 3600; // 缓存过期时间，单位：秒 (此处为 1 小时)

// 设置缓存数据
// set() 方法返回布尔值，指示操作是否成功
if ($memcached->set($key, $data, $expiration)) {
    echo "数据已成功缓存到 Memcached，键为 '{$key}'，过期时间 {$expiration} 秒。<br>";
} else {
    echo "缓存数据失败！<br>";
    // 可以通过 $memcached->getResultCode() 获取失败原因
    echo "Result Code: " . $memcached->getResultCode() . "<br>";
}

// 尝试从缓存中获取数据
echo "尝试从缓存中获取数据...<br>";
$cachedData = $memcached->get($key);

if ($cachedData !== false) { // Memcached::get() 在缓存未命中或失败时返回 false
    echo "成功从缓存中获取数据：<br>";
    echo "<pre>";
    print_r($cachedData);
    echo "</pre>";
} else {
    echo "缓存未命中或获取失败，键为 '{$key}'。<br>";
    echo "Result Code: " . $memcached->getResultCode() . "<br>";
}

// 演示缓存过期后的情况 (假设时间已流逝)
// 通常你会在实际应用中检查 $cachedData 是否为 false，如果为 false，则从原始数据源（如数据库）加载数据，然后再存入缓存。

// 示例：删除缓存数据
/*
echo "尝试删除缓存数据...<br>";
if ($memcached->delete($key)) {
     echo "数据已成功从缓存中删除，键为 '{$key}'。<br>";
} else {
     echo "删除缓存数据失败！<br>";
     echo "Result Code: " . $memcached->getResultCode() . "<br>";
}

// 再次尝试获取已删除的数据
echo "再次尝试获取已删除的数据...<br>";
$cachedDataAfterDelete = $memcached->get($key);
if ($cachedDataAfterDelete !== false) {
    echo "获取到数据（删除失败）：<br>";
    print_r($cachedDataAfterDelete);
} else {
    echo "数据已不在缓存中（符合预期）。<br>";
    echo "Result Code: " . $memcached->getResultCode() . "<br>";
}
*/

// 示例：清空所有缓存 (谨慎使用！)
/*
echo "尝试清空所有缓存...<br>";
if ($memcached->flush()) {
    echo "所有缓存数据已清空。<br>";
} else {
    echo "清空缓存失败！<br>";
    echo "Result Code: " . $memcached->getResultCode() . "<br>";
}
*/

?>

通过 ServBay 配置的本地网站访问 memcached_test.php 文件，您将看到连接状态、数据设置和获取的结果输出。

注意事项

确保 Memcached 软件包在 ServBay 中是正在运行状态。
Memcached 默认监听在 127.0.0.1 (或 localhost) 的 11211 端口。通常无需修改。
如果在 PHP 中连接失败，请检查 Memcached 软件包状态以及是否有防火墙阻止了本地连接。
Memcached 类的 addServer 方法仅仅是将服务器添加到待连接的服务器池中，它本身不建立持久连接或立即检查服务器可用性。连接和操作是在后续调用 get, set 等方法时才实际发生。通过检查这些操作的返回值或 getResultCode() 可以判断是否成功。

总结

ServBay 为开发者提供了极其便捷的方式来使用 Memcached。通过 ServBay 集成的 Memcached 软件包和预装并默认启用的 memcached PHP 扩展，您无需复杂的安装和配置过程，即可快速在本地开发环境中利用 Memcached 进行高效的数据缓存，为构建高性能的 PHP 应用打下坚实基础。

在 ServBay 中使用 Memcached 进行 PHP 数据缓存 ​

Memcached 简介 ​

主要特点 ​

memcache 和 memcached PHP 扩展的区别 ​

ServBay 中的 Memcached 软件包与 PHP 扩展 ​

在 PHP 代码中使用 Memcached ​

示例代码 ​

注意事项 ​

总结 ​