eddie@Home

Refactoring in AS3

eddie — Thu, 29 Jul 2010 01:08:48 +0800

最近連續兩場上台講話，深深覺得自己的口條跟講話的速度還得再好好的修練。這是今天在同業的AS聚會上講的內容 Refactoring in AS3

Refactoring in AS3

View more presentations from Eddie Kao.

另外這是在上星期的Flash聚會分享的 AS3 Better Practices

AS3 Better Practices

View more presentations from Eddie Kao.

有需要歡迎取用 :)

Ruby on Rails之門外漢心得

eddie — Fri, 16 Jul 2010 11:59:56 +0800

這不是討戰文，也不是一篇討論程式語言的誰優誰劣的文章，反而比較像是昇火、勸敗文
僅就我個人這半年來使用Ruby on Rails(以下簡稱RoR，不是那個那個RO線上遊戲)用在工作上的一些簡單的心得跟大家分享

很多廠商喜歡做網路活動來促銷新商品、打知名度或是跟網友拉近距離。目前廠商們比較愛的網路活動，大概有上傳照片、影片、票選、轉寄、推薦..等，而隨著"社會的進步"，客戶們也"得跟上時代"，都不免俗的要跟FB或plurk弄在一起，而我的工作，主要就是幫客戶處理這樣的需求。(我想這段我的同業應該知道我是在講反話!)

就我而言，我個人比較熟悉的程式語言算是ActionScript 2/3，大部份的工作也都是跟紅紅的flash為伍。但後來的網路活動越弄越複雜，單純的flash已經不見得夠用了，很多時候得跟server端交換資料。

從最早的asp，後來換到php，其實都還不錯用，也沒什麼問題(不然php現在不會有這麼大的市佔率)。後來試著用php的zend framework，因為現在比較流行的web framework都有照著MVC(Model-View-Controller)的樣子來打造，寫起來程式碼跟頁面有更清楚的感覺。

2009年試著換到python加django，它也是MVC的實作，感覺還不賴，有種程式寫起來可以打更少字的感覺。而且它所謂的batteries included，只要把一些設定打開，後台管理功能就直接做起來了，相當方便。

2010年起，我試著開始把案子用RoR來做，整個有種「我終於可以把時間花在~~吃喝玩樂~~寫AS上了」的感覺了。

以下是一些大家可能會有的疑問：

Q: 為什麼你要一直換?
A: 我是善變的人 :)

Q: 你是寫AS的，為什麼要自己寫server端的程式?
A: 情況允許的話當然我也想跟別人一起合作寫，不過網路活動很多都是急件，而且客戶通常不太會管你六日週末要不要休假。後來發現其實自己寫真的還挺快的，而要什麼資料或是要接什麼資料都可以自己加一下就搞定，免看人臉色。

Q: RoR是一種程式語言嗎?
A: 不是，它是一種framework，它本身用的程式語言是Ruby

Q: RoR要錢嗎?
A: 不用的，而且你有興趣的話，還可以取得完整的原始碼，印出來上廁所的時候閱讀 :)

Q: 為什麼用RoR來開發會快?
A: 以下的動作我先假設開發的工程師有一些RoR的開發經驗。

以一個發票登錄的程式來說，假設它需要使用者姓名、電話、地址、Email及發票號碼等幾個欄位，我的動作就是先建立一個Model來對應這些欄位(這動作大概1~2分鐘左右可完成)。再來就是建立一個Controller來準備接收使用者submit出來的動作(大概1~2分鐘左右)，而實際在Controller裡寫的程式碼，也就是把Model給叫出來，把使用者post的資料餵進去，程式碼如下：

invoice = Invoice.new(params[:invoice])

最後再一個save的動作

invoice.save

差不多就搞定了(這動作大概1分鐘左右可完成)

剛剛這些資料庫寫入的動作，再加上一些if..else的判斷，大概10行程式碼有找。整個發票程式部份，不包含設計的話，大概5分鐘能寫完，也許如果再加個發票重複登錄判斷的驗證，最多應該10分鐘搞定。

