Lesson 10: Team Work 概念導引 (2004/09/10)

Lesson 10: Team Work 概念導引 (2004/09/10)

講員介紹 • 本名：孫仲岳 (Saturn Sun.) • 生日：1980年11月4日天蠍座 • 現任： • 彰化市社區大學講師 • 中原大學校園網路策進會創會會長 • 中原檔案伺服器網管 http://ftp.cycu.edu.tw • 中原熊蓋站站長 http://best.cycu.edu.tw • 中文化軟體聯盟網管 http://cpatch.org • AX工作室負責人 http://www.ax.com.tw

如何取得上課投影片 • http://best.cycu.edu.tw • 進入「校園網路策進會」版

今天主題 • 命名原則 • 寫作規範與註解 • 程式碼版本維護 • 協同開發實作

命名原則 • 基本上的命名限制 • 變數名稱 • 必須以大小寫字母，或是「_ 」底線開頭 • 可以包含數字 • 大小寫有區別 • 函式命名 • 亦同，但不可以與現存函式衝突

命名原則 • 建議的命名方式 –非語法 • 常數 : 全部大寫的英文字母 • ex: define("CONSTANT", "Hello world."); • 函式 : 小寫單字，接著單字首字大寫 • ex: function getNumber() • 變數 : 全部小寫，利用底線區隔 • ex: $student_name;

命名原則 • 資料庫命名原則 • 欄位、資料表、資料庫 • 用英文字母與數字命名 • 欄位加上資料表的前引名稱 • 避免使用保留字 (如 insert、into) • 實際操作

命名原則 • 檔案命名原則 • 系統名稱 + 程式編號 + 主功能 + 動作 • ex. ICIM002_gbook_delete.php • 研討會系統ICIM • 編號 002 • 程式留言版系統 • 功能刪除

命名原則 • 目錄(資料夾)命名 • 以系統名稱 + 編號 • ex: ICIM002 • 再統一集中置放於module之類的目錄 • 其他管理用的資料夾 • 如 sql、system、template

命名原則 • 複製貼上、改來改去的夢魘 • 協同開發的第一要件

寫作規範與註解 • 可以的話，每個步驟都註解 • 程式撰寫希望要求 • 關鍵步驟，撰寫註解 • 必要時放上演算法 • 程式碼不需捲動左右軸 • 太長的字串用 .= 組合起來手動換行

寫作規範與註解 • 函式撰寫希望要求 • 註解載明 • 傳入值、傳出值 • 使用方式(最好簡易說明) • 撰寫人 • 撰寫日期、版本

寫作規範與註解 • /************************************************* • 功能說明:解析網頁樣板，並替換後輸出 • 建立人員:孫仲岳 • 建立日期:2004-02-10 • 修改日期:2004-09-07 • 代值說明:檔案名稱或位置、解析用變數陣列 • 輸入格式:字串、陣列 • 輸出格式:網頁字串 • 其他補充:$filename 檔案位置 • $parser_array 型式為 $array['key'] = value; • **************************************************/ • function read_and_parser($filename,$parser_array)

寫作規範與註解 • 做這些的好處 • 維護、更版容易 • 做這些的壞處 • 隨時有被 fire 的機會(爆…) • 我的一些實際體驗 • 老闆看得懂的程式碼才及格^^

程式碼版本維護 • 程式設計師的痛 • 有個好軟體 • Araxis Merge (6.5) • 快速比對整理程式碼的不同處 • 讓你挑選採用哪一段

Araxis Merge • 先行下載(檔案很肥) • 安裝時候請輸入序號 • 可以全功能試用三十天 • 取得試用序號方法 • 上官方網站，填寫email，信上會給 • http://www.araxis.com

Araxis Merge • 以PHPBB作為測試 • 2.05 與 2.06 的差異 • 學習如何查看與修訂程式碼

協同開發實作 • 兩人ㄧ組 • 開發一個函式給自己的程式呼叫 • 例如: • 算體積程式(傳入長寬高、輸出體積) • NN乘法表(傳數N，輸出1x1 ~ NxN資料) • 計算檔案大小(輸入數字，輸出多少kb、Mb)

協同開發實作 • 將函式寫好註解(約定使用方式) • 將函式交付對方使用 • 用網芳、msn、or 熊蓋站交換您的檔案 • include 進來，使用 • 如果出現問題，再互相調整到OK

作業 • 繳交這次協同開發的成品 • 自己的php程式、對方的函式 php • 並且用50字做心得說明 • 例如: 為什麼可以一次成功? • 例如: 使用對方函式發生問題的原因? • 例如: 解決之道?

補充技術教學 • 檔案上傳 • 請看範例 ^_________^

小結 • 今天的課程算是php的謝幕 • 如果想成為真正的程式設計師 • 還有很長一段路要走^^ • 要讓自己能不那麼快被淘汰 • 培養自己看doc的能力(英文k啦) • 訓練自己能找出問題，再找出答案

參考網站 • PHP Bible • http://dslab.csie.ncu.edu.tw/~happyman/book/cphp3/index.php.htm • PHP 官方網站 • http://www.php.net • Google • http://www.google.com.tw

謝謝各位 • 有任何疑問，聯絡請洽： • http://best.cycu.edu.tw 中原熊蓋站 - 公用討論區 • 寫信給我： • saturn@cna.cycu.edu.tw • saturn@ax.com.tw • 電話聯絡： • 0928-389698

Lesson 10: Team Work 概念導引 (2004/09/10)