SQLite – PHP

安装

自 PHP 5.3.0 起默认启用 SQLite3 扩展。可以在编译时使用 --without-sqlite3 禁用 SQLite3 扩展。

Windows 用户必须启用 php_sqlite3.dll 才能使用该扩展。自 PHP 5.3.0 起，这个 DLL 被包含在 PHP 的 Windows 分发版中。

如需了解详细的安装指导，建议查看我们的 PHP 教程和它的官方网站。

PHP 接口 API

以下是重要的 PHP 程序，可以满足您在 PHP 程序中使用 SQLite 数据库的需求。如果您需要了解更多细节，请查看 PHP 官方文档。

序号API & 描述
1public void SQLite3::open ( filename, flags, encryption_key )

打开一个 SQLite 3 数据库。如果构建包括加密，那么它将尝试使用的密钥。

如果文件名 filename 赋值为 ‘:memory:’，那么 SQLite3::open() 将会在 RAM 中创建一个内存数据库，这只会在 session 的有效时间内持续。

如果文件名 filename 为实际的设备文件名称，那么 SQLite3::open() 将使用这个参数值尝试打开数据库文件。如果该名称的文件不存在，那么将创建一个新的命名为该名称的数据库文件。

可选的 flags 用于判断是否打开 SQLite 数据库。默认情况下，当使用 SQLITE3_OPEN_READWRITE | SQLITE3_OPEN_CREATE 时打开。

2public bool SQLite3::exec ( string $query )

该例程提供了一个执行 SQL 命令的快捷方式，SQL 命令由 sql 参数提供，可以由多个 SQL 命令组成。该程序用于对给定的数据库执行一个无结果的查询。

3public SQLite3Result SQLite3::query ( string $query )

该例程执行一个 SQL 查询，如果查询到返回结果则返回一个 SQLite3Result 对象。

4public int SQLite3::lastErrorCode ( void )

该例程返回最近一次失败的 SQLite 请求的数值结果代码。

5public string SQLite3::lastErrorMsg ( void )

该例程返回最近一次失败的 SQLite 请求的英语文本描述。

6public int SQLite3::changes ( void )

该例程返回最近一次的 SQL 语句更新或插入或删除的数据库行数。

7public bool SQLite3::close ( void )

该例程关闭之前调用 SQLite3::open() 打开的数据库连接。

8public string SQLite3::escapeString ( string $value )

该例程返回一个字符串，在 SQL 语句中，出于安全考虑，该字符串已被正确地转义。

连接数据库

下面的 PHP 代码显示了如何连接到一个现有的数据库。如果数据库不存在，那么它就会被创建，最后将返回一个数据库对象。

  1. <?php
  2.    class MyDB extends SQLite3
  3.    {
  4.       function __construct()
  5.       {
  6.          $this->open('test.db');
  7.       }
  8.    }
  9.    $db = new MyDB();
  10.    if(!$db){
  11.       echo $db->lastErrorMsg();
  12.    } else {
  13.       echo "Opened database successfully\n";
  14.    }
  15. ?>

现在，让我们来运行上面的程序，在当前目录中创建我们的数据库 test.db。您可以根据需要改变路径。如果数据库成功创建，那么会显示下面所示的消息：

  1.     Open database successfully

创建表

下面的 PHP 代码段将用于在先前创建的数据库中创建一个表：

  1.   <?php
  2.    class MyDB extends SQLite3
  3.    {
  4.       function __construct()
  5.       {
  6.          $this->open('test.db');
  7.       }
  8.    }
  9.    $db = new MyDB();
  10.    if(!$db){
  11.       echo $db->lastErrorMsg();
  12.    } else {
  13.       echo "Opened database successfully\n";
  14.    }
  16.    $sql =<<<EOF
  17.       CREATE TABLE COMPANY
  18.       (ID INT PRIMARY KEY     NOT NULL,
  19.       NAME           TEXT    NOT NULL,
  20.       AGE            INT     NOT NULL,
  21.       ADDRESS        CHAR(50),
  22.       SALARY         REAL);
  23. EOF;
  25.    $ret = $db->exec($sql);
  26.    if(!$ret){
  27.       echo $db->lastErrorMsg();
  28.    } else {
  29.       echo "Table created successfully\n";
  30.    }
  31.    $db->close();
  32. ?>

上述程序执行时，它会在 test.db 中创建 COMPANY 表，并显示下面所示的消息：

  1.     Opened database successfully
  2.     Table created successfully

INSERT 操作

下面的 PHP 程序显示了如何在上面创建的 COMPANY 表中创建记录：

  1. <?php
  2.    class MyDB extends SQLite3
  3.    {
  4.       function __construct()
  5.       {
  6.          $this->open('test.db');
  7.       }
  8.    }
  9.    $db = new MyDB();
  10.    if(!$db){
  11.       echo $db->lastErrorMsg();
  12.    } else {
  13.       echo "Opened database successfully\n";
  14.    }
  16.    $sql =<<<EOF
  17.       INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
  18.       VALUES (1, 'Paul', 32, 'California', 20000.00 );
  20.       INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
  21.       VALUES (2, 'Allen', 25, 'Texas', 15000.00 );
  23.       INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
  24.       VALUES (3, 'Teddy', 23, 'Norway', 20000.00 );
  26.       INSERT INTO COMPANY (ID,NAME,AGE,ADDRESS,SALARY)
  27.       VALUES (4, 'Mark', 25, 'Rich-Mond ', 65000.00 );
  28. EOF;
  30.    $ret = $db->exec($sql);
  31.    if(!$ret){
  32.       echo $db->lastErrorMsg();
  33.    } else {
  34.       echo "Records created successfully\n";
  35.    }
  36.    $db->close();
  37. ?>

上述程序执行时，它会在 COMPANY 表中创建给定记录，并会显示以下两行：

  1.     Opened database successfully
  2.     Records created successfully

SELECT 操作

下面的 PHP 程序显示了如何从前面创建的 COMPANY 表中获取并显示记录：

  1. <?php
  2.    class MyDB extends SQLite3
  3.    {
  4.       function __construct()
  5.       {
  6.          $this->open('test.db');
  7.       }
  8.    }
  9.    $db = new MyDB();
  10.    if(!$db){
  11.       echo $db->lastErrorMsg();
  12.    } else {
  13.       echo "Opened database successfully\n";
  14.    }
  16.    $sql =<<<EOF
  17.       SELECT * from COMPANY;
  18. EOF;
  20.    $ret = $db->query($sql);
  21.    while($row = $ret->fetchArray(SQLITE3_ASSOC) ){
  22.       echo "ID = ". $row['ID'] . "\n";
  23.       echo "NAME = ". $row['NAME'] ."\n";
  24.       echo "ADDRESS = ". $row['ADDRESS'] ."\n";
  25.       echo "SALARY =  ".$row['SALARY'] ."\n\n";
  26.    }
  27.    echo "Operation done successfully\n";
  28.    $db->close();
  29. ?>

上述程序执行时，它会产生以下结果：

  1.     Opened database successfully
  2.     ID = 1
  3.     NAME = Paul
  4.     ADDRESS = California
  5.     SALARY =  20000
  7.     ID = 2
  8.     NAME = Allen
  9.     ADDRESS = Texas
  10.     SALARY =  15000
  12.     ID = 3
  13.     NAME = Teddy
  14.     ADDRESS = Norway
  15.     SALARY =  20000
  17.     ID = 4
  18.     NAME = Mark
  19.     ADDRESS = Rich-Mond
  20.     SALARY =  65000
  22.     Operation done successfully

UPDATE 操作

下面的 PHP 代码显示了如何使用 UPDATE 语句来更新任何记录，然后从 COMPANY 表中获取并显示更新的记录：

  1. <?php
  2.    class MyDB extends SQLite3
  3.    {
  4.       function __construct()
  5.       {
  6.          $this->open('test.db');
  7.       }
  8.    }
  9.    $db = new MyDB();
  10.    if(!$db){
  11.       echo $db->lastErrorMsg();
  12.    } else {
  13.       echo "Opened database successfully\n";
  14.    }
  15.    $sql =<<<EOF
  16.       UPDATE COMPANY set SALARY = 25000.00 where ID=1;
  17. EOF;
  18.    $ret = $db->exec($sql);
  19.    if(!$ret){
  20.       echo $db->lastErrorMsg();
  21.    } else {
  22.       echo $db->changes(), " Record updated successfully\n";
  23.    }
  25.    $sql =<<<EOF
  26.       SELECT * from COMPANY;
  27. EOF;
  28.    $ret = $db->query($sql);
  29.    while($row = $ret->fetchArray(SQLITE3_ASSOC) ){
  30.       echo "ID = ". $row['ID'] . "\n";
  31.       echo "NAME = ". $row['NAME'] ."\n";
  32.       echo "ADDRESS = ". $row['ADDRESS'] ."\n";
  33.       echo "SALARY =  ".$row['SALARY'] ."\n\n";
  34.    }
  35.    echo "Operation done successfully\n";
  36.    $db->close();
  37. ?>

上述程序执行时，它会产生以下结果：

  1.     Opened database successfully
  2.     1 Record updated successfully
  3.     ID = 1
  4.     NAME = Paul
  5.     ADDRESS = California
  6.     SALARY =  25000
  8.     ID = 2
  9.     NAME = Allen
  10.     ADDRESS = Texas
  11.     SALARY =  15000
  13.     ID = 3
  14.     NAME = Teddy
  15.     ADDRESS = Norway
  16.     SALARY =  20000
  18.     ID = 4
  19.     NAME = Mark
  20.     ADDRESS = Rich-Mond
  21.     SALARY =  65000
  23.     Operation done successfully

DELETE 操作

下面的 PHP 代码显示了如何使用 DELETE 语句删除任何记录，然后从 COMPANY 表中获取并显示剩余的记录：

  1.   <?php
  2.    class MyDB extends SQLite3
  3.    {
  4.       function __construct()
  5.       {
  6.          $this->open('test.db');
  7.       }
  8.    }
  9.    $db = new MyDB();
  10.    if(!$db){
  11.       echo $db->lastErrorMsg();
  12.    } else {
  13.       echo "Opened database successfully\n";
  14.    }
  15.    $sql =<<<EOF
  16.       DELETE from COMPANY where ID=2;
  17. EOF;
  18.    $ret = $db->exec($sql);
  19.    if(!$ret){
  20.      echo $db->lastErrorMsg();
  21.    } else {
  22.       echo $db->changes(), " Record deleted successfully\n";
  23.    }
  25.    $sql =<<<EOF
  26.       SELECT * from COMPANY;
  27. EOF;
  28.    $ret = $db->query($sql);
  29.    while($row = $ret->fetchArray(SQLITE3_ASSOC) ){
  30.       echo "ID = ". $row['ID'] . "\n";
  31.       echo "NAME = ". $row['NAME'] ."\n";
  32.       echo "ADDRESS = ". $row['ADDRESS'] ."\n";
  33.       echo "SALARY =  ".$row['SALARY'] ."\n\n";
  34.    }
  35.    echo "Operation done successfully\n";
  36.    $db->close();
  37. ?>

上述程序执行时，它会产生以下结果：

  1.     Opened database successfully
  2.     1 Record deleted successfully
  3.     ID = 1
  4.     NAME = Paul
  5.     ADDRESS = California
  6.     SALARY =  25000
  8.     ID = 3
  9.     NAME = Teddy
  10.     ADDRESS = Norway
  11.     SALARY =  20000
  13.     ID = 4
  14.     NAME = Mark
  15.     ADDRESS = Rich-Mond
  16.     SALARY =  65000
  18.     Operation done successfully