那要怎麼把資料庫裡的東西撈出來? 通常只要一行：

invoice = Invoice.all (大概3~10秒，依打字速度不同而有差異)

那要怎麼樣把它餵給flash? RoR的ActiveRecord有支援直接輸出成XML或JSON的方法，簡單的可以直接用invoice.to_xml 或invoice.to_json 就行了(大概10秒)，複雜一點的，也可以用xml builder來建個模板給它(看複雜程度，大概5分鐘內搞定)。

藉由ORM(Object-Relational Mapping)的包裝，把原本要用SQL操作的動作，都改用物件的方式來操作。而大部份的網路活動的寫入/查詢語法都挺單純，沒意外的話應該都不用自己寫SELECT * FROM 或是 INSERT INTO之類的東西了，不只操作簡單，也可避開SQL Injection的麻煩。

另外RoR的另一大優點，就是它有相當多好用的外掛(plugin)，而且幾乎都是免費可以取得的(含原始碼)

一樣以網路活動上傳照片這個來舉例，上傳照片之後，通常得自動再產生一些比較小尺寸的縮圖，可能還要裁切一下圖片。透過某個方便的外掛(paperclip)，上面這些動作，真正要寫程式好像不到5行吧，搞定之後會有種「哇賽!怎麼就這樣就可以了?」的驚奇感。

再例如上傳照片後，資料一多，前端呈現的頁面通常就得有分頁的功能，而這功能透過某個方便的外掛(will_paginate)，大概只要多加一行程式碼就可以搞定分頁的工作。

Q: 可是你知道，做網路的活動，客戶很愛改來改去...RoR改起來會不會很麻煩?
A: 網路活動的特性，就是變動性高。除了設計部份可能會被改來改去外，一會可能要你加個中獎名單，一會說這個頁面要放到另一個頁面之後...愛改來改去這件事，我想這個是許多同業的痛!

老實說，就以上面的例子來說，就算整個砍掉重練，也不見得花多少時間；如果是修改流程，說不定改一下route規則就可以技巧性的處理掉了，其實面對愛改來改去的狀況，RoR還是個不錯的應對工具。

Q: RoR效能好嗎?
A: 我沒比較過所有家的程式語言以及web framework，所以我沒辦法下這個結論。通常如果遇到效能差或是資料庫負載很吃重的地方，可以把它做cache或產出靜態頁面來提昇效能，而做cache或是把cache給expire掉的動作，在RoR裡是很容易做的。

Q: 那，Ruby好寫嗎?
A: 我以AS程式碼來舉個例子：
if (my_age >= 30)
{
trace("you're so old!");
}

改用ruby寫的話：

if my_age >= 30
puts "you're so old!"
end

基本上少了小括號、大括號，也不用分號結尾，至少就可以少打好些個字，甚如果想要的話，if也可以放到後面：

puts "you're so old" if my_age >= 30

如何? 看起來更像一般的英文吧

再例如如果我想要印出3天前的日期，有的程式語言可能要先new一個Date物件出來，再透過一些method可以取得日期。在Ruby裡，只要用「3.days.ago」就行了。3? 它不是數字嗎? 是的，你沒看錯，在Ruby裡什麼東西都是物件，包括數字也是，所以你可以對3這個物件呼叫方法，再來個例子：

3.times do
puts 'hello'
end

猜得出來它在幹嘛嗎? 它就是把"hello"這個字串印3遍...

其它關於這個程式語言的細節，如果想了解更多，可參考Ruby的官網，有相當多的文件可以看

Q: 在flash裡可以用AMF的格式與server端溝通，RoR能做嗎?
A: 可以的，請參考 http://blog.eddie.com.tw/2010/03/18/rubyamf

Q: 還有什麼好處?
A: 前面提到，由於大部份的客戶想要做的東西都差不多，例如發票登錄來說，可以的話，也可以把這些常用的功能也做成「發票plugin」，也許下次要用的時候，就把plugin裝上去，可能再做一些微調就行了。

