memcached扩展编译失败主因是系统缺失libmemcached开发库：Ubuntu/Debian执行sudo apt install libmemcached-dev，CentOS/RHEL用sudo yum install libmemcached-devel；PECL安装时需用--configureoptions指定路径，php.ini中须写绝对路径并验证php -m加载结果。
memcached 扩展找不到 libmemcached 路径？先确认它压根装没装
报错里出现 configure: error: memcached support requires libmemcached. Use --with-libmemcached-dir=，不是 PHP 的问题，是系统缺底层依赖。Ubuntu/Debian 系统直接跑：sudo apt install libmemcached-dev；CentOS/RHEL 用：sudo yum install libmemcached-devel（或 dnf install libmemcached-devel）。没装这个，PHP 扩展编译器连头文件都读不到，--with-libmemcached-dir 参数根本没机会生效。
用 pecl install memcached 却提示找不到 libmemcached？试试手动指定路径
即使系统已装 libmemcached-dev，PECL 编译时仍可能因多版本或自定义安装路径而找不到。先查真实路径：pkg-config --modversion libmemcached 能返回版本说明库可用；再查头文件位置：find /usr -name "libmemcached.h" 2>/dev/null，常见路径是 /usr/include/libmemcached-1.0 或 /usr/include/libmemcached。然后重装时显式指定：pecl install memcached --configureoptions 'with-libmemcached-dir=/usr'（路径填你 find 到的父目录，比如 /usr 或 /usr/local）。
php.ini 里加了 extension=memcached.so 却不生效？检查扩展是否真编译成功、放对地方了
PECL 安装完会输出类似 Installing '/usr/lib/php/20220829/memcached.so' 的路径，记下这个完整路径。然后确认：ls -l /usr/lib/php/20220829/memcached.so 存在且可读；再看 php --ini 输出的配置文件路径，确保你在那个 php.ini 里写了 extension=/usr/lib/php/20220829/memcached.so（推荐写绝对路径，避免 PHP 自己搜错目录）；最后执行 php -m | grep memcached，有输出才说明加载成功。如果报 undefined symbol: memcached_get 这类错误，大概率是 libmemcached 版本太低（比如 CentOS 7 自带的 1.0.16 不兼容新版 memcached 扩展），得升级或换源编译。
用 Docker 或 Alpine？别碰 pecl install，改用包管理器装更稳
Alpine Linux 默认没有 pecl，且 libmemcached-dev 和 php-memcached 在 apk 仓库里是配对好的：apk add php82-memcached libmemcached（注意 PHP 主版本号要对齐）。Ubuntu/Debian 的 Docker 镜像也建议优先用 apt install php-memcached，它自动处理依赖和 php.ini 注册，比 PECL 少三步出错环节。自己编译只在需要定制参数（比如启用 SASL）或生产环境锁定特定 commit 时才值得做。
立即学习“PHP免费学习笔记（深入）”；
