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é)，請查看 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 命令組成。該程序用于對給定的數(shù)據(jù)庫執(zhí)行一個(gè)無結(jié)果的查詢。 |
| 3 | public sqlite3result sqlite3::query ( string $query )
該例程執(zhí)行一個(gè) sql 查詢，如果查詢到返回結(jié)果則返回一個(gè) sqlite3result 對象。 |
| 4 | public int sqlite3::lasterrorcode ( void )
該例程返回最近一次失敗的 sqlite 請求的數(shù)值結(jié)果代碼。 |
| 5 | public string sqlite3::lasterrormsg ( void )
該例程返回最近一次失敗的 sqlite 請求的英語文本描述。 |
| 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ù)庫對象。
<?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
學(xué)習(xí)SQLite