Q: 那，好維護嗎?
A: 基本上RoR的骨架是依照MVC的架構來實做的，所以某A或某B寫的程式碼，只要寫的人不要用太奇怪的寫法，大概都可以知道XX程式或XX功能會放在哪裡(當然改不改得動是另一回事)。重點是，很多網路活動都是短期的，活動結束就會下架，老實說並沒有太多所謂的維護的問題 :)

Q: RoR好像被我講得很神，那它缺點是什麼?
1. 它的學習曲線的高低決定於開發者的背景知識跟經驗
如果你之前就有用別的程式語言開發過網站，那RoR對你來說應該會比較快上手；如果你對於什麼是Form、什麼是GET/POST還不清楚的話，那這個對你來說可能會有些吃力，很容易卡關。特別是如果沒有個導師帶入門，還真的很容易碰壁。 (PS: 其實最好還有一些*nix的操作經驗，以及熟悉一些版本控制系統如SVN或Git)

2. 台灣的hosting比較不好找
台灣目前使用的人口還是相當少，國外雖然有比較多的solution，但客戶的網路活動的TA大部份都是在台灣，可能會有連線速度不夠快的問題。這個我解決的方法就是，我自己弄一台機器放機房，自己弄環境起來 :)

綜合以上各項優缺點，我真的覺得RoR挺適合拿來做網路活動，當然做長期的官網也合適，這裡就我自己工作上常遇到的狀況提供一些建議。

以上，僅以我這半年來用RoR的一些小小心得與大家分享，我也還是個一隻腳剛踏進去的新手門外漢，內容若有誤再請前輩、神人們不吝指教 :)

Python and Django Tutorial

eddie — Tue, 18 May 2010 17:29:46 +0800

最近有機會去資策會講課(python/django)，剛好趁這個機會把手邊的一些資料整理一下，方便自己記憶也方便讓大家直接剪下貼上程式碼，免去打錯字的困擾。有需要的朋友歡迎取用。

Python

Django

內容主要以python 2.x及django 1.1.x為主，若發現有誤還請不吝告知 :)

話說今天django的1.2版也release了(release note)，再找個機會把手邊用1.1.1寫過的小案子昇級看看，希望不會爆炸 :)

Testing with Cucumber

eddie — Thu, 06 May 2010 00:56:51 +0800

最近手邊某個案子在試著用Cucumber來做測試開發(BDD - Behavior Driven Development)，這真是個神奇的東西，寫測試腳本感覺像是在寫一般的英文句子一樣，以下兩篇是自己看著Ryan Bates在Railcast上的教學影片練習的心得筆記，供有需要的人參考

基本篇

表單填寫篇

這小黃瓜能測的東西範圍相當廣，官網上的toturial有很多有趣的應用，而且越看越有趣，之後還會繼續再把一些自己試作的心得再貼上來，若有錯誤的地方再歡迎告知 :)

rails console / irb 裡的方便工具-Hirb

eddie — Fri, 09 Apr 2010 02:37:11 +0800

方便的工具，寫起來給自己做個備忘，免得到時候忘記 :)

在做資料庫存取的時候，常會把抓到的model object印出來看看到底內容正確與否
假設我有個名叫Book的model，我從裡面隨便抓一筆資料出來大概會長這樣：

除此之外，也可以透過y方法把內容以YAML格式輸出

其實這樣也不會多難看，反正看久就習慣了
剛好最近在看Railscasts的時候才發現原來有更方便的gem可以用..它叫做Hirb
可以讓在console模式下輸出的內容更清楚了

官網的安裝說明其實就很清楚了，簡單的說，就是用gem一個動作就搞定了

> sudo gem install hirb

進入rails project裡的console模式後…
>> require 'hire'
>> Hirb.enable

接下來，剛剛那個object會變成：

如果再加一下logger的設定，還可以讓輸出的同時把查詢的log也秀出來

當你不想用的時候，只要用：
>> Hirb.disable

就可以把它關掉了

