今天在 Twitter 上看到小海說在一堆 PHP 中加入 phpDoc 非常的痛苦…

後來 johnpupu 就提供了 PDV 這個好用的 Vim 的 plugin …

安裝方式很簡單….

先到 http://www.vim.org/scripts/script.php?script_id=1355 下載最新的 php-doc.vim

下載後放在像是 ~/.vim/php-doc.vim

然後修改 .vimrc 增加下面的設定

source ~/.vim/php-doc.vim 
inoremap <C-P> <ESC>:call PhpDocSingle()<CR>i 
nnoremap <C-P> :call PhpDocSingle()<CR> 
vnoremap <C-P> :call PhpDocRange()<CR> 

之後只要在用 Vim 編輯 php 的時候，於編輯模式按下 ctrl+p 就可以自動根據 function or class 產生 phpdoc 格式的註解囉!!!

20081208 補充, 

感謝 Johnpupu 的提供…我找了一下參考這篇裝起來了..

http://c9s.blogspot.com/2007/06/vim-snippet.html

在 vim 下的程式碼自動完成!

內容很多，幾乎把 CakePHP 1.2 上很多重要的新東西都講到的，看完了很心動很想馬上來試試看阿！
http://www.cakephp.org/files/OCPHP.pdf

很久沒有寫關於 adodb 相關的文章了，前一陣子（好久以前）翻閱文件的時候，注意到新增了一個 AutoExecute 的 Method ，看名字就覺得很有趣，所以當然就玩了一下。

一玩不得了，這東西太好用了，所以一直想說要介紹給朋友用，但是一直忘記要寫文章，雖然過了很久，但是還是來補一下好了。

還沒有用 GetInsertSQL 跟 GetUpdateSQL 以前，通常都需要自己撰寫相關的 SQL 去操作資料庫，不免會遇到打錯 SQL 或是程式碼中一堆 SQL 語法的問題。

之後我用 adodb 的時候，通常都會跟官方文件上得範例差不多，都是用 GetInsertSQL 或是 GetUpdateSQL 癌產生 SQL ，然後才用 Execute 去執行該 SQL ，而GetUpdateSQL 之前還要 Select 一下資料庫，取出一份該筆資料得欄位跟資料內容，所以整段程式變成有點累贅，因為一些不必要的重複的 Code 不斷出現。

類似這樣：

$rs = $db->Execute("Select * from mytable where id = '{$id}'");
$updateArray['name'] = 'newName';
$UpdateSQL = $db->GetUpdateSQL($rs,$updateArray);
$db->Execute($sql);

而比較新的版本的 adodb 則新增了 AutoExecute ，則可以大幅度減少這些無謂的程式碼.

AutoExecute($table, $arrFields, $mode, $where=false, $forceUpdate=true,$magicq=false)

參數說明:

• $table 要處理的表格名稱
• $arrFields 要更新或新增的欄位內容
• $mode 模式選擇，內容需為 INSERT 或是 UPDATE 
• $where 當模式為 UPDATE 的時候，需要輸入更新條件
• $forceUpdate 一般來說預設 UPDATE 的時後，會先從資料庫取出該筆資料，然後若是欄位內容沒有修改，則不會進行UPDATE，只會更新有更新的欄位，若是姜此參數設定，則會強迫一律更新。
• $magicq 系統環境是否有把 magice_quotes 打開，預設是沒有，所以會替你將傳入的資料作 qstr

範例：

$record["firstName"] = "Carol";$record["lasTname"] = "Smith"; $conn->AutoExecute($table,$record,'INSERT');# executes "INSERT INTO $table (firstName,lasTname) values ('Carol',Smith')";

$record["firstName"] = "Carol";$record["lasTname"] = "Jones"; $conn->AutoExecute($table,$record,'UPDATE', "lastname like 'Sm%'");# executes "UPDATE $table SET firstName='Carol',lasTname='Jones' WHERE lastname like 'Sm%'";

從上面的範例可以發現，比起之前用 GetUpdateSQL 與 GetInsertSQL 更為簡潔，且更為方便了！

官方文件

http://phplens.com/adodb/reference.functions.getupdatesql.html#autoexecute 

 拖了這麼久，PHP5 都已經改到 5.2.3 了，終於官方網站宣佈 PHP4 即將終止更新與維護，我相信這是官方網站的正確選擇。

有要需要更新自己程式的朋友們，別忘了要看看  Migration Guide 喔…