SQLite – PHP

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 程式碼顯示瞭如何連線到一個現有的資料庫。如果資料庫不存在,那麼它就會被建立,最後將返回一個數據庫物件。

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