如果覺得hirb很方便但又不想每次進console都打這些指令的話，也可以把上面這些動作放到.irbrc裡(檔名: ~/.irbrc)
require 'rubygems'
require 'hirb'
require 'active_record'
Hirb.enable
ActiveRecord::Base.logger = Logger.new(STDOUT)

當然，hirb不只有這樣而已，不過光是這樣我就覺得很棒了。更細節的說明請洽網站 :)

如何在Rails裡使用AMF

eddie — Thu, 18 Mar 2010 16:33:53 +0800

=====
前言
=====

常聽很多朋友會問：「flash要怎麼樣跟資料庫串接?」
答案其實很簡單：「不行!目前flash沒辦法直接與資料庫串接」

那到底別人是怎麼做的，為什麼他們的flash可以由後台管理然後更新資料?

flash(*.swf) <--> Server端程式(asp, .net, php…etc) <--> DB

*.swf透過HTTP GET/POST的方式送給中間的程式
透過中間的程式，flash才得以從資料庫中取出/寫入資料

其中*.swf與server端程式溝通的格式，有簡單的純文字組合
或是用JSON或XML來包裝資料，再餵給*.swf，最後再呈現在flash上
特別是XML對AS3還滿友善的，可以簡單的就取出指定節點的資料

而今天要提的 AMF(Action Message Format)
其實做的工作跟上面的JSON或XML差不多，只是它的格式是binary的

AMF的實作，各家程式語言或Framework都有類似的實作品
像是PHP就有AMFPHP/Zend_Amf，Python有PyAMF，.NET有FluorineFx，Ruby的話則有RubyAMF

不過不管是哪家實作的AMF，流程上都差不多：
1. *.swf連上指定的Gateway
2. 呼叫/執行Gateway上掛載的service，並把所需的參數以AMF格式傳給它(如果有的話)
3. 執行結果回傳

最近手邊有個案子正好是用Rails寫的，剛好有用上AMF，就趁這個機會寫一下心得，免得自己以後忘記
(其實在Rails裡面，用respond_to直接render產出xml或json也還滿方便的...)

=====
環境
=====
Mac OX 10.6
Rails 2.3.5
ruby 1.8.7
RubyAMF 1.6.5

=====
安裝
=====
就不多做Rails的介紹了，直接開個空白的Rails Project來做示範

> rails rubyamf_demo
> cd rubyamf_demo

接下來，安裝RubyAMF
網址：http://code.google.com/p/rubyamf/

個人比較建議直接用script/plugin來安裝，簡單方便
當然如果要自己下載打包檔再手動放進來也ok的

> script/plugin install http://rubyamf.googlecode.com/svn/tags/current/rubyamf

沒問題的話，這個動作就會幫你把rubyamf安裝在vender資料夾裡了

其實這個安裝的過程中，除了把相關檔案裝到vender裡之外，背後有幫忙做了一些事你可能需要知道的：

1. app/controllers/ 裡多了一個rubyamf_controller.rb

這是整個amf的對外窗口，gateway就是寫在這裡了

2. config/ 裡多了一個 rubyamf_config.rb

RubyAMF的設定檔，打開這個檔案應該可以看到許多註解說明，可依情況及個人使用習慣做調整

3. config/initializers/mime_types.rb多加了一行

Mime::Type.register "application/x-amf", :amf

到時候可以像 render :text => "hello"一樣，直接用render :amf => "hello"來輸出

4. config/route.rb多了一行路徑設定

map.rubyamf_gateway 'rubyamf_gateway', :controller => 'rubyamf', :action => 'gateway'

gateway到時候的位置就是http://127.0.0.1:3000/rubyamf/gateway

5. public/ 資料夾多了一個 crossdomain.xml

常用AS在串接外部資料的人應該知道這是幹嘛的了，預設是全開

<allow-access-from domain="*" />

如果有需要調整可直接動手修改

接下來試著啟動server，看看能不能正常運作

> script/server

沒問題的話，接著開瀏覽器看看

