SQLite PHP 编程接口

sqlite php 编程接口

 

1. 安装

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

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

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

 

2. 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 语句中,出于安全考虑,该字符串已被正确地转义。

 

3. 连接数据库

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

 

4. 创建表

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

 

5. 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

 

6. 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

 

7. 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

 

8. 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

下一节:sqlite perl 编程接口

sqlite教程

相关文章