Ubuntu 超详细安装 PHP SQLite3 扩展教程（全版本通用）

很多 PHP 轻量项目、本地测试站点、小型 CMS/博客系统，都会用到 SQLite 轻量数据库。相比 MySQL、PostgreSQL，SQLite 无需独立服务、无需配置账号密码、单文件存储，非常适合单机小型应用。

但 Ubuntu 系统默认安装的 PHP 并不会自带 SQLite3 驱动，访问程序会直接报错：Call to undefined function sqlite3_open() 或 could not find driver (sqlite3)。

今天这篇博文，手把手教大家在 Ubuntu 20.04/22.04/24.04 系统中，快速安装、启用、验证 php-sqlite3 扩展，适配 PHP7.4/8.0/8.1/8.2/8.3 全版本，全程命令可直接复制执行。

一、前期准备：确认系统与 PHP 版本

首先登录 Ubuntu 服务器，终端执行命令，查看当前 PHP 版本，精准匹配对应扩展安装包：

php -v

• PHP 8.1.x（Ubuntu22.04 默认）
• PHP 8.2/8.3（自定义高版本）

重点：Ubuntu 下 PHP 扩展包版本必须和 PHP 主版本严格一致，否则无法生效、甚至冲突报错。

二、更新软件源（必做步骤）

安装前先更新系统软件源缓存，保证能拉取到最新、匹配的扩展包，避免安装失败：

sudo apt update

如果系统长期未更新，可执行升级（可选，不影响本次扩展安装）：

sudo apt upgrade -y

三、对应版本安装 php-sqlite3 扩展

Ubuntu 官方源中，SQLite 的 PHP 扩展包名为 phpX.X-sqlite3，根据你的 PHP 版本选择对应命令安装即可。

1、PHP 8.x 版本通用安装（最常用）

# PHP8.1（Ubuntu22.04 默认）

sudo apt install php8.1-sqlite3 -y

# PHP8.2

sudo apt install php8.2-sqlite3 -y

# PHP8.3

sudo apt install php8.3-sqlite3 -y

2、PHP7.4 版本安装

sudo apt install php7.4-sqlite3 -y

3、安装系统默认 PHP 版本扩展（懒人通用）

如果不确定具体版本，直接安装系统默认适配版本：

sudo apt install php-sqlite3 -y

四、重启服务，让扩展生效

安装完成后，扩展不会自动加载，需要重启 PHP 运行服务，根据你的部署环境选择对应命令：

1、Nginx 环境（PHP-FPM）

以 PHP8.1 为例，其他版本替换版本号即可：

sudo systemctl restart php8.1-fpm

2、Apache 环境

sudo systemctl restart apache2

3、仅 CLI 命令行环境

纯命令行运行 PHP 无需重启服务，直接生效。

五、验证 SQLite3 扩展是否安装成功

提供两种简单有效的验证方式，快速确认扩展加载正常。

方式1：命令行快速检测

php -m | grep sqlite3

出现 sqlite3 字段即代表安装成功，示例输出：

sqlite3

方式2：PHP 代码测试（网页验证）

在网站根目录新建测试文件 sqlite_test.php：

<?php
// 判断sqlite3扩展是否启用
if (extension_loaded('sqlite3')) {
    echo "✅ SQLite3 扩展已成功加载！";
} else {
    echo "❌ SQLite3 扩展未加载！";
}

// 输出扩展详细信息
phpinfo(INFO_MODULES);
?>

访问网站对应地址，页面显示 SQLite3 扩展已成功加载，且可看到 sqlite3 模块详情，说明环境完全正常。

六、额外安装：系统 SQLite3 客户端（可选）

如需直接在服务器命令行操作 SQLite 数据库、执行 SQL 语句，可安装系统客户端工具：

sudo apt install sqlite3 -y

查看客户端版本：

sqlite3 --version

七、常见问题排查

问题1：安装后仍提示 could not find driver

大概率是 PHP 版本与扩展版本不匹配，或未重启 FPM/Apache 服务。

解决：重新核对 PHP 版本，安装对应版本的 sqlite3 扩展，重启服务。

问题2：apt 找不到安装包

高版本 PHP（8.2/8.3）需依赖第三方 PPA 源，先安装源再执行安装：

sudo apt install software-properties-common -y
sudo add-apt-repository ppa:ondrej/php
sudo apt update

问题3：CLI 正常，网页访问报错

CLI 和网页 FPM 是两套独立配置，仅重启 CLI 不生效，必须 重启 phpX.X-fpm 服务。

八、总结

Ubuntu 安装 PHP SQLite3 扩展核心步骤非常简单：

1. 查看 PHP 版本，匹配对应扩展包；
2. apt update 更新源后安装 phpX.X-sqlite3；
3. 重启 FPM/Apache 服务生效；
4. 通过 php -m 或代码验证安装结果。

SQLite 轻量化、零配置的特性，非常适合个人博客、本地开发、小型工具类项目，搭配 PHP 使用无需搭建复杂数据库服务，极大降低部署成本。