http://127.0.0.1:3000/rubyamf/gateway/

如果你看到一個黑色的畫面，中間放著一個RubyAMF的logo

恭喜你，目前這樣就算是把RubyAMF安裝起來了

接下來，就要開始準備寫service上去了

=====
實作
=====

Rails部份：
先建立一個model，待會我們會用來取出/寫入資料用的
> script/generate model book author:string content:text

目前只放了author跟content兩個簡單的欄位
(for demo purpose, model部份沒有特別做validation)

> rake db:migrate

為了省去另建資料庫的麻煩，這裡直接使用預設的SQLite做為資料庫
table建立後，先塞一筆測試資料進去

> script/console
>> Book.create(:author => "eddie", :content => "this is a RubyAMF demo")

再來新增一個controller，裡面放一個hello_world這個action
> script/generate controller amf_test hello_world

在hello_world這個action裡，我們加一行：

def hello_world
render :amf => "Hello AMF"
end

大部份網路上看到的範例都是用Flex當範例，不過我個人比較偏好Flash
以下我就用Flash當做範例示範(其實沒太大差別啦，純粹個人喜好)

Flash部份：

範例檔案下載：amf_hello.fla

var nc:NetConnection = new NetConnection();
nc.objectEncoding = ObjectEncoding.AMF3;
nc.connect('http://127.0.0.1:3000/rubyamf/gateway');

var responder:Responder = new Responder(onOK, onErr);
nc.call('AmfTestController.hello_world', responder);

function onOK(res:Object):void
{
trace(res);
}

function onErr(res:Object):void
{
trace("Error!");
}

其中比較需要注意的是nc.call那一段
直接呼叫ControllerName.ActionName就行了

按下Ctrl+Enter之後，應該就可以看到"Hello AMF"的字樣了
代表你的swf已經可以成功從AMF Gateway讀資料回來了
如果這裡有發生錯誤，可能檢查一下是不是有打錯字，或是server忘了啟動

接下來，我們試著送資料給gateway，讓它寫入資料庫之後再回傳目前資料庫裡的書總共有幾本

這次我們先做flash端的介面，我放了一個按鈕跟二個輸入框
instance name分別取名為add_btw、author_txt及content_txt

(檔名：amf_addbook.fla)

AS3語法如下：

add_btn.addEventListener(MouseEvent.CLICK, click_handler);

function click_handler(evt:MouseEvent):void
{
var nc:NetConnection = new NetConnection();
nc.objectEncoding = ObjectEncoding.AMF3;
nc.connect('http://127.0.0.1:3000/rubyamf/gateway');

var amf_object:Object = {
    'author': author_txt.text,
    'content': content_txt.text
};

var responder:Responder = new Responder(onOK, onErr);
nc.call('AmfTestController.add_book', responder, amf_object);
}

function onOK(res:Object):void
{
trace("目前共有" +res +"本書");
}

function onErr(res:Object):void
{
trace("fail");
}

其實只是把呼叫的部份放到click handler裡，並且在裡面做了一個object，並且在呼叫的時候

nc.call('AmfTestController.add_book', responder, amf_object);

把它當做參數傳出去

接下來，在Rails裡，我們要來加一個add_book這個action，準備接收資料

def add_book
if is_amf
    Book.create(:author => params[0][:author], :content => params[0][:content])
    render :amf => Book.count
else
    render :text => "error"
end
end

這裡可以用is_amf來檢查傳進來的是不是AMF
傳進來的參數可用 params[0] 取得

接著執行flash，沒問題的話，當每次按下Add Book按鈕時，它就會把author跟content資料寫入DB
並回傳目前總筆數

以上為展示目的，都沒有加資料的驗證，所以就算空白資料也可以送出

以上是一些個人小小的心得，供大家參考囉

相關網站：
http://blog.rubyamf.org/
http://code.google.com/p/rubyamf/

原始檔下載(fla + rails project)：
http://nayumi.myweb.hinet.net/downloads/sample.zip

2009 PTT Flash 版聚

