docker 中 php 项目 memcached 连接失败时，首先检查 docker compose 配置是否包含正确的 memcached 定义。其次，验证容器间通信是否正常。然后，检查 memcached 端口是否正在监听。接下来，确认 php memcached 扩展已启用。最后，检查 php 代码的连接配置是否正确。

Docker 部署 PHP 项目时 Memcached 连接失败，问题排查

简介

在 Docker 容器中运行 PHP 项目时，有时可能会遇到 Memcached 连接失败的问题。本文将指导您如何排查和解决此问题，提供清晰易懂的解释和实战案例。

立即学习“PHP免费学习笔记（深入）”；

步骤 1：检查 Docker Compose 配置

首先，检查 Docker Compose (docker-compose.yml) 配置，确保包含了正确的 Memcached 服务定义。它应该类似于以下示例：

services:
  memcached:
    image: memcached
    volumes:
      - /tmp/memcached:/tmp/memcached
    ports:
      - 11211:11211

步骤 2：验证容器间通信

使用以下命令检查容器之间的通信：

docker exec -it my-php-container ping memcached

如果得到响应，则容器之间可以互相通信。

步骤 3：检查 Memcached 端口

确保 Memcached 正在监听预期的端口。使用以下命令检查：

docker ps | grep memcached

它应该显示类似以下内容的行：

memcached   memcached                                      "/usr/bin/memcached ."   10 minutes ago   Up 10 minutes   0.0.0.0:11211->11211/tcp   my-memcached

如果端口未列出，请检查 Memcached 服务的配置或重新启动容器。

步骤 4：检查 PHP Memcached 扩展

确保 PHP Memcached 扩展已正确安装和启用。使用以下命令检查：

docker exec -it my-php-container php -m | grep memcached

如果扩展已启用，它应该显示以下行：

memcached

如果扩展未安装或禁用，请安装扩展并重新启动 PHP 服务。

步骤 5：检查 PHP 代码

检查 PHP 代码以确保它正确连接到 Memcached。以下是使用 Memcached 扩展连接到 Memcached 的示例代码：

$memcached = new Memcached;
$memcached->addServer('memcached', 11211);

确保主机名或 IP 地址与 Memcached 容器的名称或 IP 地址相匹配。

实战案例

问题：Memcached 连接失败

排查：

1. 检查 Docker Compose 配置。
2. 验证容器间通信。
3. 检查 Memcached 端口。
4. 检查 PHP Memcached 扩展。
5. 检查 PHP 代码。

解决方案：扩展未安装。安装扩展并重新启动容器。