FuelPHP，PHP 5.3 框架 简体中文手册

简介

時序模型比它聽起來的更不可怕。

通常一个資料庫實體代表資料表中的一列，當它被更新時，舊資訊会被覆寫。時序模型允許資料以時間被引用，它使得在一个所給時間查詢一个實體狀態變为可能。

例如，假設你希望追蹤產品的變更，如此當一个訂单交易成功你可以知道產品的狀態而無須重複訂单資料表中的資料。你可以让產品有時序并且使用訂单時間來引用當時下訂產品的狀態，而非它們目前的狀態，不使用時序資料的情況下就可能会是當下的狀態。

時序模型也可被用在審核變更的事物像 wiki 頁面。任何變更会被自动記錄，而不須使用一張獨立的 log 資料表。

「實體」可能是你設計中的任何項目，例如產品、使用者、多媒體文件夾、任何你会使用做为模型的可被認为是一个實體。時序模型能让你透過儲存變更，來追蹤这些實體隨著時間推移的變化，每一組新的變更被稱为一个「修訂版本」。因为每一个修訂版本與時間（時序）資料一起儲存，这使得取得一个實體在所給任何時間的狀態變为可能。

这个時序模型的實现在相同資料表儲存實體的修訂版本做为原始資料，不再需要重複的 "log" 資料表。雖然这裡的實现不是實现修訂版本的唯一方式，它是在 ORM 所給的限制之下最彈性的方式，而且事實上，它必須在多種資料庫环境下運作。

为什么在 ORM 中實现而不是選擇一个允許該功能的資料庫系统？

在 ORM 中實现時序功能能让技術被抽象出資料庫層，这能让 ORM 支援的任何資料庫使用時序模型，提供更大的靈活性。此模型不会取代使用支援時序資訊的資料庫使用能力，但提供一个「開箱即用」的實现。

使用

資料表必須被設置一个實體 ID 的複合主鍵，一个标准的自动遞增数字（例如），以及代表有效時間跨度的時間戳記。

class Model_MyTemporal extends Orm\Model_Temporal
{
	protected static $_primary_key = array('id', 'temporal_start', 'temporal_end');
	protected static $_temporal = array(
		'start_column' => 'temporal_start', // 包含此筆資料有效起始時間的行名稱
		'end_column' => 'temporal_end', // 包含此筆資料有效結束時間的行名稱
		'mysql_timestamp' => false, // 如果設为 true 将使用 MySQL 時間戳記，否則是 UNIX 時間戳記
	);
}

請注意，主鍵應該是一个實體 ID 以及時序時間戳記的複合鍵。

任何使用時序模型定義的關聯應該只涉及 ID，而不是 ID 和時間戳記。