sqlite php 編程接口

1. 安裝

自 php 5.3.0 起默認(rèn)啟用 sqlite3 擴(kuò)展。可以在編譯時(shí)使用 --without-sqlite3 禁用 sqlite3 擴(kuò)展。

windows 用戶必須啟用 php_sqlite3.dll 才能使用該擴(kuò)展。自 php 5.3.0 起，這個(gè) dll 被包含在 php 的 windows 分發(fā)版中。

如需了解詳細(xì)的安裝指導(dǎo)，建議查看我們的 php 教程和它的官方網(wǎng)站。

2. php 接口 api

以下是重要的 php 程序，可以滿足您在 php 程序中使用 sqlite 數(shù)據(jù)庫的需求。如果您需要了解更多細(xì)節(jié)，請(qǐng)查看 php 官方文檔。

序號(hào)	api & 描述
1	public void sqlite3::open ( filename, flags, encryption_key ) 打開一個(gè) sqlite 3 數(shù)據(jù)庫。如果構(gòu)建包括加密，那么它將嘗試使用的密鑰。如果文件名 filename 賦值為 ':memory:'，那么 sqlite3::open() 將會(huì)在 ram 中創(chuàng)建一個(gè)內(nèi)存數(shù)據(jù)庫，這只會(huì)在 session 的有效時(shí)間內(nèi)持續(xù)。如果文件名 filename 為實(shí)際的設(shè)備文件名稱，那么 sqlite3::open() 將使用這個(gè)參數(shù)值嘗試打開數(shù)據(jù)庫文件。如果該名稱的文件不存在，那么將創(chuàng)建一個(gè)新的命名為該名稱的數(shù)據(jù)庫文件。可選的 flags 用于判斷是否打開 sqlite 數(shù)據(jù)庫。默認(rèn)情況下，當(dāng)使用 sqlite3_open_readwrite \| sqlite3_open_create 時(shí)打開。
2	public bool sqlite3::exec ( string $query ) 該例程提供了一個(gè)執(zhí)行 sql 命令的快捷方式，sql 命令由 sql 參數(shù)提供，可以由多個(gè) sql 命令組成。該程序用于對(duì)給定的數(shù)據(jù)庫執(zhí)行一個(gè)無結(jié)果的查詢。
3	public sqlite3result sqlite3::query ( string $query ) 該例程執(zhí)行一個(gè) sql 查詢，如果查詢到返回結(jié)果則返回一個(gè) sqlite3result 對(duì)象。
4	public int sqlite3::lasterrorcode ( void ) 該例程返回最近一次失敗的 sqlite 請(qǐng)求的數(shù)值結(jié)果代碼。
5	public string sqlite3::lasterrormsg ( void ) 該例程返回最近一次失敗的 sqlite 請(qǐng)求的英語文本描述。
6	public int sqlite3::changes ( void ) 該例程返回最近一次的 sql 語句更新或插入或刪除的數(shù)據(jù)庫行數(shù)。
7	public bool sqlite3::close ( void ) 該例程關(guān)閉之前調(diào)用 sqlite3::open() 打開的數(shù)據(jù)庫連接。
8	public string sqlite3::escapestring ( string $value ) 該例程返回一個(gè)字符串，在 sql 語句中，出于安全考慮，該字符串已被正確地轉(zhuǎn)義。

3. 連接數(shù)據(jù)庫

下面的 php 代碼顯示了如何連接到一個(gè)現(xiàn)有的數(shù)據(jù)庫。如果數(shù)據(jù)庫不存在，那么它就會(huì)被創(chuàng)建，最后將返回一個(gè)數(shù)據(jù)庫對(duì)象。

<?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";
   }
?>

現(xiàn)在，讓我們來運(yùn)行上面的程序，在當(dāng)前目錄中創(chuàng)建我們的數(shù)據(jù)庫 test.db。您可以根據(jù)需要改變路徑。如果數(shù)據(jù)庫成功創(chuàng)建，那么會(huì)顯示下面所示的消息：

open database successfully

4. 創(chuàng)建表

下面的 php 代碼段將用于在先前創(chuàng)建的數(shù)據(jù)庫中創(chuàng)建一個(gè)表：

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

上述程序執(zhí)行時(shí)，它會(huì)在 test.db 中創(chuàng)建 company 表，并顯示下面所示的消息：

opened database successfully
table created successfully

5. insert 操作

下面的 php 程序顯示了如何在上面創(chuàng)建的 company 表中創(chuàng)建記錄：

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

上述程序執(zhí)行時(shí)，它會(huì)在 company 表中創(chuàng)建給定記錄，并會(huì)顯示以下兩行：

opened database successfully
records created successfully

6. select 操作

下面的 php 程序顯示了如何從前面創(chuàng)建的 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();
?>

上述程序執(zhí)行時(shí)，它會(huì)產(chǎn)生以下結(jié)果：

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

上述程序執(zhí)行時(shí)，它會(huì)產(chǎn)生以下結(jié)果：

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

上述程序執(zhí)行時(shí)，它會(huì)產(chǎn)生以下結(jié)果：

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

下一節(jié)：sqlite perl 編程接口

sqlite教程

相關(guān)文章

學(xué)習(xí)SQLite