You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Ubuntu 18.04 LTS安装PHP couchbase扩展遇dpkg错误求助

解决Ubuntu 18.04 LTS下安装Couchbase PHP扩展的问题

你遇到的核心问题是:下载的couchbase-release-1.0-4-amd64.deb包不支持Ubuntu 18.04 LTS(Bionic Beaver)——从错误日志能看到它仅适配到Ubuntu Xenial(16.04)版本。下面是针对你的环境(Ubuntu 18.04 + PHP 7.1)的完整解决流程:

步骤1:清理无效的旧包

先把安装失败的遗留包清理掉:

sudo dpkg --remove --force-remove-reinstreq couchbase-release

步骤2:添加支持Bionic的Couchbase软件源

Couchbase后续更新了软件源,已经支持Ubuntu 18.04。执行以下命令添加正确的源:

# 下载适配新版本的Couchbase release包
wget https://packages.couchbase.com/releases/couchbase-release/couchbase-release-1.0-7-amd64.deb
sudo dpkg -i couchbase-release-1.0-7-amd64.deb
# 更新系统软件源缓存
sudo apt-get update

步骤3:安装Couchbase依赖库

现在可以顺利安装所需的基础依赖了:

sudo apt-get install libcouchbase-dev libcouchbase2-bin build-essential

步骤4:安装PHP 7.1的Couchbase扩展

提供两种安装方式,任选其一即可:

方式A:通过PECL安装(推荐)

先确保PHP 7.1的开发包和pecl工具已安装:

sudo apt-get install php7.1-dev php-pear

然后安装适配PHP 7.1的Couchbase扩展版本(注意:PHP 7.1最高支持2.6.2版本):

sudo pecl install couchbase-2.6.2

安装完成后启用扩展:

# 添加扩展配置文件
echo "extension=couchbase.so" | sudo tee /etc/php/7.1/mods-available/couchbase.ini
# 为CLI和FPM环境启用扩展
sudo phpenmod -v 7.1 couchbase
sudo phpenmod -v 7.1 -s fpm couchbase
# 重启PHP-FPM(如果你使用FPM环境)
sudo systemctl restart php7.1-fpm

方式B:手动编译安装

如果PECL安装遇到问题,可以尝试手动编译:

# 下载对应版本的源码包
wget https://pecl.php.net/get/couchbase-2.6.2.tgz
tar xzf couchbase-2.6.2.tgz
cd couchbase-2.6.2
# 编译前配置
phpize7.1
./configure --with-php-config=/usr/bin/php-config7.1
# 编译并安装
make
sudo make install

编译完成后,同样按照方式A的步骤启用扩展即可。

验证安装结果

执行以下命令确认扩展已成功加载:

php7.1 -m | grep couchbase

如果输出couchbase,说明安装成功,此时你可以重新运行composer install命令了。


内容的提问来源于stack exchange,提问作者JanuszAmi

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.28 07:03:29