这是针对 SQLite 版本 3 数据库的 PHP 编程教程,它涵盖了使用 PHP 语言进行 SQLite 编程的基础。
要使用本教程,我们必须在系统上安装 PHP CLI。
为了使用 SQLite 数据库,我们可以安装sqlite3
命令行工具或 SQLite 浏览器 GUI。
$ php -v
PHP 7.2.11 (cli) (built: Oct 10 2018 02:39:52) ( ZTS MSVC15 (Visual C++ 2017) x86 )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
在本教程中,我们使用 PHP 7.2.11。
...
;extension=sockets
extension=sqlite3
;extension=tidy
...
SQLite 随 PHP 一起提供,我们不需要安装它。 我们必须在php.ini
文件中启用 sqlite3 扩展名。
SQLite
SQLite 是嵌入式关系数据库引擎。 该文档称其为自包含,无服务器,零配置和事务型 SQL 数据库引擎。 如今,它在全球使用着数亿册,非常受欢迎。 几种编程语言都内置了对 SQLite 的支持,包括 PHP 和 Python。
创建 SQLite 数据库
我们使用sqlite3
命令行工具创建一个新数据库。
$ sqlite3 test.db
SQLite version 3.27.2 2019-02-25 16:06:06
Enter ".help" for usage hints.
sqlite>
我们为sqlite3
工具提供了一个参数; test.db
是数据库名称。 这是我们磁盘上的文件。 如果存在,则将其打开。 如果不是,则创建它。
sqlite> .tables
sqlite> .exit
$ ls
test.db
.tables
命令提供test.db
数据库中的表的列表。 当前没有表格。 .exit
命令终止sqlite3
命令行工具的交互式会话。 ls
命令显示当前工作目录的内容。 我们可以看到test.db
文件。 所有数据将存储在该单个文件中。
PHP SQLite3 版本示例
在以下示例中,我们获得了 SQLite 数据库的版本。
version.php
<?php
ver = SQLite3::version();
echover['versionString'] . "\n";
echo ver['versionNumber'] . "\n";
var_dump(ver);
SQLite3::version()
返回 SQLite 数据库的版本。
$ php version.php
3.20.1
3020001
array(2) {
["versionString"]=>
string(6) "3.20.1"
["versionNumber"]=>
int(3020001)
}
这是输出。
version2.php
<?php
db = new SQLite3('test.db');version = db->querySingle('SELECT SQLITE_VERSION()');
echoversion . "\n";
程序返回 SQLite 数据库的当前版本。 这次我们执行了SELECT SQLITE_VERSION()
语句。
$db = new SQLite3('test.db');
我们创建一个 SQLite3 对象并打开一个 SQLite3 数据库连接。
$version = $db->querySingle('SELECT SQLITE_VERSION()');
querySingle()
执行查询并返回单个结果。
$ php version2.php
3.20.1
PHP SQLite3 执行
exec()
对给定的数据库执行无结果查询。
create_table.php
<?php
db = new SQLite3('test.db');db->exec("CREATE TABLE cars(id INTEGER PRIMARY KEY, name TEXT, price INT)");
db->exec("INSERT INTO cars(name, price) VALUES('Audi', 52642)");db->exec("INSERT INTO cars(name, price) VALUES('Mercedes', 57127)");
db->exec("INSERT INTO cars(name, price) VALUES('Skoda', 9000)");db->exec("INSERT INTO cars(name, price) VALUES('Volvo', 29000)");
db->exec("INSERT INTO cars(name, price) VALUES('Bentley', 350000)");db->exec("INSERT INTO cars(name, price) VALUES('Citroen', 21000)");
db->exec("INSERT INTO cars(name, price) VALUES('Hummer', 41400)");db->exec("INSERT INTO cars(name, price) VALUES('Volkswagen', 21600)");
该程序将创建一个cars
表,并将八行插入该表中。
$db->exec("CREATE TABLE cars(id INTEGER PRIMARY KEY, name TEXT, price INT)");
该 SQL 语句创建一个新的cars
表。 该表有三列。 请注意,在 SQLite 数据库中,INTEGER PRIMARY KEY
列是自动增加的。
$db->exec("INSERT INTO cars(name, price) VALUES('Audi', 52642)");
$db->exec("INSERT INTO cars(name, price) VALUES('Mercedes', 57127)");
这两行将两辆车插入桌子。
sqlite> .mode column
sqlite> .headers on
我们使用sqlite3
工具验证写入的数据。 首先,我们修改数据在控制台中的显示方式。 我们使用列模式并打开标题。
sqlite> select * from cars;
id name price
---------- ---------- ----------
1 Audi 52642
2 Mercedes 57127
3 Skoda 9000
4 Volvo 29000
5 Bentley 350000
6 Citroen 21000
7 Hummer 41400
8 Volkswagen 21600
这是我们已写入cars
表的数据。
PHP SQLite3 lastInsertRowID
有时,我们需要确定最后插入的行的 ID。 在 PHP SQLite3 中,我们使用lastInsertRowID()
方法。
last_rowid.php
<?php
db = new SQLite3(':memory:');db->exec("CREATE TABLE friends(id INTEGER PRIMARY KEY, name TEXT)");
db->exec("INSERT INTO friends(name) VALUES ('Tom')");db->exec("INSERT INTO friends(name) VALUES ('Rebecca')");
db->exec("INSERT INTO friends(name) VALUES ('Jim')");db->exec("INSERT INTO friends(name) VALUES ('Robert')");
last_row_id =db->lastInsertRowID();
echo "The last inserted row Id is $last_row_id";
我们在内存中创建一个friends
表。 ID 会自动递增。
$db->exec("CREATE TABLE friends(id INTEGER PRIMARY KEY, name TEXT)");
在 SQLite3 中,INTEGER PRIMARY KEY
列自动增加。 还有一个AUTOINCREMENT
关键字。 在INTEGER PRIMARY KEY AUTOINCREMENT
中使用时,会使用稍微不同的 ID 创建算法。
$db->exec("CREATE TABLE friends(id INTEGER PRIMARY KEY, name TEXT)");
$db->exec("INSERT INTO friends(name) VALUES ('Tom')");
$db->exec("INSERT INTO friends(name) VALUES ('Rebecca')");
$db->exec("INSERT INTO friends(name) VALUES ('Jim')");
$db->exec("INSERT INTO friends(name) VALUES ('Robert')");
使用自动增量时,我们必须明确声明列名,而忽略自动增量的列名。 这四个语句在friends
表中插入四行。
$last_row_id = $db->lastInsertRowID();
使用lastInsertRowID()
获得最后插入的行 ID。
$ php last_rowid.php
The last inserted row Id is 4
我们看到了程序的输出。
PHP SQLite3 查询
query()
方法执行 SQL 查询并返回结果对象。
fetch_all.php
<?php
db = new SQLite3('test.db');res = db->query('SELECT * FROM cars');
while (row = res->fetchArray()) {
echo "{row['id']} {row['name']} {row['price']} \n";
}
该示例从cars
表中检索所有数据。
$res = $db->query('SELECT * FROM cars');
该 SQL 语句从cars
表中选择所有数据。
while (row =res->fetchArray()) {
fetchall()
检索结果行作为关联数组或数字索引数组,或两者都检索(默认为两者)。 如果没有更多行,则返回false
。
$ php fetch_all.php
1 Audi 52642
2 Mercedes 57127
3 Skoda 9000
4 Volvo 29000
5 Bentley 350000
6 Citroen 21000
7 Hummer 41400
8 Volkswagen 21600
这是示例的输出。
PHP SQLite3 escapeString
escapeString()
返回已正确转义的字符串。
escape_string.php
<?php
db = new SQLite3('test.db');sql = "SELECT name FROM cars WHERE name = 'Audi'";
escaped = SQLite3::escapeString(sql);
var_dump(sql);
var_dump(escaped);
该示例对查询中的字符串进行转义。
$ php escape_string.php
string(41) "SELECT name FROM cars WHERE name = 'Audi'"
string(43) "SELECT name FROM cars WHERE name = ''Audi''"
PHP SQLite3 参数化语句
SQL 语句通常是动态构建的。 用户提供一些输入,并且此输入已内置到语句中。 每当我们处理来自用户的输入时,我们都必须谨慎。 它具有一些严重的安全隐患。 动态构建 SQL 语句的推荐方法是使用参数绑定。
使用prepare()
创建参数化查询; 它准备要执行的 SQL 语句并返回一个语句对象。
PHP SQLite3 具有bindParam()
和bindValue()
方法来将值绑定到占位符。 它允许将数据绑定到问号或命名的占位符。
带问号的参数化语句
在第一个示例中,我们使用问号的语法。
prepared.php
<?php
db = new SQLite3('test.db');stm = db->prepare('SELECT * FROM cars WHERE id = ?');stm->bindValue(1, 3, SQLITE3_INTEGER);
res =stm->execute();
row =res->fetchArray(SQLITE3_NUM);
echo "{row[0]} {row[1]} {$row[2]}";
我们选择使用问号占位符的汽车。
$stm = $db->prepare('SELECT * FROM cars WHERE id = ?');
问号?
是值的占位符。 稍后将这些值添加(绑定)到占位符。
$stm->bindValue(1, 3, SQLITE3_INTEGER);
使用bindValue()
,将值 3 绑定到问号占位符。 第一个参数是位置参数,用于标识占位符(可以有多个问号占位符)。
$ php prepared.php
3 Skoda 9000
具有命名占位符的参数化语句
第二个示例使用带有命名占位符的参数化语句。
prepared2.php
<?php
db = new SQLite3('test.db');stm = db->prepare('SELECT * FROM cars WHERE id = :id');stm->bindValue(':id', 1, SQLITE3_INTEGER);
res =stm->execute();
row =res->fetchArray(SQLITE3_NUM);
echo "{row[0]} {row[1]} {$row[2]}";
我们使用命名的占位符选择特定的汽车。
$stm = $db->prepare('SELECT * FROM cars WHERE id = :id');
命名的占位符以冒号开头。
PHP SQLite3 bind_param
bind_param()
将参数绑定到语句变量。 它可以用于处理多行。
bind_param.php
≪?php
db = new SQLite3(':memory:');db->exec("CREATE TABLE friends(id INTEGER PRIMARY KEY, firstname TEXT, lastname TEXT)");
stm =db->prepare("INSERT INTO friends(firstname, lastname) VALUES (?, ?)");
stm->bindParam(1,firstName);
stm->bindParam(2,lastName);
firstName = 'Peter';lastName = 'Novak';
stm->execute();firstName = 'Lucy';
lastName = 'Brown';stm->execute();
res =db->query('SELECT * FROM friends');
while (row =res->fetchArray()) {
echo "{row[0]} {row[1]} {$row[2]}\n";
}
在示例中,我们将两行插入到带有参数化语句的表中。 要绑定占位符,我们使用bind_param()
方法。
$ php bind_param.php
1 Peter Novak
2 Lucy Brown
PHP SQLite3 元数据
元数据是有关数据库中数据的信息。 SQLite 中的元数据包含有关表和列的信息,我们在其中存储数据。 受 SQL 语句影响的行数是元数据。 结果集中返回的行数和列数也属于元数据。
可以使用特定的 PHP SQLite3 方法,PRAGMA
命令或通过查询 SQLite 系统sqlite_master
表来获取 SQLite 中的元数据。
num_of_columns.php
<?php
db = new SQLite3('test.db');res = db->query("SELECT * FROM cars WHERE id = 1");cols = res->numColumns();
echo "There are {cols} columns in the result set\n";
numColumns()
返回结果集中的列数。
$ php num_of_columns.php
There are 3 columns in the result set
column_names.php
<?php
db = new SQLite3('test.db');res = db->query("PRAGMA table_info(cars)");
while (row = res->fetchArray(SQLITE3_NUM)) {
echo "{row[0]} {row[1]} {row[2]}\n";
}
在此示例中,我们发出PRAGMA table_info(tableName)
命令以获取有关cars
表的一些元数据信息。
$res = $db->query("PRAGMA table_info(cars)");
PRAGMA table_info(tableName)
命令为cars
表中的每一列返回一行。 结果集中的列包括列顺序号,列名称,数据类型,该列是否可以为NULL
以及该列的默认值。
while (row =res->fetchArray(SQLITE3_NUM)) {
echo "{row[0]} {row[1]} {$row[2]}\n";
}
根据提供的信息,我们打印列顺序号,列名称和列数据类型。
$ php column_names.php
0 id INTEGER
1 name TEXT
2 price INT
在下面的示例中,我们打印cars
表中的所有行及其列名。
column_names2.php
<?php
db = new SQLite3('test.db');res = db->query("SELECT * FROM cars");col1 = res->columnName(1);col2 = res->columnName(2);header = sprintf("%-10s %s\n", col1,col2);
echo header;
while (row = res->fetchArray()) {line = sprintf("%-10s %s\n", row[1],row[2]);
echo $line;
}
我们还将cars
表的内容与列名一起打印到控制台。 记录与列名对齐。
$col1 = $res->columnName(1);
columnName()
返回第 n 列的名称。
$header = sprintf("%-10s %s\n", $col1, $col2);
echo $header;
这些行打印cars
表的两个列名。
while (row =res->fetchArray()) {
line = sprintf("%-10s %s\n",row[1], row[2]);
echoline;
}
我们使用 while 循环打印行。 数据与列名对齐。
$ php column_names2.php
name price
Audi 52642
Mercedes 57127
Skoda 9000
Volvo 29000
Bentley 350000
Citroen 21000
Hummer 41400
Volkswagen 21600
在下一个示例中,我们列出test.db
数据库中的所有表。
list_tables.php
<?php
db = new SQLite3('test.db');res = db->query("SELECT name FROM sqlite_master WHERE type='table'");
while (row = res->fetchArray(SQLITE3_NUM)) {
echo "{row[0]}\n";
}
该代码示例将指定数据库中的所有可用表打印到终端。
$res = $db->query("SELECT name FROM sqlite_master WHERE type='table'");
表名存储在系统sqlite_master
表中。
$ php list_tables.php
cars
images
这些是我们系统上的表。
changes()
返回由最新 SQL 语句修改,插入或删除的数据库行数。
changes.php
<?php
db = new SQLite3(':memory:');db->exec("CREATE TABLE friends(id INTEGER PRIMARY KEY, name TEXT)");
db->exec("INSERT INTO friends(name) VALUES ('Tom')");db->exec("INSERT INTO friends(name) VALUES ('Rebecca')");
db->exec("INSERT INTO friends(name) VALUES ('Jim')");db->exec("INSERT INTO friends(name) VALUES ('Robert')");
db->exec('DELETE FROM friends');changes = db->changes();
echo "The DELETE statement removedchanges rows";
该示例返回已删除的行数。
$ php changes.php
The DELETE statement removed 4 rows
PHP SQLite3 PDO 示例
PHP 数据对象(PDO)定义了用于访问 PHP 中的数据库的轻量级接口。 它提供了一个数据访问抽象层,用于在 PHP 中使用数据库。 它定义了用于各种数据库系统的一致 API。
PHP PDO 是一个内置库; 我们不需要安装它。
list_tables.php
<?php
pdo = new PDO('sqlite:test.db');stm = pdo->query("SELECT * FROM cars");rows = stm->fetchAll(PDO::FETCH_NUM);
foreach(rows as row) {
printf("row[0] row[1]row[2]\n");
}
该示例使用 PHP PDO 获取所有表行。
Dibi 的例子
PHP Dibi 是用于 PHP 的小型智能数据库层。
$ composer req dibi/dibi
我们安装库。
fetch_cars.php
<?php
require('vendor/autoload.php');
db = dibi::connect([
'driver' => 'sqlite',
'database' => 'test.db',
]);rows = db->query('SELECT * FROM cars');
foreach (rows as row) {id = row->id;name = row->name;price = row->price;
echo "id nameprice \n";
}
该示例从cars
表中提取所有行。
Doctrine DBAL 示例
Doctrine 是一组 PHP 库,主要致力于在 PHP 中提供持久性服务。 它的主要项目是对象关系映射器(ORM)和数据库抽象层(DBAL)。
$ composer req doctrine/dbal
我们安装 Doctrine DBAL 软件包。
fetch_cars.php
<?php
require_once "vendor/autoload.php";
use Doctrine\DBAL\DriverManager;
use Doctrine\DBAL\FetchMode;
attrs = ['driver' => 'pdo_sqlite', 'path' => 'test.db'];conn = DriverManager::getConnection(attrs);queryBuilder = conn->createQueryBuilder();queryBuilder->select('*')->from('cars');
stm =queryBuilder->execute();
rows =stm->fetchAll(FetchMode::NUMERIC);
foreach (rows asrow) {
echo "{row[0]} {row[1]} {$row[2]}\n";
}
该示例使用 Doctrine DBAL QueryBuilder 从cars
表中检索所有行。
您可能也对以下相关教程感兴趣: Doctrine QueryBuilder 教程, PHP PDO 教程和 PHP 教程。