「有沒有新任務?」這種需求,如果用整頁刷新去問,使用者體驗會非常糟。做法是讓瀏覽器每隔一段時間非同步問一次伺服器,有資料才更新畫面上的提示區。本文以 FLEA 框架搭配 Smarty 示範完整實作。
taskofpig ├─ Controller ├─ Dao ├─ js ├─ music ├─ tpl ├─ tpl_c └─ _log
CREATE TABLE `task` ( `id` int(11) NOT NULL, `title` varchar(100) NOT NULL, `desc` text, `date` datetime NOT NULL, `created` int(11) default NULL, `updated` int(11) default NULL, PRIMARY KEY (`id`) ) ENGINE=MyISAM DEFAULT CHARSET=utf8; CREATE TABLE `task_seq` ( `id` int(11) NOT NULL ) ENGINE=MyISAM DEFAULT CHARSET=utf8;
另外用一張 task_seq 表存放流水號,是為了避開 MyISAM 沒有 AUTO_INCREMENT 情境下的取號問題。
<?php
date_default_timezone_set("Asia/Shanghai"); // 設定正確時區
define('TASKOFPIG_DIR', dirname(__FILE__));
require('../phplibs/FLEA/FLEA.php');
FLEA::import(TASKOFPIG_DIR); // 把當前目錄加入環境變數
FLEA::loadAppInf('appConfig.php'); // 設定檔獨立出來,好維護
FLEA::init();
FLEA::loadClass('FLEA_Db_TableDataGateway'); // 這個類不會自動載入
FLEA::runMVC();
?>
<?php
return array(
'dispatcher' => 'FLEA_Dispatcher_Simple',
'controllerAccessor' => 'ctl',
'actionAccessor' => 'act',
'view' => 'FLEA_View_Smarty',
'viewConfig' => array(
'smartyDir' => '../phplibs/Smarty',
'template_dir' => './tpl',
'compile_dir' => './tpl_c',
'left_delimiter' => '<%',
'right_delimiter' => '%>',
'debugging' => false
),
'dbDSN' => array(
'driver' => 'mysql', 'host' => 'localhost',
'login' => 'dbuser', 'password' => 'dbpass',
'database' => 'dbname', 'charset ' => 'utf8'
),
'logFileDir' => './log',
'logFilename' => 'task_admin.log'
);
?>
<?php
// 生氣豬的任務計畫表
class Dao_TaskTable extends FLEA_Db_TableDataGateway
{
var $tableName = 'task'; // 指定資料表
var $primaryKey = 'id'; // 指定主鍵
}
?>
真正負責「即時提示」的是這個方法——依當前時間查詢是否有到期任務,有就輸出 JSON,沒有就回傳時間字串:
function queryTaskForDate($date = null) {
$thisDao = & new Dao_TaskTable();
$row = $thisDao->find(array('date' => date('Y-m-d H:i:s')));
unset($thisDao);
if (!empty($row)) {
$jsonobj = new Services_JSON();
echo $jsonobj->encode($row);
} else {
die(date('Y-m-d H:i:s'));
}
}
前端只要比對回傳內容是不是「純時間字串」就能判斷有沒有新任務,不必解析複雜結構。
function toModulePage() {
if ($_REQUEST['op'] == 'search') {
$this->queryTaskForDate();
} else if ($_REQUEST['op'] == 'add') {
$this->smarty->assign('opname', '添加新任務');
$this->smarty->assign('taskTime', date('Y-m-d H:i:s'));
$this->call_fck('desc', '');
$this->_showPage('taskofpig.add.html');
} else if ($_REQUEST['op'] == 'del') {
if (isset($_REQUEST['id']) && is_numeric($_REQUEST['id']))
$this->deleteTask($_REQUEST['id']);
$this->listTask();
} else if ($_REQUEST['op'] == 'edit') {
// 載入既有內容餵給 FCKeditor
$this->_showPage('taskofpig.edit.html');
} else {
$this->listTask();
}
}
新增與修改都透過 call_fck() 把 FCKeditor 產生的 HTML 塞進樣板變數,讓描述欄位能編輯富文本。列表頁則用 mb_substr($row['desc'], 0, 40, 'UTF-8') 把描述裁成摘要,避免表格被長文撐壞。
輪詢式即時提示要注意兩件事:一是伺服器端要對「查無資料」這種最常見的情況做快速回應,避免每次輪詢都觸發完整 ORM 流程;二是使用者切到別的分頁或離開時應停止輪詢,可用 document.visibilityState 判斷。此外範例直接取用 $_REQUEST 未做過濾,正式環境請改用框架的參數解析並加上權限檢查,刪除類操作尤其要確認來源。