PHP 默认支持 SQLite3,无需额外安装扩展;SQLite 数据库即文件,实例化 SQLite3 类或 PDO 连接时指定路径即可自动创建,关键需确保路径可写且扩展已启用。

PHP 默认就支持 SQLite,无需额外安装扩展
PHP 从 5.0 开始内置 sqlite3 扩展,只要不是极简编译版(比如某些 Alpine 容器精简镜像),SQLite3 类默认可用。运行 php -m | grep sqlite 或检查 phpinfo() 中是否有 sqlite3 模块即可确认。
常见误判点:有人把 pdo_sqlite 和 sqlite3 搞混——前者是 PDO 驱动,后者是原生类;建库用 SQLite3 类完全不需要 PDO。
用 SQLite3 类创建数据库文件的正确写法
SQLite 数据库本质就是一个文件,创建即“打开并写入第一个数据”,不存在单独的 “CREATE DATABASE” SQL 语句。直接实例化 SQLite3 就会生成文件:
exec('CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT)');
?>
注意点:
立即学习“PHP免费学习笔记(深入)”;
机械设备钢材建材网站是基是一个以PHP+MySQL/Sqlite进行开发的四网合一网站源码。 系统功能特点: 四网合一企业网站管理系统支持在线升级(支持跨版本)、插件在线安装、系统内置严格的过滤体系、可以有效应对安全检测报告。 四网合一:电脑网站、手机站(数据同步、支持绑定域名)、小程序、公众号管理一个后台即可搞定。 双数据库引擎、运行环境全面:同时支持Sqlite
-
/path/to/data.db路径必须有写权限,否则抛出Uncaught SQLite3Exception: unable to open database file - 路径不能是目录,也不能是已存在但无写权限的只读文件
- 不建议用相对路径(如
data.db),容易因工作目录变化导致文件生成在意外位置
用 PDO 创建 SQLite 数据库也一样简单
如果项目统一用 PDO,连接字符串里指定不存在的文件路径,PDO 同样会自动创建:
exec('CREATE TABLE logs (ts DATETIME DEFAULT CURRENT_TIMESTAMP, msg TEXT)');
?>
关键区别:
-
PDO不会报错,但若路径不可写,new PDO()会抛出PDOException,错误信息含unable to open database file -
PDO连接后必须至少执行一条语句(哪怕SELECT 1),SQLite 文件才会真正落盘(某些 PHP 版本下) - 不推荐用
sqlite::memory:做“创建库”演示——它不生成文件,关掉连接就消失
权限、路径和扩展缺失是 90% 的失败原因
实际部署时卡住,基本逃不开这三类问题:
- Web 服务器用户(如
www-data或nginx)对目标目录无写权限 → 改目录权限或换路径 - SELinux 或 AppArmor 启用时禁止 Apache/Nginx 写入特定路径 → 临时禁用或加策略
- Docker 容器没挂载宿主机目录,或用了只读文件系统 → 检查
docker run -v和ro/rw标志 - Alpine Linux 镜像默认不含
sqlite3扩展 → 需手动apk add php7-sqlite3(注意版本号)
别在错误信息里找“database not found”之类的提示——SQLite 不报这个,它只报“unable to open”或“permission denied”。盯着这个错,顺着路径和权限查,比重写代码快得多。










