讲师中心 微信公众号
AI工具推荐 视频效率加速

CodeIgniter项目如何配置使用SQLite本地数据库

夏瑶小哥_8539

夏瑶小哥_8539

发布时间:2026-09-19 11:55:28

|

670人浏览过

|

来源于php中文网

原创

CodeIgniter 3 连 SQLite 必须启用 pdo_sqlite 扩展并配置 dbdriver='pdo' 和绝对路径 DSN;否则静默失败或报驱动类不存在。

codeigniter项目如何配置使用sqlite本地数据库

CodeIgniter 3 项目无法直接用 dbdriver = 'sqlite' 连 SQLite,必须走 PDO 路径,且前提是 PHP 已启用 pdo_sqlite 扩展——否则连接会静默失败或报 Class 'CI_DB_pdo_sqlite_driver' not found

确认 PHP 的 pdo_sqlite 扩展已启用

这是最常被跳过的前置步骤。CI3 不自带 SQLite 驱动,只通过 PDO 封装支持。不检查扩展状态,后面所有配置都白搭。

  • 运行 php -m | grep sqlite(命令行)或查看 phpinfo() 页面,确认同时存在 pdopdo_sqlite
  • Windows 下检查 php.ini 是否有 extension=php_pdo_sqlite.dll;Linux/macOS 检查 extension=pdo_sqlite.so 是否未被注释
  • 重启 Web 服务(如 Apache 或 PHP-FPM)使改动生效
  • 若用 XAMPP/MAMP,部分旧版本默认不启用该扩展,需手动勾选开启

database.php 中正确配置 SQLite DSN

SQLite 是文件型数据库,hostnameusernamepasswordport 全部无效,填了也忽略。关键只有两个字段:dbdriverdsn

CodeIgniter 4.7.0
CodeIgniter 4.7.0

CodeIgniter下载页提供 CodeIgniter 4.7.0 官方源码包,并整理框架安装、数据库配置与入门开发说明。

下载
  • dbdriver 必须设为 'pdo',不是 'sqlite'(CI3 根本不认识这个值)
  • dsn 必须以 sqlite: 开头,后接**绝对路径**,例如 sqlite:/var/www/myapp/db/app.dbsqlite:C:/xampp/htdocs/myapp/db/app.db
  • 路径所在目录必须由 Web 服务器用户(如 www-data_wwwIIS_IUSRS)拥有读写权限;否则连接时抛出 unable to open database file
  • 文件本身不会自动创建——如果 app.db 不存在,需手动 touch 或让应用首次建表时触发(但 CI 不负责初始化),建议提前创建并设权

加载与使用 SQLite 数据库连接

配置完不能直接用 $this->db,得显式加载指定分组,因为 SQLite 通常作为独立连接(比如 sqlite 组),而非覆盖 default

  • 在控制器或模型中调用:$this->load->database('sqlite', TRUE),第二个参数 TRUE 返回 DB 实例,避免全局覆盖 $this->db
  • 不要在 autoload.php 里自动加载 database 库——它默认加载 default 组,而你很可能没配 default 的 SQLite,会导致启动即报错
  • 执行查询前先验证连接是否成功:if ($this->db->conn_id) { ... },因为 PDO 连接失败时 CI 不一定抛异常,conn_idnull 是更可靠的判断依据
  • 注意:SQLite 不支持某些 MySQL 特性,比如 INSERT IGNOREREPLACE INTO、自增字段的 AUTO_INCREMENT 写法(要用 INTEGER PRIMARY KEY

常见错误现象与快速定位点

连不上 SQLite,90% 出在路径、权限或扩展缺失。别急着改代码,先看这几个信号:

  • 页面空白 + 日志无报错 → 很可能是 pdo_sqlite 未启用,PHP 解析失败导致脚本中断
  • Class 'CI_DB_pdo_sqlite_driver' not found → 明确是驱动类缺失,对应扩展未启或 CI 版本太低(CI3 要求 PHP ≥ 5.3.7)
  • unable to open database file → 路径非绝对、目录无写权限、父目录不存在,三者查一个少一个
  • 查不到数据但无报错 → 检查表名是否带前缀(dbprefix 设为空)、SQL 是否用了 SQLite 不支持的语法(如 DATE_ADD

SQLite 在 CI3 里是个“半官方”支持项——它不靠框架原生适配,而依赖 PDO 层和你的系统环境。路径写错、权限漏设、扩展忘开,任何一个环节断掉,整个链路就静默失效。动手前花两分钟确认 php -m 输出,比调试半小时配置更省时间。

热门AI工具

更多
立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

更多
PHP CodeIgniter框架
PHP CodeIgniter框架

本专题专注于 PHP 轻量级框架 CodeIgniter 的学习与应用,系统讲解 MVC 模型、路由与控制器、数据库操作、表单验证、安全机制以及 REST API 开发。通过博客系统、内容管理平台和小型电商等实战项目,帮助学员快速掌握 CodeIgniter 的开发方法与实践技能。

3219

2025.08.28

AI视频生成软件推荐
AI视频生成软件推荐

本专题汇总了当前主流的AI视频生成软件推荐与排行榜单,涵盖seko、AniShort、剧云、Lovart、LiblibAI及立刻mv等热门工具。同时整理了各软件在文生视频、图生视频、时长限制、画质表现及免费额度等方面的差异对比,助您快速选对适合创作需求的AI视频生成工具。

120

2026.09.16

ai生成视频的工具免费版合集
ai生成视频的工具免费版合集

本专题汇总了当前免费AI生成视频工具的排行榜与推荐清单,涵盖seko、讯飞智作、AniShort及剧云、Lovart等多模型集成平台。同时整理了各工具的免费额度、输出时长、水印政策及适用场景差异,助您快速选择合适工具开启AI视频创作。

40

2026.09.16

Pandas时间序列分析与可视化报表
Pandas时间序列分析与可视化报表

本专题整理Pandas日期转换、时间索引、重采样、滚动窗口、时区处理、plot绘图、Styler表格样式和报表输出方法。

60

2026.09.16

Pandas数据筛选索引与清洗处理
Pandas数据筛选索引与清洗处理

本专题整理Pandas中的loc、iloc、条件筛选、query查询、缺失值处理、重复值删除、类型转换和字符串列清洗方法。

40

2026.09.16

Pandas数据读取导入与文件导出处理
Pandas数据读取导入与文件导出处理

本专题整理Pandas读取CSV、Excel、JSON、SQL、Parquet等文件的方法,以及to_csv、to_excel、to_sql和to_parquet等常用数据导出流程。

40

2026.09.16

GDB怎么设置断点
GDB怎么设置断点

本专题介绍GDB按照函数名、源代码行号和文件位置设置断点的方法,详细说明run、continue、next、step等命令的配合使用,帮助定位程序崩溃、逻辑异常及代码未按预期执行的问题。

340

2026.09.11

GDB怎么查看变量值
GDB怎么查看变量值

本专题介绍GDB调试过程中查看变量值的具体方法,涵盖局部变量、函数参数、数组、结构体和指针内容查询,同时整理变量持续显示、格式化输出及无法读取变量时的排查思路。

100

2026.09.11

GDB C++程序怎么调试
GDB C++程序怎么调试

本专题围绕GDB调试C++程序的实际过程,详细说明程序编译、调试器启动、命令行参数传入、断点命中和程序继续运行等步骤,并介绍条件断点、临时断点和观察点的设置方法,方便开发者跟踪复杂代码的执行状态。

120

2026.09.11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn