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() 会尝试使用其值打开数据库文件。 如果不存在同名的文件,则创建同名的新数据库文件。

用于确定如何打开 SQLite 数据库的可选标志。 默认情况下,打开使用 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。 您可以根据需要更改路径。 如果数据库创建成功,那么它将显示以下消息 −

Open database successfully

创建表

下面的 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