eddie — Tue, 27 Oct 2009 07:11:12 +0800

今年八月底聚集了一些對Flash有熱好的朋友們，讓大家互相認識一下平常在版上互動的人長什麼樣子，也順便透過幾個專題演講來分享一下心得

連結在此：http://www.eddie.com.tw/FlashLabs/PTT-Flash.htm

這應該算是PTT Flash版第二度的板聚(上一次是在2008年的八月，已經相隔一年了)

Flash在台灣一直比較少見有專門大型的研討會，比較大型的大多是伴隨產品上市的發表會一起辦

雖然我們這個不是官方舉辦或贊助的活動，但我還是很羨幕能有像Adobe MAX或是Flash on the Beach那樣大型的研討會

希望有一天能在台灣也能看到純粹技術發表的研討會 :)

至於我們這個PTT Flash Workshop，我想希望可以把這樣的聚會變成固定舉辦的活動，也許可以辦在寒、暑假

然後再來去借個比較大一點的場地來辦party好了 :)

戰利品

eddie — Thu, 04 Jun 2009 00:07:02 +0800

難得給自已排了一段時間出去玩，這趟去英國溜躂，音樂劇Les Miserables是心靈上最值回票價的體驗，當然物質上的一些戰利品也是不可少的啊(其實根本就是去買玩具的吧)

1. 電話亭存錢筒：

是鐵製的，拿在手上挺有份量(存錢這是一定要的啊)

2. 小羊鑰匙圈

這個是在湖區買的小羊鑰匙圈，造型真是超可愛

3. 懷舊寶箱

這是在二手店看到的小寶箱，不知道為什麼我看了就覺得很愛

4. 超難拼圖

號稱世上最難的拼圖，雖然只有529片，但拼起來像是4,000片?!

5. Doctor Who模型

大概二、三十公分高，人物部份要自已著色，Tardis在啟動的時候會發出跟影集一樣的聲音。

6. Daleks

有看Doctor Who的人一定知道這像垃圾筒的機器人是誰啊....

而且壓它還有音效的咧，真讚

7. 其它

每個景點專屬的名信片當然也是不可少的(本來要寄的，但最後都捨不得只寄了一張最不喜歡的出去了..)

另外還有個搖控的小直昇機(給我爸玩的)

結論：

要努力工作，趕快把錢賺回來了....!!!

上台講話

eddie — Wed, 06 May 2009 17:00:42 +0800

Oops! 發現最後一篇blog竟然已經是去年的事了!! 是時間過太快還是我太懶了?

最近因為幾個案子在趕著要上線，不久前的OSDC.tw沒辦法全程參加，只好挑自已喜歡的Session參加(ericsk的GAEO比我想像中的還好用)

以前某個我不喜歡的老闆曾跟我說過，做presentation就像表演一樣

近來我自告奮勇的找了一些對flash有興趣的朋友們每週來聚會，每次約2小時，我教大家怎麼來學 ActionScript3.0。沒另外收費(只需各自分擔場地費，我還太嫩，還不到那種敢收學費的等級)

常聽到「這個東西我懂，我只是不會講而已」，但我一直相信，真的懂的人一定是講得出來的；不會講不代表真的不會，只是還沒能完全透徹，某個環節沒學好，講不出來

在台上講話實在是件不容易的事，一來得先克服緊張感，二來得讓自已的腦袋保持清醒。

當然我也沒這麼佛心，開這樣的課當然是有目的：
1. 透過在台上講課，讓自已對AS3更熟悉
2. 訓練自已講話的技巧，練習怎麼掌握台下的反應(可能講太快或一下子講太難)
3. 透過每週準備課程，讓自已不會跟AS3離太遠

越是複雜的技術，要做這種大眾化的教學困難度也越高，像是知名的flash totur Lee Brimelow 用影音的方式來教學，清楚又易懂

最近在路邊牆上貼的一段話：「有困難是能力不夠，有麻煩是方法不對」看來，這條路還相當漫長 :)

Doctrine, the PHP ORM Framework

