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 & 描述 |
|---|---|
| 1 | public 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 時打開。 |
| 2 | public bool sqlite3::exec ( string $query )
該例程提供了一個執行 sql 命令的快捷方式，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 語句中，出于安全考慮，該字符串已被正確地轉義。 |
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