SQLite PHP


在本章中,你将学习如何在PHP程序中使用SQLite。

安装


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

Windows用户必须启用php_sqlite3.dll才能使用此扩展名。从PHP 5.3.0开始,此DLL包含在Windows的PHP发行版中。

有关详细的安装说明,请查看我们的PHP教程及其官方网站。

PHP接口API


以下是重要的PHP例程,这些例程足以满足你从PHP程序使用SQLite数据库的要求。如果你正在寻找更复杂的应用程序,则可以查阅PHP官方文档。

序号.API和说明
1

public void SQLite3::open ( filename, flags, encryption_key )

打开SQLite 3数据库。如果构建包含加密,则它将尝试使用密钥。

If the 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();
?>

执行上述程序后,它将在你的计算机中创建COMPANY表。test.db并显示以下消息:

Opened database successfully
Table created successfully

插入操作


以下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

查询操作


以下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

更新操作


以下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

删除操作


以下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