eddie — Tue, 23 Dec 2008 11:00:49 +0800

Doctrine是一個在PHP上的資料庫ORM(Object Relational Mapper)，最近手邊的幾個小案子透過Doctrine來實作。ORM的確是讓開發者少寫不少的SQL查詢，但相對的效能一定是比簡單的SQL要來得差，我想魚跟熊掌要兼得並不容易，便利跟效能之間總有個天平讓開發者來自已調整，所以ORM好不好用就見人見志囉。

一、前置作業：

1. 系統需求
依官網上面提到的，Doctrine需要PHP 5.2.3以上的版本，除此之外就不用再另外安裝其它的套件或函式庫即可運作，不過如果要使用PDO(PHP Data Object)的話，則可能會需要另外安裝PDO驅動程式。

2. 檢查PDO驅動程式
如果你要用PDO的話，想要知道你的主機上是不是有安裝你所需要的PDO驅動程式，只要一行簡單的PHP程式放到主機上執行：

<?php phpinfo(); ?>

如果你有看到一段PDO的資訊，那差不多應該就是有安裝了，再確認一下是不是有你要的版本，以及是否啟用即可。

二、取得原始檔

有幾種取得Doctrine的方法：

* SVN(Subversion)
* Pear
* Zip-package

如果你熟悉SVN的操作的話，這應該是最簡單使用的了。如果你只是想試玩一下Doctrine的功能的話，你可以下載官網上打包好的Sandbox套件來玩。我個人比較喜歡官方打包好的壓縮檔 :)

什麼是Sandbox套件?
Doctrine網站的下載區有貼心的打包了免設定的方便套件，直接下載、解壓縮後，就可以拿來試玩了。這裡面包括了一些範例schema檔案以及可以匯入的資料檔，讓你可以很快的就可以開始體驗Doctrine的優點。

三、開始第一個專案
在Doctrine裡，Doctrine_Record是最基本的元件。資料庫裡的每個資料表都會有一個對應的Doctrine_Record類別。這個類別是以Active Record這個設計模式實作的，所以在其它語言像是在ROR(Ruby on Rails)上才看得到方便功能，在Doctrine裡也可以使用到了，即使是複雜的資料庫操作，透過這個類別也可以簡單的完成。

在使用Doctrine_Record來建立資料表時，如果沒有特別指定Primary Key的話，Doctrine會自動幫你加一個叫做"id"的主索引欄位(自動編號)。接下來你需要做的事情，就是建立一個繼承自 Doctrine_Record類別的子類別，然後透過setTableDefinition()以及hasColumn()就可以來建立你的資料表。

為了單純一些，我們這裡只先用一個表格做範例(多個表格之間的關聯性操作，例如一對一、一對多、多對多等關係，再另外開幾篇再寫)。假設我們現在要建立一個叫做"member"的會員資料表，這個資料表裡會有id、username、password以及建立日期這幾個欄位，我們可以這樣做：

檔案：models/Member.php

<?php
     class Member extends Doctrine_Record
     {
         public function setTableDefinition()
         {
             // 預設將會使用跟"user"做為資料表的名稱(同名)
             // 並且會自動加一個欄位id的主索引鍵
             $this->hasColumn('username', 'string', 30);
             $this->hasColumn('password', 'string', 30);
         }

         public function setUp()
         {
             $this->actAs('Timestampable');
         }
     }

除了手工打造模型類別外，你也可以使用YAML格式的檔案來建立資料表的schema檔案，底下這個範例的設定跟上面這個類別是一樣的意思，而且也可以透過Doctrine的一些指令來互相轉換。

檔案：schemas/schema.yml

Member:
columns:
username: string(30)
password: string(30)
actAs: [Timestampable]

這裡要注意的是，YAML的縮排是有意義的，所以要特別注意縮排的層級。你可以用一行簡單的語法就可以把YAMLY檔案(.yml)轉換成模型類別(.php)：

檔案：createMode.php

<?php
require_once 'config/doctrine_config.php';
Doctrine::generateModelsFromYaml('schemas/schema.yml', 'models');

