README

项目介绍

Sqlite3 插件：它是与fopen 函数相媲美的，性能相当不错，对于一般性的个人博客，企业官网等，完全能够胜任。其中Sqlite 的内存型反应时间是ns级别的，而其他数据库都会有网络开销，可以达到ms级别。代码很少，只有100多行。

最近对代码进行了升级，直接继承SQLite3类进行官方类的扩展php.net/sqlite3，我在官方基础上扩展了几个功能，从而实现自动表映射。同时将表配置文件放入到数据库同目录下，迁移时直接复制即可。

• 客观地看待Sqlite的优缺点，它确实非常适合用于记录日志。

项目地址

Github Youloge.sqlite Star我 我们一起做大做强

• 2.1.0 修复 json_trim存入json字符串报错 值为使用json_encode($html,JSON_HEX_APOS)转义
• 2.0.4 修复 row_array的排序查询BUG

安装

composer require youloge/sqlite

插件已经引入了以下助手函数 不需要再引入了，可以直接使用sqlite()

use Youloge\Sqlite\Sqlite;     
if(!function_exists('sqlite')){                  
  function sqlite($dir,$file){                     
    return new Sqlite($dir,$file);               
  }
}
// 任意地方 使用
$db = sqlite('文件目录/目录','文件名(不包含后缀)'); // 返回是一个`SQLite3 类`
$db::version(); // 返回版本/配置
var_export(get_class_methods($db)); // 打印全部方法

配置文件

• Sqlite 没有什么远程管理工具，配置文件是关键的关键
• 位置：config/plugin/youloge/app.php
• 将绝对路径配置到挂载盘等，可以很好地与其他日志服务相结合

<?php
return [
  'enable' => true,
  // 绝对路径 需要 / 开头 结尾 不需要
  'absolute'=>'C:/Users/Micateam/Desktop/youloge/composer/public',
  // 相对路径 数据库配置`JSON`格式 + MD5后续加入 方式配置变动
  'dump'=>'youloge.sqlite.json',
  // 文件后缀 你改成mp4都没问题 Sqlite3 能识别
  'format'=>'db'
];

配置数据表

• 进入绝对路径C:/Users/Micateam/Desktop/youloge/composer/public目录下，新增文件youloge.sqlite.json
• Sqlite是以文件作为数据库的，一个文件就是一个完整的数据库，你必须预先设计好数据表：
• 支持复杂目录www/hello/word.user，点文件夹也支持* .user，不要与app.php > format重复，防止同名文件夹-文件名
• 后续考虑将sqlite 配置整合到absolute 绝对路径里去加载，可以更好地实现分布式共享：例如丢到挂载盘共享

/**
 * 判断标准 键值为数组 键名代表目录名
 * 判断标准 键值为字符 键名代表数据库表名
 */
{
  "init":"id INT PRIMARY KEY AUTOINCREMENT,name varhcar(32),avatar varhcar(128),mail varhcar(128)",
  "test":"id INT PRIMARY KEY AUTOINCREMENT,name varhcar(32),avatar varhcar(128),mail varhcar(128)",
  "www.site":{
    "hello":"id INT PRIMARY KEY AUTOINCREMENT,avatar varhcar(128),mail varhcar(128),created text(12)",
    "word":"id INT PRIMARY KEY AUTOINCREMENT,name varhcar(32),avatar varhcar(128),mail varhcar(128)",
    "ok":{
      "no":"id INT PRIMARY KEY AUTOINCREMENT,state varhcar(128)",
    }
  },
  "open.site":{
    "info":"id INT PRIMARY KEY AUTOINCREMENT,state varhcar(128),created text(12)"
  }
}

youloge.sqlite.json文件数据表配置，要仔细：一旦建立了数据库表，修改更改表会非常麻烦+痛苦

• $db = sqlite('/','db001'); 会在绝对路径目录下新建一个db001.db文件，自动创建两张表init和test
• $db = sqlite('www.site/ok','db002'); 会在绝对路径/www.site/ok目录下新建一个db002.db文件，自动创建一张表no

开始使用

连接数据库

• 以相对路径目录open.site、文件youloge、表名info为例

$db = sqlite('open.site','youloge');
sqlite::version(); // 静态调用

插入数据 $table, $data

插入一条数据

$insert = sqlite->insert('info',['state'=>'正常']);
echo $insert; // 返回插入的行数 行数 ≠ 自增ID

插入多条数据

$insert = sqlite->insert('info',[['state'=>'正常'],['state'=>'正常'],['state'=>'正常']]);
echo $insert; // 返回插入的行数 行数 ≠ 自增ID

更新数据 $table, $data, $where

一般更新

$update = sqlite->update('info',['state'=>'禁言'],['id'=>1]);
echo $update; // 返回1,0

特殊更新

$update = sqlite->update('info',['state'=>'禁言'],['id > 5','state'=>'正常']);
echo $update; // 返回1,0

删除数据 $table,$where

$delete = sqlite->delete('info',['state'=>'禁言']); // 键值对
$delete = sqlite->delete('info',['state IS NULL']); // 纯数组
echo $delete; // 返回1,0

单条查询 $table, $columns, $where 可选$order=false

• row_array

$row_array = sqlite->row_array('info','*',['id'=>100]);
$row_array = sqlite->row_array('info',['*','id as uuid'],['id < 100','state'=>'正常'],'created desc');
echo $row_array; // []

多条查询 $table, $columns, $where,$limit=10,$offset=0,$order=false

• result_array

$result_array = sqlite->result_array('info','*',['id'=>100],10,0);
echo $result_array; // []

统计查询 $table, $columns, $where,$limit=10,$offset=0,$order=false

• 好用，但是数据多了这个玩意肯定卡~

$count_array = sqlite->count_array('info','*',['id'=>100],10,0);
echo $count_array; // ['list'=>[],'count'=>0,'limit'=>10,'offset'=>0];

1.0.2 旧版是链式调用的：因为webman是常驻内存，类只加载一次，我写不好连接池所以2.0.0之后废弃链式调用

扩展函数 -> 箭头调用官方是:: 静态调用

• insert - 插入数据
• update - 更新数据
• delete - 删除数据
• row_array - 单条查询
• result_array - 多条查询
• count_array - 统计查询

原生连接句柄

$pdo = sqlite('hello/word','profile');
$pdo::exec();
$pdo::query();
$pdo::close();
$pdo::busyTimeout();

关于交流打赏：VX：micateam