SQLite - PHP
在本章中，您将学习如何在 PHP 程序中使用 SQLite。
安装
从 PHP 5.3.0 开始，SQLite3 扩展默认启用。可以通过在编译时使用 --without-sqlite3 来禁用它。
Windows 用户必须启用 php_sqlite3.dll 才能使用此扩展。从 PHP 5.3.0 开始，此 DLL 已包含在 PHP 的 Windows 发行版中。
有关详细的安装说明，请查看我们的 PHP 教程及其官方网站。
PHP 接口 API
以下是重要的 PHP 例程，可以满足您从 PHP 程序中使用 SQLite 数据库的需求。如果您需要更复杂的应用程序，可以参考 PHP 官方文档。
| 序号 | API & 描述 |
|---|---|
| 1 | public void SQLite3::open ( filename, flags, encryption_key ) 打开 SQLite 3 数据库。如果构建包含加密功能，则会尝试使用密钥。 如果 filename 指定为 ':memory:'，则 SQLite3::open() 将在 RAM 中创建一个仅在会话期间有效的内存数据库。 如果文件名是实际的设备文件名，SQLite3::open() 将尝试使用其值打开数据库文件。如果该名称的文件不存在，则会创建一个新的同名数据库文件。 可选的 flags 用于确定如何打开 SQLite 数据库。默认情况下，open 使用 SQLITE3_OPEN_READWRITE | SQLITE3_OPEN_CREATE。 |
| 2 | public bool SQLite3::exec ( string $query ) 此例程提供了一种快速、简单的方式来执行 sql 参数提供的 SQL 命令，该参数可以包含多个 SQL 命令。此例程用于对给定数据库执行不返回结果的查询。 |
| 3 | public SQLite3Result SQLite3::query ( string $query ) 此例程执行 SQL 查询，如果查询返回结果，则返回 SQLite3Result 对象。 |
| 4 | public int SQLite3::lastErrorCode ( void ) 此例程返回最近失败的 SQLite 请求的数字结果代码。 |
| 5 | public string SQLite3::lastErrorMsg ( void ) 此例程返回描述最近失败的 SQLite 请求的英文文本。 |
| 6 | public int SQLite3::changes ( void ) 此例程返回最近的 SQL 语句更新、插入或删除的数据库行数。 |
| 7 | public bool SQLite3::close ( void ) 此例程关闭先前通过 SQLite3::open() 调用打开的数据库连接。 |
| 8 | public string SQLite3::escapeString ( string $value ) 此例程返回一个已正确转义的字符串，可安全地包含在 SQL 语句中。 |
连接数据库
以下 PHP 代码展示了如何连接到现有数据库。如果数据库不存在，则会创建它，并最终返回一个数据库对象。
<?php
class MyDB extends SQLite3 {
function __construct() {
$this->open('test.db');
}
}
$db = new MyDB();
if(!$db) {
echo $db->lastErrorMsg();
} else {
echo "Opened database successfully\n";
}
?>
现在，让我们运行上述程序，在当前目录中创建我们的数据库 test.db。您可以根据需要更改路径。如果数据库创建成功，将显示以下消息 −
数据库打开成功
创建表
以下 PHP 程序将用于在之前创建的数据库中创建一个表。
<?php
class MyDB extends SQLite3 {
function __construct() {
$this->open('test.db');
}
}
$db = new MyDB();
if(!$db) {
echo $db->lastErrorMsg();
} else {
echo "Opened database successfully\n";
}
$sql =<<<EOF
CREATE TABLE COMPANY
(ID INT PRIMARY KEY NOT NULL,
NAME TEXT NOT NULL,
AGE INT NOT NULL,
ADDRESS CHAR(50),
SALARY REAL);
EOF;
$ret = $db->exec($sql);
if(!$ret){
echo $db->lastErrorMsg();
} else {
echo "Table created successfully\n";
}
$db->close();
?>
执行上述程序后，它将在您的 test.db 中创建 COMPANY 表，并显示以下消息 −
Opened database successfully Table created successfully
INSERT 操作
以下 PHP 程序展示了如何在上述示例中创建的 COMPANY 表中创建记录。
<?php
class MyDB extends SQLite3 {
function __construct() {
$this->open('test.db');
}
}
$db = new MyDB();
if(!$db){
echo $db->lastErrorMsg();
} else {
echo "Opened database successfully\n";
}
$sql =<<<EOF
INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (1, 'Paul', 32, 'California', 20000.00 );
INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (2, 'Allen', 25, 'Texas', 15000.00 );
INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (3, 'Teddy', 23, 'Norway', 20000.00 );
INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
VALUES (4, 'Mark', 25, 'Rich-Mond ', 65000.00 );
EOF;
$ret = $db->exec($sql);
if(!$ret) {
echo $db->lastErrorMsg();
} else {
echo "Records created successfully\n";
}
$db->close();
?>
执行上述程序后，它将在 COMPANY 表中创建指定的记录，并显示以下两行。
Opened database successfully Records created successfully
SELECT 操作
以下 PHP 程序展示了如何从上述示例中创建的 COMPANY 表中获取并显示记录 −
<?php
class MyDB extends SQLite3 {
function __construct() {
$this->open('test.db');
}
}
$db = new MyDB();
if(!$db) {
echo $db->lastErrorMsg();
} else {
echo "Opened database successfully\n";
}
$sql =<<<EOF
SELECT * from COMPANY;
EOF;
$ret = $db->query($sql);
while($row = $ret->fetchArray(SQLITE3_ASSOC) ) {
echo "ID = ". $row['ID'] . "\n";
echo "NAME = ". $row['NAME'] ."\n";
echo "ADDRESS = ". $row['ADDRESS'] ."\n";
echo "SALARY = ".$row['SALARY'] ."\n\n";
}
echo "Operation done successfully\n";
$db->close();
?>
执行上述程序后，它将产生以下结果。
Opened database successfully ID = 1 NAME = Paul ADDRESS = California SALARY = 20000 ID = 2 NAME = Allen ADDRESS = Texas SALARY = 15000 ID = 3 NAME = Teddy ADDRESS = Norway SALARY = 20000 ID = 4 NAME = Mark ADDRESS = Rich-Mond SALARY = 65000 Operation done successfully
UPDATE 操作
以下 PHP 代码展示了如何使用 UPDATE 语句更新任意记录，然后从 COMPANY 表中获取并显示更新后的记录。
<?php
class MyDB extends SQLite3 {
function __construct() {
$this->open('test.db');
}
}
$db = new MyDB();
if(!$db) {
echo $db->lastErrorMsg();
} else {
echo "Opened database successfully\n";
}
$sql =<<<EOF
UPDATE COMPANY set SALARY = 25000.00 where ID=1;
EOF;
$ret = $db->exec($sql);
if(!$ret) {
echo $db->lastErrorMsg();
} else {
echo $db->changes(), " Record updated successfully\n";
}
$sql =<<<EOF
SELECT * from COMPANY;
EOF;
$ret = $db->query($sql);
while($row = $ret->fetchArray(SQLITE3_ASSOC) ) {
echo "ID = ". $row['ID'] . "\n";
echo "NAME = ". $row['NAME'] ."\n";
echo "ADDRESS = ". $row['ADDRESS'] ."\n";
echo "SALARY = ".$row['SALARY'] ."\n\n";
}
echo "Operation done successfully\n";
$db->close();
?>
执行上述程序时，将产生以下结果。
Opened database successfully 1 Record updated successfully ID = 1 NAME = Paul ADDRESS = California SALARY = 25000 ID = 2 NAME = Allen ADDRESS = Texas SALARY = 15000 ID = 3 NAME = Teddy ADDRESS = Norway SALARY = 20000 ID = 4 NAME = Mark ADDRESS = Rich-Mond SALARY = 65000 Operation done successfully
DELETE 操作
以下 PHP 代码展示了如何使用 DELETE 语句删除任意记录，然后从 COMPANY 表中获取并显示剩余记录。
<?php
class MyDB extends SQLite3 {
function __construct() {
$this->open('test.db');
}
}
$db = new MyDB();
if(!$db) {
echo $db->lastErrorMsg();
} else {
echo "Opened database successfully\n";
}
$sql =<<<EOF
DELETE from COMPANY where ID = 2;
EOF;
$ret = $db->exec($sql);
if(!$ret){
echo $db->lastErrorMsg();
} else {
echo $db->changes(), " Record deleted successfully\n";
}
$sql =<<<EOF
SELECT * from COMPANY;
EOF;
$ret = $db->query($sql);
while($row = $ret->fetchArray(SQLITE3_ASSOC) ) {
echo "ID = ". $row['ID'] . "\n";
echo "NAME = ". $row['NAME'] ."\n";
echo "ADDRESS = ". $row['ADDRESS'] ."\n";
echo "SALARY = ".$row['SALARY'] ."\n\n";
}
echo "Operation done successfully\n";
$db->close();
?>
执行上述程序时，将产生以下结果。
Opened database successfully 1 Record deleted successfully ID = 1 NAME = Paul ADDRESS = California SALARY = 25000 ID = 3 NAME = Teddy ADDRESS = Norway SALARY = 20000 ID = 4 NAME = Mark ADDRESS = Rich-Mond SALARY = 65000 Operation done successfully