執行之後看一下models資料夾以models裡有一個自動產生的generated資料夾(如下圖)，你會看到有一個"Member.php"以及"BaseMember.php"。其中，"Member.php"是可以讓你自己定義一些功能用的，而"BaseMember.php"裡的內容則是依據YAML的內容幫你寫好的。(要特別注意BaseMember類別會在每次執行轉換的時候重新產生一次，而Member類別只會產生一次)。

我們現在有一個透過YAML建立的Doctrine_Record類別，接下來就可以把它匯入資料庫來建立資料表了。

檔案：modelToDatabase.php

<?php
     require_once 'config/doctrine_config.php';
     // 建立資料表
     Doctrine::createTablesFromArray(array('Member'));

這樣就搞定了!看一下資料表的樣子：

如前面說的，它會自動加上"id"這個欄位，而"Timestampable"則會自動幫忙加上"created_at"及"updated_at"這兩個欄位。

現在我們有一個資料表以及一個對應的模型類別可以讓我們來練習資料的基本操作了(新增、修改、刪除及查詢)。

新增：

檔案：testInsert.php

<?php
    require_once 'config/doctrine_config.php';

    $myTable = new Member;
    $myTable->username = 'eddie';
    $myTable->password = 'mypassword';
    $myTable->save();

資料表欄位的指定，除了上面這種物件式的存取方式外，也可以使用陣列的方式：

$myTable = new Member;
$myTable['username'] = 'eddie';
$myTable['password'] = 'mypassword';
$myTable->save();

不用寫什麼insert...into，只要一個save()就完成了! 回頭看一下資料表就會發現，有一些神奇的事情它幫忙做了。上面這段程式碼執行後，member資料表會長得像這樣：

修改：

假設剛剛寫入的那筆資料的id編號是1號，更新方法是先找到它，然後一樣用save()來更如下：

檔案：testUpdate.php

<?php
    require_once 'config/doctrine_config.php';

    $myTable = new Member;
    $record = $myTable->getTable()->find(1);
    $record->password = 'mynewpassword';
    $record->save();

結果如下：

你會發現，password欄位變成"mynewpassword"之外，它的更新時間(updated_at)也跟著更新了。

刪除：

跟更新差不多，也是先找到那筆資料後，再給它一個delete()：

檔案：testDelete.php

<?php
    require_once 'config/doctrine_config.php';

    $myTable = new Member;
    $myTable->getTable()->find(1)->delete();

查詢：

假設我要找出id編號是1號的資料，可以這樣做：

<?php
$myTable = new Member;
$result =$myTable->getTable()->find(1);

除了透過find方法外，Doctrine還有它自已一套叫做DQL的語法，使用方法大致如下：

檔案：testDQL.php

<?php
    require_once 'config/doctrine_config.php';

    $myTable = new Member;
    $record = $myTable->getTable()->find(1);
    $record->password = 'mynewpassword';
    $record->save();
    $result = Doctrine_Query::CREATE()
                ->select('*')
                ->from('Member')
                ->where('id = ?', 1)
                ->fetchArray();

    print_r($result);

印出來的結果如下：

上面的DQL相當於底下的SQL：

select * from member where id = 1;

其實DQL的細節也可以另外來寫一篇 :)

結語：

老實說，如果只是簡單的查詢，Doctrine寫起來不見得比原本的SQL快，而且效能又比較差一些，但如果是比較複雜的查詢，透過Doctrine包裝好的一些方法，可以不用去想那些單引號、雙引號的問題外，也可以安全的避開可能的危機(例如SQL Injection) ，就如同最前面說的，便利跟效能，我會比較偏向便利的這一方。

更多的細節，可參考Doctrine官網手冊，寫得滿詳細的。

上面的程式碼我也有打包了一份供大家參考囉 :)

檔案下載

使用前請先看一下config/doctrine_config.php裡面的資料庫相關設定。

相關連結：

．Doctrine官方網站
．Doctrine User Group