<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by guitarbien on Medium]]></title>
        <description><![CDATA[Stories by guitarbien on Medium]]></description>
        <link>https://medium.com/@guitarbien?source=rss-d6d8f40fa67------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*TP1qqsnbahiqTwpRYSRrtg.jpeg</url>
            <title>Stories by guitarbien on Medium</title>
            <link>https://medium.com/@guitarbien?source=rss-d6d8f40fa67------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 07:19:46 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@guitarbien/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[培養又快又好的 RD 團隊]]></title>
            <link>https://medium.com/@guitarbien/%E5%9F%B9%E9%A4%8A%E5%8F%88%E5%BF%AB%E5%8F%88%E5%A5%BD%E7%9A%84-rd-%E5%9C%98%E9%9A%8A-b436042ff29?source=rss-d6d8f40fa67------2</link>
            <guid isPermaLink="false">https://medium.com/p/b436042ff29</guid>
            <category><![CDATA[testing]]></category>
            <category><![CDATA[agile]]></category>
            <category><![CDATA[continuous-integration]]></category>
            <category><![CDATA[tdd]]></category>
            <category><![CDATA[unit-testing]]></category>
            <dc:creator><![CDATA[guitarbien]]></dc:creator>
            <pubDate>Sun, 11 Dec 2022 09:42:24 GMT</pubDate>
            <atom:updated>2022-12-11T09:42:24.241Z</atom:updated>
            <content:encoded><![CDATA[<h4>透過紮馬步寫測試來實踐敏捷</h4><h3>小故事</h3><p>在西門町有一間歷史悠久的麵店，我家一共四代人都吃過。他不是在賣有厲害主菜做噱頭的麵，只是酸菜、麵條、湯這三種基本元素。是我們全家的愛店。有一次一樣去這間店享用，滿桌小菜吃一半後老闆也端上了大家期待的湯麵，不過這次一吃大家就覺得不太對勁，湯頭跟往常比淡了許多。和老闆反應後當然立即幫我們處理，當天我們自然還是吃飽結束，不過出發前的期待其實沒有獲得滿足，那天我們只是吃飽。</p><p>原來平常煮麵的是老闆娘，那陣子老闆娘出車禍需要養傷一段時間，就由老闆臨陣磨槍上陣。不過平常老闆都是在旁邊負責煎荷包蛋，要做一個不熟悉的業務一定是需要大量時間準備。我就在想老闆要怎麼確定他今天端上桌的麵有符合他們店的水準？因為今天是平價麵店出點小紕漏客人也不那麼在意，不過如果今天去的是高級餐廳呢？如果穿得西裝筆挺又花了大把鈔票，不管是外場內場一定都希望有一流的服務。就像地獄廚房在出菜前都需要經過主廚的把關，如果品質不如預期直接被丟到垃圾桶，廚師還會被狗幹一頓。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/290/1*VhWqcOh74ZX1gTwaRSWRWQ.jpeg" /></figure><p>廚師不試菜不知道餐點的味道，那工程師不測試怎麼知道程式的品質呢？</p><p>我的第一份正職工作就是寫程式，我想大多數菜鳥工程師都跟我當時一樣，上工寫的第一個程式一定就是在亂寫。當我完成第一個需求去跟主管回報時，主管很帥頭也不轉也不看我只問一句：你有自己測過了嗎？我才知道原來有這件事要做，以前在學校就是交卷後等著老師或助教跟你說你做的很爛而已。</p><p>隨著我開發的需求越來越多，主管一樣一直問測過了嗎？測過了嗎？聰明如我，經過了社會歷練，我當然是一律回答 “Sir, yes sir”，不管有沒有測反正都先說有測過就對了！這樣我就有更多的時間可以趕快來開發下一個需求。就像大家猜到的發展一樣，有一天主管突然很有興致，想說來測試一下我開發的功能 …… 好死不死 submit 按鈕一下去就 500 error，當時我連想辯駁都找不到藉口，很明顯就是連測沒測。當下雖然沒有受到太嚴厲的責備，不過我知道我在主管心中的 credit 已經大幅扣分了。</p><h3>好是最最基本的</h3><p>第一間公司的主管是 {{RD}}，麵店的老闆也是 {{RD}}，把事情做好把品質顧好是 {{RD}} 應做的事。</p><p>老闆付薪水，並期待我把事情做好還算合理吧？不過老闆付薪水，並期待我把事情做得又快又好呢？通常老闆們在意的是產出、轉換、成果，RD 們在意的又是什麼？Money？領多少錢做多少事？除了勞務換取報酬之外，工作上有沒有其他想追求或實踐的呢？</p><p>在解決問題產生價值之餘，我想要有技術成長和實務經驗。總之，我想要便得更強。我想變得跟我心目中厲害的人一樣強。</p><p>我個人職涯後半，技術和觀念有明顯進步的一個很大的原因是：寫測試。接下來用經典的 5W 1H 來分享 RD 寫測試這件事。</p><h4>Who 寫測試？</h4><p>自然是 RD 們來自己寫測試。為什麼不是 QA 寫呢？QA 自然也要寫，但 RD 寫和 QA 寫是兩件不一樣的事情。看事情的角度就不同了，這點後續會再帶到。</p><h4>Where 執行測試？</h4><p>測試應該要且可以要在我的本機、你的本機、以及 CI server 上面執行。</p><h4>When 寫測試？</h4><p>有空了再來寫嗎？基本上不要騙自己了，有空再寫就是不會寫的意思！因為一定永遠都沒空。所以得要求每天每次都要寫，要培養這個寫測試的習慣。那執行的細節是該先開發再寫測試還是先寫測試再開發呢？我覺得以培養團隊習慣來說不用強制這點，只要有寫都是好事。但以個人開發而言，我認為很值得學習和嘗試看看 TDD (先寫測試再開發) 的方式。在開發一個需求時，打字不可能比大腦運作來的快，有時候開發還在敲鍵盤時思緒已經想到下一個 method 去了，造成寫現在的程式不專心，思考後續的邏輯也不夠專心。TDD 可以幫助我們收斂需求，一旦決定好 test case，只要一步一步專注在把紅燈變綠燈，然後再重構就可以了。每個 test case 都綠燈的話其實不知不覺整個功能就做完了。</p><p>我們組的習慣是 production code 和 tests 都寫完才一起發 pr。只要說測試還沒寫完，那就是還沒開發完。因為 RD 寫測試這件事情是開發，要把工作完整做完才行。</p><h4>測 what？</h4><p>這點事很多人會問的，當功能太複雜或太單純時會突然困惑到底該測什麼東西？心法就是：<strong>做什麼測什麼</strong>。程式做了什麼就要去測那件事有沒有如預期執行。我本身是後端工程師，就以後端 API 的流程來分享要測什麼。</p><p>通常不論程式語言或框架，一支 API 不外乎就是會經過這些流程：route、middleware、controller、validator、service、repository、response。這些步驟自己做單元測試，互相做整合測試。</p><p>單元測試：這個元件<strong>執行</strong>起來如預期嗎？</p><p>以 repository 為例可能會對 db 撈取或異動資料，那該 repository 的功能在這個情境下有撈到資料、沒撈到資料、拋出 exception、或是異動資料完不回傳結果 (void) 這幾種情況執行起來有如你預期嗎？</p><p>整合測試：元件之間<strong>合作執行</strong>起來如預期嗎？</p><p>service 可能會對 repository 取回的資料再做些運算。所以可以測試 service 有正確呼叫到 repository 嗎？有如預期取得資料嗎？如果沒資料的情況 service 會不會壞？若 repository throw exception 的話 service 要做什麼處理？例如 catch 起來寫 log 或是直接往外 throw exception？都行，那有沒有真的這麼做？</p><p>總之單元測試測自己，整合測試測彼此，end to end 測試則是模擬自己是使用者去測。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/560/1*IBpGR7l_cU-NlkIBSr81AQ.png" /></figure><p>理想上一個專案的測試單元測試應該要是最多的。因為單元測試執行起來最快，最快就代表花費的時間最少，也就是成本最低。而越高階越貼近使用者的測試因為要執行 browser，要等畫面 render 等 js 載入等等，執行起來一定比較慢，相對成本比較高。因為我們錢不夠時間不夠，所以不該把資源都砸在 UI 測試上，最貴的東西應該要最少才對。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/625/1*vpPFPWoBucQfcTVEFtl2CQ.png" /></figure><p>但事實上各公司通常是<strong>反</strong>金字塔，更在其上多了一沱最多的手動測試，也就是所謂的測試冰淇淋。UI 的測試已經不快了，公司內執行最多的竟然是更慢的手動測試！？這代表公司花了更多時間更多錢在這上面。雖然說手動測試一定有其價值，但理想上每做完一次至少要能讓他往自動化 ui 測試移動才好。畢竟能用機器 replay 才能盡可能隨時執行。</p><h4>How to test it？</h4><p>測試有個 3A 原則：</p><ul><li><strong>A</strong>rrange</li><li><strong>A</strong>ct</li><li><strong>A</strong>ssert</li></ul><p>建議寫測試的起手式就是寫上這三行註解，方便閱讀時可以快速找到該區塊。我自己習慣看一個測試時是從下往上閱讀，先看這個測試在意什麼？什麼對它來說是重要的？來看個簡單的範例：</p><pre>class TryTest extends TestCase<br>{<br>    public function testFullName(): void<br>    {<br>        // arrange<br>        $firstName = &#39;Michael&#39;;<br>        $lastName = &#39;Jordan&#39;;<br>        $person = new Person($firstName, $lastName);<br><br>        // act<br>        $fullName = $person-&gt;getFullName();<br><br>        // assert<br>        $this-&gt;assertEquals(&#39;Michael Jordan&#39;, $fullName);<br>    }<br>}</pre><p>由下往上，測試想要知道結果是否為 Michael Jordan 中間有個空白。再往上追 call 哪個 mehtod 可以拿到這個結果？再往上追要怎樣得到這個物件？</p><p>單元測試另外還有個 F.I.R.S.T. 原則：</p><ul><li><strong>F</strong>ast：執行要快，一旦測試執行不快 RD 就會想偷懶不執行，就會想偷懶不寫。</li><li><strong>I</strong>ndenpend：測試不該互相影響，否則很難 debug。例如 B 測試不該一定要在 A 測試之後執行才能過，A &amp; B 獨立執行也要能通過。</li><li><strong>R</strong>epeatable：可穩定重複執行，且應該要能在不同 OS 上執行通過。如果可以的話面對不同資料庫也都能執行通過的話，那代表程式的可攜性又更好了。</li><li><strong>S</strong>elf-Validating：測試要能自我驗證，只要一執行完一定跳出個結果：要馬紅燈要馬綠燈。如此才能辨識測試是否有效。</li><li><strong>T</strong>imely：及時，如同前面講的測試不該有空再寫，一旦不能及時寫測試你的專案就是 legacy code。</li></ul><h4>Why 寫測試</h4><p>這點是最講的。起初我只是想要交出高品質的程式碼。把層次拉低一點來看的話，我想要證明我真的有測過了。</p><p>開始寫測試後發現，我原本寫的程式碼漏洞百出，甚至需求本身也存在一堆盲點。而測試越寫越多之後我又發現我開發速度好像比別人快了一些，開發品質好像比別人好了一些，QA 測我的東西都說比較沒問題，甚至我還能給 PM 一些規劃上的建議。</p><p>寫了測試之後，我對於以下主題也有了更深一些認識：</p><ul><li>SOLID</li><li>TDD</li><li>CICD</li><li>Agile</li><li>Clean Architecture</li></ul><p>基本上一開始因為程式寫太爛，根本就沒辦法測。兩千行的 controller 要怎麼測？為了想讓程式可測，開始上網或是買書來看想知道什麼叫做<strong>好的程式</strong>？SOLID 原則作為一個歷久不衰的經典，怎麼把它實際應用到工作上一開始門檻是很高的。而如果沒有扎實寫測試在講什麼敏捷和 CICD，那只代表你心臟很大，可能把 bug 交付出去的速度很快而已。</p><p>假設今天 RD 團隊第一個 sprint 開發出 10 個功能，QA 要測 10 個功能<br>若這個團隊很穩定，第二個 sprint 又開發出 10 個功能，那 QA 要測幾個功能？答案是 20 個，因為 QA 還要回歸測試。</p><p>通常每間公司 RD 人數一定大於 QA，如果 RD 產出穩定那 QA 一定會變成瓶頸。但對於公司來說由 QA 做品質把關是必要的，QA 不該信任 RD 做出來的東西，所以省不掉 QA 這段。那既然不該省掉，怎麼加速？我的想法是提高 RD 產出的品質。</p><p>如果 RD 只負責開發，測試都丟給 QA，初期可能真的偷到一些時間，但老闆也不是吃素的，一旦知道你做很快，就會更快得塞下一個需求給你，如此 RD 就有更多的需求要給 QA 測。而 QA 接了更多需求，就只能把 test case 列出來然後做手動測試而沒時間寫成自動化測試，測試冰淇淋就是這麼來的。</p><h3>好了之後，快呢？</h3><p>前面聽起來就是盡量開發一次做到位，重點在<strong>好</strong>，那<strong>快</strong>呢？像剛剛講的有空就快去開發下個需求，哪來時間多寫測試？</p><p>我們先看快為什麼重要？這幾年面對全球疫情這個突然的大變化，不管是個人或公司都想活下去，如此只能擁抱變化。如果想再活得更滋潤一些，那必得更快速擁抱變化才行。</p><p>我們想想業務單位所做的嘗試一定會賺錢嗎？新創公司所做的嘗試一定會成功嗎？肯定不會，如果知道怎樣一定賺的話就趕快去做了。就是因為不知道，所以這才叫做<strong>嘗試</strong>，而<strong>不斷嘗試不斷改善，這就是敏捷的精神</strong>。</p><p>但老闆要的敏捷是 “所以明天可以上線嗎”？即便這樣老闆也沒說可以端出爛爛的東西上線。還記得前面麵店老闆的故事嗎？要先確保麵好湯濃肉大塊，再來才是越快端上桌客人越開心。<strong>兼顧品質的快才是真的快</strong>。</p><p>可是寫測試就是要多花很多時間，怎麼可能用更少的時間做更多事？有小精靈會幫忙嗎？其實要做的事情沒有變多，來看看 RD 人工是怎麼測？後端會操作 postman，看 response 看 db 資料是否如預期。前端會在 local 操作 UI看結果是否如預期。但如果到了 QA 測試時才發現很難修正的重要錯誤怎麼辦？QA 測試時才發現 RD 根本漏開發某個規格怎麼辦？RD 是可以藉由寫測試來收斂需求、確保品質的。</p><p>如果問題發生在 production 的話，這已經花了消費者、CS、RD、PM、QA 眾多人的時間。如果是有砸行銷預算的活動發生問題，更是不敢想像。</p><p>所以除了盡可能一次開發到位之外，究竟寫測試還加快了什麼？</p><p>快在 RD 忘了業務細節也沒關係，因為可以從測試去理解業務邏輯；快在 RD 不必只仰賴恆心和毅力維護產品；快在測試就是最可信任的文件，因為他隨時被執行；快在新人不用怕改壞程式，快在團隊也不怕新人改壞程式；快在每個產品都可以實踐這個作法；快在 context switch 的成本小，成本小了 RD 就不怕 PM 打擾問問題，甚至還可以協助 PM 規劃、demo、和使用者一起討論需求；快在 RD 一天不只能做一件事；快在團隊每個人都可以切換開發不同產品，隨時給予彼此火力支援；快在 RD 可以彈性應對規格變化 (不過可以就只是可以，不見得一定只能照辦)；快在有持續整合，隨時都在測試有需要上線就上線，即便是禮拜五也不怕 (你的團隊應該能隨時部署，所以即使是星期五團隊也能夠部署。YES；你的團隊能夠星期五部署，所以以後應該星期五部署。NO)；最後快在離職時不用花太大心力交接。</p><p>為什麼 RD 可以做到這些？因為奴性比較高還是脾氣比較好嗎？從寫測試我領略到<strong>小</strong>的重要。小的 class 才好解耦、好注入；小的 method 才好測試；</p><p>小的 issue 才好開發、好接手(對於整個 scope 不用到超了解也可以支援)；小的 PR才好 review；連系統也要小，小才單純，才可以橫向擴展，才可用 auto scaling 解決問題。</p><p>小才有可能簡潔。有了測試保護我們才敢安心重構，程式若能隨時禁行重構才可能變簡潔。而程式簡潔了就不複雜，才不會很多 bug，RD 才會有多的時間。RD 一旦有了時間才能去寫更多的測試或是做前述的那些事情。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/695/1*30MflKGmQ62KkZkg_7I9Ig.jpeg" /></figure><p>隕石開發，一定是十惡不赦的嗎？老闆如果不找來各種隕石需求公司怎麼會有收入？沒有收入怎麼發薪水給大家？先不強迫大家接受這個想法，退一步來看，如果 RD 是有能力處理隕石的話那代表你有很強的實力，自然可以去追求更理想的公司。</p><h3>It’s all about money</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/225/1*tUTbz2NLCk-GkYB5sGEaeA.jpeg" /></figure><p>如果沒有測試，公司就會花費大量 RD、CS、QA 的時間，RD 也可能會因此心情不好挫折感大而離去，並且很難找到人來碰這個可怕的產品。一個在 production 發生錯誤的成本，要遠比被自動化測試抓到錯誤來得高太多太多。只要測到就是賺到。寫測試可以說是一個投資報酬率壓倒性高的事情。</p><p>寫在 repo 內的東西不會只有自己在維護，測試會幫助到你的夥伴，未來的你，未來的夥伴。測試就是規格，測試就是 use case。</p><p>天下武功無堅不破，唯快不破。希望這個又快又好的心態和文化可以幫助 RD 團隊交付價值。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=b436042ff29" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Vim 指令筆記]]></title>
            <link>https://medium.com/@guitarbien/vim-%E6%8C%87%E4%BB%A4%E7%AD%86%E8%A8%98-28edd0435074?source=rss-d6d8f40fa67------2</link>
            <guid isPermaLink="false">https://medium.com/p/28edd0435074</guid>
            <category><![CDATA[vim]]></category>
            <dc:creator><![CDATA[guitarbien]]></dc:creator>
            <pubDate>Thu, 26 May 2022 13:09:03 GMT</pubDate>
            <atom:updated>2024-02-11T11:50:19.671Z</atom:updated>
            <content:encoded><![CDATA[<p>看了一系列教學影片：<a href="https://www.youtube.com/playlist?list=PLBd8JGCAcUAH56L2CYF7SmWJYKwHQYUDI">即將失傳的古老記憶 Vim</a> 後，把一些不太熟悉的重點記錄下來。這系列是較少能看到的優質中文教學影片，內容十分豐富，很推薦跟我一樣停留在 text object 許久沒進展的同伴一起跟著練習。</p><h4>移動畫面或移動游標系列：</h4><ul><li>hjkl 上下左右</li><li>{ 往前移動一個段落</li><li>}往後移動一個段落</li><li>gg移動到文件第一行</li><li>G移動到文件最後一行</li><li>10G移動到第10行</li><li>0移動到該行第一個字元</li><li>^移動到該行可視文字的第一個字元 (忽視縮排)</li><li>$移動到該行最後一個字元</li><li>w/W移動到下一個單字(包含/不包含符號)</li><li>b/B移動到前一個單字(包含/不包含符號)</li><li>gk同一行文字因太長被vim在畫面上以多行顯示時，移動到(畫面上的)上一行</li><li>gj同一行文字因太長被vim在畫面上以多行顯示時，移動到(畫面上的)上一行</li><li>fx從游標處往後移動到第一個出現的x</li><li>Fx從游標處往前移動到第一個出現的x</li><li>ctrl+f下一頁</li><li>ctrl+b上一頁</li><li>zz讓當前游標所在行數置中</li><li>zt讓當前游標所在行數置頂</li><li>zb讓當前游標所在行數置底</li><li>/xxx搜尋文件內符合的文字 xxx</li><li>n移動到符合搜尋條件的下一筆</li><li>N移動到符合搜尋條件的上一筆</li><li>* 搜尋游標當下所在的整個字</li></ul><h4>Text Object</h4><p>名詞：word, sentence, paragraph, tag, ‘, “, (, [, {<br>動詞：yank, paste, delete, change<br>範圍：<strong>i</strong>nner, <strong>a</strong>round<br>量詞：數字</p><h4>文字選取系列</h4><ul><li>vvisual 選取模式</li><li>V整行選取模式</li><li>ctrl+vvisual block 模式 垂直選取</li><li>垂直選取模式下：I多行編輯 (會先編輯第一行，esc 後才套用到其他行)</li><li>vw直接選取整個單字 (但會包含符號或空白)</li><li>viw選取整個單字 (v inner word)</li><li>vi”選取“”內的所有字</li><li>vaw選取整個單字(包含空白) (v around word)</li><li>va”選取包含“”的所有字</li><li>vit(v inner tag)</li><li>vat(v around tag)</li><li>v}選取往下整個段落</li></ul><h4>編輯系列</h4><ul><li>i進入輸入模式</li><li>I跳到行首進入輸入模式 (若有縮排不包含空白)</li><li>a從游標後進入輸入模式</li><li>A跳到行末進入輸入模式 (若有縮排不包含空白)</li><li>o從下一行首進入輸入模式</li><li>O從上一行首進入輸入模式</li><li>c清除並進入輸入模式</li><li>C清除到行末並進入輸入模式</li><li>x 刪除當前游標的字 (也可配合選取模式)</li><li>d刪除 (要先選取文字)</li><li>D從游標處刪到底</li><li>dd刪除整行</li><li>dG刪到文件最後</li><li>dgg往前刪到文件一開始</li><li>&gt;&gt;縮排</li><li>&gt;選取文字後要縮排只要按一下</li><li>3&gt;&gt;游標所在三行縮排</li><li>=(選取文字後)根據上下文自動縮排</li><li>uundo</li><li>ctrl+Rredo</li><li>~大小寫互換</li><li>.重複做上一個(連續)動作</li><li>J把下一行接到當前行後面，也可複製多行按一次</li></ul><h4>複製貼上</h4><ul><li>y複製</li><li>yy複製一整行</li><li>3yy複製游標所在的以下三行</li><li>y$複製游標所在至該行結尾</li><li>yG複製游標處到最後一行</li><li>p在游標處貼上文字</li><li>P在游標前貼上文字</li><li>“ay把內容存到 a 暫存器</li><li>“by把內容存到 b 暫存器</li><li>“ap貼上 a 暫存器的內容</li><li>:reg檢視目前所有暫存器的內容 (vim 有 48 個暫存器)</li><li>:set clipboard=unnamed 暫存器和剪貼簿互通</li></ul><h4>開啟檔案</h4><p>在 vim 外執行：</p><ul><li>vim index.html hello.php開啟多個檔案到 buffer</li><li>vim -o index.html hello.php一次開多個檔案(水平分割)</li><li>vim -O index.html hello.php一次開多個檔案(垂直分割)</li><li>vim -O *開啟當前目錄下的所有檔案(垂直分割)</li><li>vim -p *開啟當前目錄下的所有檔案(頁籤)</li></ul><p>在 vim 內執行：</p><ul><li>:e FILENAME 開啟檔案到新的 buffer</li></ul><h4>Buffer/Window/Tab</h4><p>buffer 資料保存<br>window 展示資料<br>tab 排版布局</p><ul><li>:ls查看目前開啟中的檔案</li><li>:b3切換到 buffer 3</li><li>:b部分filename</li><li>:bn(:bnext) 到下一個 buffer</li><li>:bp(:bprevious) 到前一個 buffer</li><li>:bl(:blast) 到最後一個 buffer</li><li>:bf(:bfast) 到第一個 buffer</li><li>:ctrl+^切換到前一個 buffer</li><li>:bd(:bdelete) 關閉當前 buffer</li><li>:tab ba (:tab ball) 展開所有 buffer 到 tab</li></ul><h4>顯示相關</h4><ul><li>:set hlsearch highlight 搜尋結果</li><li>:set nohlsearch 不 highlight 搜尋結果</li><li>:set nu(:set number) 顯示行數</li><li>:set nonu(:set nonumber) 關閉行數</li><li>:set shiftwidth=4 設定縮排寬度</li><li>:set cursorline顯示游標所在當前行</li></ul><h4>畫面分割</h4><ul><li>:tabe開啟新 tab</li><li>gt切換到下一個頁籤</li><li>gT往回切換到下一個頁籤</li><li>:new開水平分割視窗</li><li>:vnew 開垂直分割視窗</li><li>ctrl+w+w切換視窗</li><li>ctrl+w+(hjkl)移動游標到指定 視窗</li></ul><h4>set 系列</h4><ul><li>:set noswapfile不要產生 swap 檔</li><li>:set softtabstop=2按tab的縮排</li><li>:set shiftwidth=2按&gt;的縮排</li><li>:set expandtab將tab轉成空白</li><li>:set showtabline=2永遠出現 tab 區塊</li><li>:set splitbelow預設往下開啟水平視窗</li><li>:set splitright預設往右開啟水平視窗</li><li>:set ignorecase搜尋時忽略大小寫</li><li>:set incsearch漸進式搜尋，邊打邊找</li><li>:set smartcase搜尋時如果有大寫字時，會暫時當做要區分大小寫</li></ul><h4>其他</h4><ul><li>ctrl+z 將整個 vim 程式收到背景</li><li>fg將背景的 vim 叫回前景</li><li>:help v、:help buffer、:help vimrc使用 vim 內建文件查詢關鍵字</li><li>:h key-notation查詢 vim 內按鍵代碼</li><li>:syntax on語法顏色提示</li><li>:source ~/.vimrc讀取 vim 設定擋</li><li>:! ls -al 不離開 vim 執行指令</li><li>:r !ls -al將指令結果複製並貼上到目前游標所在</li><li>:retab重新tab一次</li><li>:colorscheme default使用預設主題</li><li>:colorscheme &lt;Ctrl-d&gt;可以列出可使用的主題</li><li>:filetype on讓 vim 偵測附檔名</li><li>:filetype indent on讓 vim 依據附檔名識別常用縮排</li><li>:filetype plugin on讓 vim 依據附檔名使用相關 plugin</li><li>:map 顯示目前的 key-mapping 列表</li><li>:map、:nmap、:vmap、:imap</li><li>:mapclear 清除所有 key-mapping</li><li>:let mapleader=”,” vim 預設 leader key 為\，可更換</li><li>:set顯示目前有客製的設定值</li><li>:set all顯示所有可客製化的選項</li><li>:set nocompatible設定不與 vi 相容</li><li>vimrc 還可以使用try .. catch .. endtry 避免打錯字或是別的電腦沒有安裝相關 plugin</li><li>:set nowrap關閉摺行功能</li><li>:set linebreak設定折行時以單字為單位</li><li>:set scrolloff=3預留三行就開始捲動</li><li>:set list顯示不可視字元</li></ul><p>(選取多行)時</p><ul><li>zf摺疊收為一行</li><li>zd展開摺疊</li><li>l(往右移動)展開摺疊</li><li>zfip摺疊 inner paragraph</li></ul><h4>plugins</h4><ul><li>套件管理工具 <a href="https://github.com/junegunn/vim-plug">https://github.com/junegunn/vim-plug</a></li><li>VimAwesome <a href="https://vimawesome.com/">https://vimawesome.com/</a></li></ul><h4>macro</h4><ul><li>qa開始錄製巨集到 register a</li><li>q結束錄製</li><li>@a播放 register a 的巨集</li><li>@@播放上一次的巨集</li></ul><p>Plugin 的部份因為視個人習慣，也不特別記錄起來了。像我就不太需要使用 emmet。最後也附上大大的 <a href="https://github.com/kaochenlong/cch">vim 環境安裝包</a>，可以順手給個星星。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=28edd0435074" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[推薦一本好書 Professional-PHP]]></title>
            <link>https://medium.com/@guitarbien/%E6%8E%A8%E8%96%A6%E4%B8%80%E6%9C%AC%E5%A5%BD%E6%9B%B8-professional-php-58310d0e1372?source=rss-d6d8f40fa67------2</link>
            <guid isPermaLink="false">https://medium.com/p/58310d0e1372</guid>
            <category><![CDATA[clean-architecture]]></category>
            <category><![CDATA[ddd]]></category>
            <category><![CDATA[cqrs]]></category>
            <category><![CDATA[development]]></category>
            <category><![CDATA[php]]></category>
            <dc:creator><![CDATA[guitarbien]]></dc:creator>
            <pubDate>Sun, 26 Sep 2021 13:33:46 GMT</pubDate>
            <atom:updated>2021-09-26T13:33:46.650Z</atom:updated>
            <content:encoded><![CDATA[<h3>前言緣起</h3><p><a href="https://patricklouys.com/professional-php/">Professional-PHP</a> 這本書已經出版幾年了，我也反覆閱讀了至少三次。這是一本我覺得對於 PHP developer 最適合入門的技術書籍，從中可以獲得物件導向的基本概念，並且透過實踐一個小專案來學習一些經典開發原則 (clean code )，進而再帶到一些 clean architecture、DDD 的概念。</p><p>工作一段時間之後我開始在想，除了把需求做得又快又好之外，究竟怎樣可以自稱是一位 senior developer 呢？後來發現了作者的一個 repo：<a href="https://github.com/PatrickLouys/no-framework-tutorial">no-framework-tutorial</a> 主要是學習如何不透過現有的 framework (e.g. <a href="https://laravel.com/">Laravel</a>, <a href="https://codeigniter.com/">Codeigniter</a>) 來完成專案或產品的開發。而作者在建立這個教學的過程之中發現可以講的內容太多了，不如乾脆來出一本書好了。</p><p>過了許久這本書真的出版了，不像市面上大多技術相關的理論書籍多半是以靜態語言為例，對於在鄙視鏈末端的 PHP developer 來說只能勉強了解靜態語言的一些特色和限制。而這本書對於早期體驗過 php code 和 html 混在一起的開發者來說，很適合用來理解一些軟體開發的重要原則和論述。</p><p>而且可能因為作者是瑞士人的關係，書中所使用的英文相對其他技術書籍來說，用詞上都相對簡單許多，整本書看完我大概只有一百個單字是需要查詢的而已。</p><p>我也跟隨書中的範例將相關的程式實作了一次，建議可以依照 <a href="https://github.com/guitarbien/Pure/commits/master">commit 順序</a>來觀看。</p><blockquote>Tell me and I forget. Teach me and I remember. Involve me and I learn.<br> — Benjamin Franklin</blockquote><blockquote>To teach is to learn twice.<br> — Joseph Joubert</blockquote><p>以下則記錄我在意的一些重點，如果對這些主題有興趣很推薦去看看原作的說明和範例。</p><h3>基礎觀念篇</h3><h4>程式碼可讀性和可維護性</h4><p>你的程式應當是容易閱讀和理解的。重點不是只有你自己容易閱讀理解，而是對你的整個團隊，甚至是這週剛加入的新人都應該要能輕易看的懂你的程式。</p><p>可維護的程式碼同時具備可變動的彈性。業務的需求總是不斷改變，所以產品也必須一直跟上這些變化。我們無法預測商業會怎麼樣變化，但是要盡量讓程式日後是容易修改的。（除了好加需求，也要好移除需求。）在寫出好維護的程式碼的同時其實你也得到了<strong>容易測試</strong>的程式，一旦每段程式都是簡單容易理解的，那應當容易鎖定究竟是哪邊出了問題。</p><p>回顧工作經歷可以發現，通常花在<strong>閱讀</strong>程式碼的時間比<strong>撰寫</strong>程式碼的時間來的高出許多，特別是在 debug 的時候可能閱讀了好幾個小時去理解，但最後只花幾分鐘就改完了。我們的目標不應該是寫出沒有 bug 的完美程式碼，而是寫出容易閱讀、理解和維護的程式碼。</p><h4>技術債</h4><blockquote>An ounce of prevention is worth a pound of cure.<br> — Benjamin Franklin</blockquote><p>開發時走捷徑相當於借貸，未來的你或是團隊成員勢必要來還這個借款，並且附上利息。永遠都應儘早還掉技術債，如果一直視而不見讓他利滾利那麼有朝一日你的生產力將被其拖慢，想交付新的需求將花上越來越多的時間。</p><p>即便決定此時要欠下技術債也要盡量把程式寫得乾淨。接受技術債並非代表可以無限制的把程式庫弄得一團亂，這是一種權衡。永遠都要把<strong>未來要回來重構</strong>這件事放在心上，並且該把技術債藏在乾淨的 interface 後面，不要污染到乾淨的程式。</p><blockquote>Shipping first time code is like going into debt. A little debt speeds development so long as it is paid back promptly with a rewrite. The danger occurs when the debt is not repaid.<br> — Ward Cunningham</blockquote><h4>抽象</h4><p>當我們把某件事情抽象化實其實是在隱藏實作得細節，抽象並不是要限制你開發，我們每天的對話都在做這件事。例如提到 laptop 時並不在意是哪個品牌的電腦或是多快的 cpu。</p><p>利用抽象簡化程式碼，即便最後會出現較多的 class 或是使用比較多行程式，但如此可以讓不同的實作不知道彼此的細節。</p><h4>耦合、內聚</h4><p>耦合是指兩個元件是如何依賴彼此。可維護的程式碼對於不同的元件都應是低耦合。內聚則是每個元件之中的元素有多緊密。不相關的東西要放一邊，但真正有關的東西就應該緊密的放在一起。</p><p>開發時有注意高內聚低耦合則可建造出強健可維護的程式碼，並且減少程式的複雜度，同時可以讓元件容易重複使用。</p><h4>Don’t repeat yourself</h4><p>常見違反 DRY 原則的案例是：註解和程式描述了重複的資訊。如果還需要特別用註解來描述這段程式是怎麼運作的，那代表這程式碼還不夠容易閱讀和理解。註解應該著重在 <strong>WHY</strong> 而不是 HOW。</p><blockquote>If you have to spend effort into looking at a fragment of code to figure out what it’s doing, then you should extract it into a function and name the function after that “what”.<br> — Martin fowler</blockquote><p>並非所有看起來相似的程式都應該收攏在一起以避免重複。既便是一樣的程式但代表著不同的資訊那他指的就是不同的事情。DRY is about knowledge, not how fimilar code looks.</p><blockquote>Every piece of knowledge must have a single, unambiguous, authoritative representation within a system.<br> — The don’t repeat yourself principle</blockquote><h4>命名</h4><p>Method 命名時都要有個<strong>動詞</strong>，因為他代表這個 class 的<strong>行為</strong>。命名時首重描述性，寧可長不可短。並且在同個專案內盡量保持一致，例如讀取資料可能會用到 findUser() 、fetchUser() 或 retrieveUser()，就挑一個動詞固定下來吧。</p><h4>Parameters</h4><p>宣告 method 參數的數量不宜太多，有時可以找出更抽象的詞來代表這一個或多個參數。如果很難找出一個適合的詞來表示這段資訊，那代表他們可能不適合放在一起。</p><p>不使用 flag，因為通常這代表會改變 method的行為。當需要用到 flag 時不如就乖乖的拆成兩個 method 吧。</p><h4>Method visibility</h4><p>你的 class 對外部來說應該要是一個黑盒子，使用 class 的人不需要知道實作的細節，所以預設每個 method 都應該是 private。外部只能看到你想給外部看到的 API。</p><p>繼承 Inheritance 只應使用在你的 class 就是設計來繼承用的時候。當你使用 composition 時你可以且應該限制哪些 method 該用 public。</p><h4>Keep your methods small</h4><p>每個 method 都應只做一件事，而且是小事。</p><blockquote>If you need more than 3 levels of indentation, you’re screwed anyways, and should fix your program.<br> — Linus Torvalds</blockquote><h4>Command-query separation</h4><p>每個 function 或 method 要馬是 command 要馬是 query，不會同時是 command 又是 query。Command 會改變狀態但不會回傳值。Query 則是不會改變狀態但會回傳值。Query 不管問再多次都是回傳一樣的結果，絕對不會有 side effect。</p><p>比較能接受的例外是 Martin fowler 提到的 <a href="https://martinfowler.com/bliki/CommandQuerySeparation.html">pop()</a>，他真的得在一個動作裡面又 command 又 query。但這個違反 CQS 的行為帶來了更乾淨的程式並且在命名上不會有太多爭議。</p><blockquote>Asking a question should not change the answer<br> — Bertrand Meyer</blockquote><h4>Null</h4><p>有些文章會叫大家不要使用 null。以 JAVA 為例每個 object 都是 nullable，假如有個參數型態是 UserId 傳 null 進去不會讓程式 compile 時壞掉，但是程式卻必須不斷檢查該參數是否為 null，避免 null pointer exception。其實 null 不是問題，讓所有東西都是 nullable 才是問題。</p><blockquote>I call it my billion-dollar mistake. It was the invention of the null reference in 1965.<br> — Tony Hoare</blockquote><p>PHP 沒有這個問題，型態宣告時只有在使用 ? 或給予預設值時才可接受 null。我們可以使用 null 來表示不存在的值不用擔心其他語言會有的那些問題。</p><h4>Property Visibility</h4><p>Class properties 只能是 private，不得為 public。設定 public 的 property 可以直接被外部改動，直接造成難以控制的 side effect。要透過 method 才能改變物件的狀態。</p><h4>class 預設應不能使用繼承</h4><p>很多人認為物件導向就是在講繼承，這是錯的。繼承只是可以用的工具之一而已，如果只是要為了重用程式碼，則應該使用 composition 的方式，甚至有一個原則叫 composition over inheritance。當需要從不同的 class 內共用一個 method 時，應該是要將該 method 重構成獨立的 class 並當做一個依賴注入給外部使用。</p><p>只有在一開始就是設計要用繼承的時候使用繼承。甚至如果每個 class 預設都是不能繼承才最好，透過關鍵字 final。而針對 final class 要擴充其功能還是可以的，透過 decorator 模式去 wrap 而非 extend。Decorator class 在呼叫原 class 的之前或之後要來多做一些事情來達成目的。</p><blockquote>Favor object composition over inheritance<br> — Gang of Four (Design Patterns)</blockquote><h4>You ain’t gonna need it</h4><p>很多人會過度套用 DRY 原則以致於什麼事情都想要可以 reuse。但不應過早最佳化，甚至是為了還不知道會不會發生的事情開發。試圖在未來保護自己免受重複程式碼的影響會是一場大災難。直到這段程式碼開始變成問題時才該去重構他。只剛好解決現在的問題就好了，不要過度設計。YAGNI 原則同樣也套用在效能調校上，在效能還不算問題時不用嘗試去<strong>修正</strong>他。真正遇到效能問題時應該先證明瓶頸之所在。</p><p>YAGNI 只套用在開發預期的需求上，不是需求的此時不用考慮，做剛好就好。但這不表示都不用花時間去思考如何讓專案在未來可以更容易更改。</p><blockquote>The cheapest, fastest, and most reliable components of a computer system are those that aren’t there.<br> — Gordon Bell</blockquote><blockquote>Always implement things when you actually need them, never when you just foresee that you need them.<br> — Ron Jeffries</blockquote><h3>實作篇</h3><p>本書的主要範例是透過 composer 一些基礎套件來自建一個 framework，並帶入 clean architecture &amp; DDD 的觀念，讓 application 邏輯和框架解耦合。</p><h4>Request</h4><p>不該直接使用 superglobals 變數，例如 $_REQUEST、$_SESSION。因為你永遠不知道程式中的某個地方可能會去異動其中的值。如果要取 http request 都應集中透過某個負責 request 的元件，例如 <a href="https://symfony.com/doc/current/components/http_foundation.html">Symfony HttpFoundation</a>。</p><h4>專案結構：Context &amp; Layer</h4><p>如前面提到的高內聚低耦合，把相關的東西放一起，不相關的東西放遠一點，專案的結構也應參考此概念。通常使用 framework 必須遵循其規範，例如早期的 CI2、CI3 相關的 library 就得放在 /library 下才行。而 Laravel 因為遵循 PSR4 且底層有 DI 元件，其實不必照著剛建立出來的專案結構去放程式，只要 namespace 正確都可以正常載入。但這樣是好的嗎？</p><p>雖然配合功能強勁的 IDE 開發時已經很少去看把所有資料夾都攤開來看，但讓每個程式放在適合的 namespace 下，每隻程式都有個合適的家不也很好嗎？在這個想法下我們可以以<strong>功能</strong>為首要的分類 (例如購物車、會員中心)，其次才是 <strong>layer</strong> (例如 controllers / models)。</p><p>新手開發人員很常會把所有邏輯都寫在 controller 內直到他長到了上千行，裡面從呼叫 db 到組 html、發送 email 都在 controller 內處理。這不是物件導向，這只是把 procedural code 寫在 class 內而已。RoR 的流行也讓 MVC 的火燒到了 web 生態圈，但對於 web 開發人員來說 MVC 的分法總是無法套用的很順手，因為那是適用於早期桌面軟體的架構，隨著 web 豐富的發展 MVC 的分法早已不敷使用了。</p><p>隨後開發演進到了 <strong>Thin controller, fat model</strong>， 大家又覺得這樣下去不行，model 應該是要放跟 db 最相關了邏輯才對阿，後來就把不該放在 model 也不該放在 controller 的邏輯移出到了 <strong>Service</strong> 層。漸漸 MVC 已經沒有人在提了，畢竟隨便找十個 developers 可能會對 MVC 有十種理解。但程式該有清楚的分隔還是有其好處的，如何寫出好的軟體其實最終都是著重在<strong>關注點分離</strong>這件事。接著開始有人把 active record entity 用 object relational mapper (ORM) 替換，進而了解到其實 MVC 的 M 指的該是一整個 layer，而非只是 active record model。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/660/1*MYS65Ke00BbyGSXD5Phj5A.png" /></figure><h4>Presentation Layer</h4><p>從接收 request 到回傳 response 都算是 presentation layer 的範圍。這層主要是負責入口到應用程式的橋樑。在這邊可以有 presentation 的邏輯，但業務邏輯不該放在這層，或是 controller 內。</p><h4>Application Layer</h4><p>這層是代表外部世界如何和你的應用程式互動，外部在此執行 command 或 query，這也是通常 application layer 又被稱為 <strong>use case layer</strong> 的原因（或是 service layer）。Application layer 的 class 可以被不同的 controller 所使用，例如 HTTP 或是 CLI。在這層的程式只該關心專案的 use case，而在 infrastructure 是唯一知道 database 的地方，同理 application layer 也不在乎資料是從哪來的，總之會有人餵給他。</p><h4>Infrastructure Layer</h4><p>大多數人在規劃一個新的專案或產品時，會先從資料庫開始思考，在開始開發之前就先把所有 table 和關聯都想出來。但 <strong>database first</strong> 的方式容易把所有事情都看成是 CRUD，而最後才整理出 domain logic。其實更好的思考方向是先從 code 開始著手。仔細思考你的 use case 和物件，你想要這個系統怎麼運作？你想要怎麼追蹤系統狀態的變化？不過要轉換思維是很難的，在 <a href="https://www.facebook.com/groups/dddtaiwan/">DDD Taiwan 社群</a>也有過類似的討論，Kim Kao 給了一個很棒的<a href="https://www.facebook.com/groups/dddtaiwan/posts/1132005083955174/?comment_id=1132006780621671">建議</a>：<strong>忘記存檔、忘掉要存資料庫</strong>。</p><blockquote>Invert, always invert.<br> — Carl Gustav Jacob Jacobi (mathematician)</blockquote><h4>Domain Layer</h4><p>程式中最核心的商業邏輯都該擺在這。在這層有幾個常見的區塊，其中之一就是 <strong>entity</strong>，他是一個由連續性的線程所定義的物件。通常會有一個 unique ID 來代表這個物件，即便物件上的其他屬性的值都更換了，他還是同個物件。</p><p>建議透過 named constructor 來建立 domain object，因為可以直接使用最貼近業務的語言來命名。並且強迫其他程式直接 new 這個物件來造成不符合業務情境的行為。</p><pre>private __construct()<br>{<br>    // ...<br>}</pre><pre>public function 業務行為()<br>{<br>    return new self();<br>}</pre><h4>CQRS</h4><p>Application service 的命名通常是最難的，通常在取 class name 時便會部分涵蓋到 method name (行為)。通常 class &amp; method 會是名詞 &amp; 動詞的型式，在這層如果把 use case 主體放在 class 上面會比較是 OOP 的命名方式。這也接到了 CQRS 上。</p><p>Command 是一個不能更改內容的 immutable value object，他通常只有 constructor 和 getter 來存取值，在非同步的系統中他也可以被 serialize 且有自己的 ID。每個 command class 都會對應到一個 handler class，handler 不包含任何商業邏輯，只關注自己扮演 application layer 和 domain layer 的角色。</p><h4>Command bus</h4><p>這是一個 controller 和 command handler 的中介層，我們不直接把 command 傳給 handler 而是透過 command bus 來傳輸，如此便可把一些共用的行為加在這層的 middleware 之中，例如 transactions、retry、logging、非同步化等等。</p><h4>Dependency Injection</h4><p>講 DI 之前需要先提到何謂依賴。以 controller 為例，controller 的職責在於接收 request 並回傳 response 而已，至於 render html 不該是 controller 的職責。當 classA 使用 classB 來完成自身的任務，則 classB 即為其依賴。</p><p><em>基本上</em> object 需要被實例化起來才能使用，而 DI 的精髓就在於<strong>不要自己 new</strong>，所需要的依賴注入進來直接使用即可。那這個依賴是由誰去 new 的呢？以 Laravel 為例就是 service container 囉，書中是使用了<a href="https://github.com/rdlowrey">rdlowrey</a>/<a href="https://github.com/rdlowrey/auryn">auryn</a> 這個 injector 套件來達成。</p><p>使用 <strong>new</strong> 並不是壞事，畢竟總是要有人要負責將對象實例化嘛，像是 design patterns 內的 factory 系列就是專門在 new 物件出來的。只是別直接在 class 中把依賴 new 出來使用。那麼什麼時候是允許的呢？就是配合 return 一起使用的情況，只要 new 出來的這個物件不是這個 class 自身要使用的，而是 new 給別人使用的那就沒關係。</p><blockquote>Always ask for your dependencies. Only instantiate objects that your method is going to return or pass to another method.</blockquote><h4>不使用 service locator</h4><p>Service locator 是指注入一個 locator 到程式中，並且由他來負責把所需要的 objects 建立出來。這種作法的壞處是無法一目了然程式一共有哪些依賴。相當於是強依賴於其他東西，恰好就是高內聚低耦合的相反。</p><h4>依賴抽象</h4><p>依賴抽象而非具象可以帶來較大的彈性，在一樣的 interface 下抽換實作而不用改動到原程式自身。每當要使用第三方套件時，可以考慮多墊一層 interface 以便日後有抽換的可能性。當然配合前述不要過度最佳化，也可以在真的有抽換的需求時才做。使用 interface 的潛在好處是強迫自己思考這個 use case 下什麼才是真正需要的需求，而且閱讀程式時不用一古腦就栽進實作細節中。Interface 應該要是為了使用端量身訂製的，而非只是把一堆 method 單純收集起來。</p><blockquote>No client should be forced to depend on methods it does not use.<br> — Robert C. Martin</blockquote><blockquote>Always implement things when you actually need them, never when you just foresee that you need them.<br> — Ron Jeffries</blockquote><h4>命名慣例</h4><p>在命名上常會看到 RenderInterface、PaymentGatewayInterface 等命名慣例，這個無謂的習慣沒有提高程式的可讀性或是帶來更多資訊。對使用端來說根本不在意注入進來的是 intercafe 還是 class，在意的只是型別。況且現在 IDE 已經很方便便是 class、interface、abstract class 了，更加不需要後綴字。</p><p>還是老話一句要多花些心思在命名上，找到真正對應的抽象詞彙，而非偷懶想用後綴字帶過。</p><p>放在 application layer 的 class 通常會被稱為 <strong>service</strong>。但一樣不該把這層的 class 名稱都加上 <em>Service</em> 這個後綴。用 service 後綴可以讓開發程式更快一些，因為不必再去費心想出一個最適合的 class 名稱。但日後再回過頭來看，例如一個叫 SubmissionService 的 class 無法讓你回想起他到底是在處理什麼事情。</p><p>一個好的名字應該要能描述這個物件，顯然 SubmissionService 無法提供更多有用的資訊。那為什麼用 <em>Controller </em>當後綴是可以接受的呢？因為這是有意義的。即便不是原開發者瞥到這個 class 叫做 XxxController，他可以立即對這個 class 的職責有大致的理解。但 XxxService 則無法提供一樣的共鳴，<strong>因為 service 在 developer 間已經是一個被過度使用的字了</strong>。</p><blockquote>There are only two hard things in Computer Science: cache invalidation and naming things.<br> — Phil Karlton</blockquote><h4>Value Object</h4><p>使用一個 class 來表示一個或一組值的好處是若命名得當，可讀性比直接是用字串數字等純量來當做參數高上許多。而且可以憑空創造一個適合的型別來表達這件事。例如要在畫布上畫一個有顏色的點，用純量當參數的話可能會這樣寫：</p><pre>$canvas-&gt;drawPixel(50, 25, 31, 132, 255);</pre><p>而用 value object 當參數則是：</p><pre>$canvas-&gt;drawPixel(new Coordinates(50, 25), new RGB(31, 132, 255));</pre><p>哪種可讀性比較高呢？永遠都要選擇更好閱讀更好理解的寫法，哪怕會多寫出一些 code 也沒關係。在使用 value object 時的另一個好處是可以在 construct 時就偷偷做 validation，例如 new RGB 時針對每個參數做範圍的限制，若超出範圍則該在此就拋出 exception，而不是後續才去針對 RGB object 檢查。</p><p>型態宣告像是 string、DateTimeImmutable 或是 UuidInterface 在 DDD 中被認為無法帶來業務上的意義。通常這些純量的型態會避免在 domain 中使用，而是以 value object 來取代。雖然這個作法會產生更多的 class，但帶來的好處是程式碼閱讀起來更有意義。我們自然不用程式碼內把每一個值都換成 value object，但在 domain object 的 public method 中應該要這麼做。</p><h4>Single Responsibility Principle</h4><p>一個 class 應該只有一個職責，SRP 原則相當於是 class 的關注點分離。SRP 同時也可以呼應到高內聚低耦合。高內聚的部份是想把因同樣的原因所改變的東西都放在一個 class 內，低耦合則是由不同原因而改變的東西都該放在不同的 class。如果每個 class 都只有一個職責，那要找到適合的名字將會容易許多。而且有個好的名稱無論在開發或是 debug 也都會更加容易。</p><blockquote>A class should only have one reason to change.<br> — Robert C. Martin</blockquote><h4>ORM</h4><p>常見的兩種 ORM 模式有：</p><ul><li>data mapper (例如 Doctrine)</li><li>active record (例如 Eloquent)</li></ul><p>Active record 模式因為容易使用所以在社群中很流行，但他的問題是強制把 domain obejct 和資料庫強制耦合在一起了。這其實算是技術債的一種，我們透過 active record 在初期節省了時間，但當想要更改資料表時卻很難重構。相比之下 data matpper 是另個較好的選項。不過這些套件真的是必要的嗎？例如透過 Doctrine 的 database abstraction layer (DBAL) 手動去 mapping 雖然多寫了一些程式，不過少了一點 magic。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=58310d0e1372" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Laravel worker shutdown 機制]]></title>
            <link>https://medium.com/@guitarbien/laravel-worker-shutdown-%E6%A9%9F%E5%88%B6-566ba861d65a?source=rss-d6d8f40fa67------2</link>
            <guid isPermaLink="false">https://medium.com/p/566ba861d65a</guid>
            <category><![CDATA[queue]]></category>
            <category><![CDATA[laravel]]></category>
            <category><![CDATA[devops]]></category>
            <category><![CDATA[autoscaling]]></category>
            <dc:creator><![CDATA[guitarbien]]></dc:creator>
            <pubDate>Sun, 26 Apr 2020 11:09:26 GMT</pubDate>
            <atom:updated>2020-04-26T11:09:26.154Z</atom:updated>
            <content:encoded><![CDATA[<p>在 Laravel 執行了 php artisan queue:work，若要停止 worker 的幾種方式：</p><ol><li>supervisorctl stop xxx</li><li>worker 本身遇到 lost connection (exception)</li><li>worker 收到 SIGTERM signal</li></ol><p>當執行 php artisan queue:work 時，worker 會先從 cache 中取出 keyilluminate:queue:restart 的值並保留在變數中，接著開始 while loop 不斷從 queue 中取出 job 來處理。而每處理完一個 job，worker 便會再從 cache 重新拿一次illuminate:queue:restart，若和 worker 剛啟動時得到的值不一樣，則代表這中間有執行過 queue:restart ，則應停下 worker。</p><blockquote>詳見 Illuminate\Queue\Console\RestartCommand.php 。</blockquote><blockquote>順帶一提，queue:restart 指令雖然叫 restart，但其實只負責 stop，restart 則是會交給 process monitor 例如 supervisor 處理。</blockquote><p>若 load balancer 後有多台 server，且是使用的 cache 是 shared cache 例如 redis，則所有 server 都會在做完該次 job 後便停下自己的 worker。用這簡單的設計可以輕鬆挑隨意一台 server 當主控台並將所有 server 上的 worker 重啟，在更新程式時其實很方便。但也有使用情境不想要全部 server 都做更新的情況，例如 auto scaling 縮減 server 時只有被縮到的 server 要做 graceful shutdown，其他 server 應繼續高效穩定處理 request。這種情況則可透過發送 signal。</p><p>當收到 SIGTERM 或是 lost connection 時，worker 便會標記 $this-&gt;shouldQuit = true; 在處理完這個 job 後將自己停下。假設沒有透過 supervisor 而是自行在 /etc/systemd/system 下註冊 service，只要設置KillSignal value 為 SIGTERM ，如此便可將信號傳入 Laravel worker。</p><p>額外補充：</p><ol><li>一般按下 ctrl-c 要終止在前景執行的指令時，系統送出的是 SIGINT 信號。</li><li>PHP7.1 之後可使用 pcntl_async_signals(true) 非同步處理信號，但若程式中使用了 blocking functoins 例如sleep($seconds); 遇到 signal 時不論還剩幾秒都會立即結束 sleep，詳見<a href="https://www.php.net/manual/en/function.sleep.php">官網</a>和<a href="https://www.php.net/manual/en/function.pcntl-signal.php#124049">這篇範例</a>。</li></ol><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=566ba861d65a" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[初探 Event Sourcing]]></title>
            <link>https://medium.com/@guitarbien/%E5%88%9D%E6%8E%A2-event-sourcing-753185c0b53a?source=rss-d6d8f40fa67------2</link>
            <guid isPermaLink="false">https://medium.com/p/753185c0b53a</guid>
            <category><![CDATA[system-architecture]]></category>
            <category><![CDATA[event-sourcing]]></category>
            <category><![CDATA[php]]></category>
            <category><![CDATA[laravel]]></category>
            <dc:creator><![CDATA[guitarbien]]></dc:creator>
            <pubDate>Sat, 29 Jun 2019 09:42:19 GMT</pubDate>
            <atom:updated>2019-07-06T01:41:45.627Z</atom:updated>
            <content:encoded><![CDATA[<h3>可以解決什麼問題？</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Y14Q6ns_aGyu6UzZXz9D6g.png" /><figcaption>A basic event store schema in RDBMS</figcaption></figure><h3>釐清系統錯綜複雜的狀態</h3><p>一般 log 即使再詳盡，都只能備查用，出問題時需一手 log 一手程式對照猜想。Event Sourcing 會把系統<strong>所有</strong>發生過的業務事件記錄起來，並且拿這些事件去還原成系統的核心 model 讓 log 不只是備查而是真的系統運作的核心。</p><h3>Debug</h3><p>系統的狀態也能像 git 操作 git checkout 8b6e649 這樣切換到任一個時間點，就可以看到當時系統的狀態。</p><h3>修資料</h3><p>不用另外準備 data migration 的 sql scripts，修正完程式後用同一份邏輯 replay events 即可。</p><h3>效能</h3><h4>Projection</h4><p>無論是提供給消費者、erp、供應商使用的訂單功能、提供合作商訂單串接的 API，或是各種業績報表，都不需要再寫複雜的 select sql。在 event sourcing 的概念中，每一個 select 都可以是不同的一張 table (當然如果目的是很泛用的需求也可共用一張 table)。這些 table 稱為 projection，是從 events 所投射出來的眾多不同面相的結果。而 projections 則是由 worker 以 async 方式在處理每個事件的時候，轉交為 projector 程式把 projections 的每個格子依對應的邏輯填滿內容。</p><p>所以再也不需要寫複雜的 select 和 join sql，因為 projection schema 就是依需求而設計的，基本上只要 select * from {TABLE} 就可以了，訂多再加個簡單的 where。</p><h4>Event store</h4><p>Event store 的資料表為 append only，完全沒有 update 或 select，故效能理當穩定快速。</p><h3>開發思維的轉變</h3><h4>系統當下的狀態不直接存於 db</h4><p>平時我們會從資料庫撈資料出來，做完業務運算後再把最新的狀態存回去，也就是無論何時資料庫中的資料都反應了系統最新的狀態。這樣做並無不妥，但在複雜的業務場景下可能有值得嘗試的更好作法。</p><p>Event Sourcing 的核心在於記錄事實，事實的總合就是狀態。整個系統中的所有聚合根物件都活在記憶體，而不是像平時的作法，用到的時候才從 db 獲取狀態，修改完後再存回去。當要修改系統的某個狀態時，他已經在記憶體中了，我們可以直接拿到該物件做業務規則的運算。</p><h4>系統可與 schema 解耦合</h4><p>現行系統可能無法滿足新的業務需求，但 schema 要異動的成本通常會很大 (schema migration、程式大改、data migration)。在 Event Sourcing 的概念中，系統設計不一定需從 schema 出發。因為系統的狀態不是存在資料庫而是讀取 events 後存在記憶體中，也就是 object 的 properties 上。</p><p>該做的 SA 其實並不會減少，開發團隊需要準確疏理出實際業務流程，並將其落實為程式碼。<strong>程式碼</strong>才是系統的主體、而不是 schema。</p><h3>System Flow</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-0n-CwslWFWGyucq3-uX4w.png" /></figure><h4>Command</h4><ul><li>Retrieve the aggretage.</li><li>Validate the request.</li><li>Record the event, apply to aggregate itself.</li><li>Persist to event store.</li></ul><h4>projector/reactor (worker)</h4><ul><li>Listen to events</li><li>Projector modify the projection.</li><li>Reactor execute the side effect.</li><li>Reactor can emit other events.</li></ul><h4>Query</h4><ul><li>Show the projections.</li></ul><h3>Issues</h3><blockquote>Events 都在背景處理，會不會因為塞車而拖累到重要的 events、或是客戶A的訂單影響了客戶B的訂單？</blockquote><p>所有 job 若只用一個 worker 來處理，在流量大的時候要花較久時間才會處理到新訂單。而用多個 worker，例如在多台機器上分別用 <a href="http://supervisord.org/">supervisord</a> 起多個 worker 程序，即便 message 是照 FIFO 派送，但會有事件相依的問題。假如說 退款方式 會受到 倉庫出貨 的影響，那麼以下兩種情境，系統執行 倉庫出貨 的運算時機就很重要了：</p><h4>v1</h4><ul><li>訂單成立</li><li>客人退貨</li><li>退款方式：取消授權</li></ul><h4>v2</h4><ul><li>訂單成立</li><li>倉庫出貨</li><li>客人退貨</li><li>退款方式：刷退</li></ul><p>以上面的情況而言，必須在 aggregate 處理 客人退貨 的邏輯時就把 退款方式 的結果記錄在 OrderReturned 這個 event 內。另個 request 若同時在處理 倉庫出貨 時，若發現已經有 客人退貨 這個 event，那就視需求做對應的處理即可 (例如 throw exception)。</p><blockquote>承上，若另個 request 的 aggregate 當時還沒有 客人退貨 這個 event 怎麼辦？</blockquote><p>這就是 aggragate 的 concurrency 情況。可以用 optimistic lock (程式端) 來解決。例如在 aggregate 加上一個version (int)欄位。每次 retrieve aggregate 時得到最新的 version，之後每 record 一個 event，version 就 +1 (這邊都還在記憶體內運作)，而最終要 persist 時，event store 的 schema 要把 aggregate_id 和 version 兩者設為 unique。所以同時當有兩個一樣 version 的 aggregate 最終要寫入時，第二個勢必會失敗。</p><h4>Requirements</h4><p>Event Sourcing 不限於用何種語言實作，也不限於用何種資料庫。</p><ol><li>event sourcing library / 可自行實作</li><li>message queue service (AWS SQS、RabbitMQ)</li><li>event store (rdbms / nosql)</li></ol><p>對於 Laravel developers 而言，我認為從 <a href="https://docs.spatie.be/laravel-event-projector/v2/introduction/">laravel-event-projector</a> 這份 package 去了解 Event Sourcing 是很適合的，有圖文精美的文件，且深度整合 Laravel。</p><p>其他 PHP 的 package 還有 <a href="http://getprooph.org/">prooph</a> 和 <a href="http://eventsauce.io/">EventSauce</a>，也十分值得參考。<a href="http://getprooph.org/">prooph</a> 雖說有整合 Laravel 但整體 components 拆的較細，對初次想了解 Event Soucing 的人來說門檻較高。</p><p>其中我用 <a href="https://docs.spatie.be/laravel-event-projector/v2/introduction/">laravel-event-projector</a> 所做的一些練習可以在 <a href="http://github.com/guitarbien/order-event-sourcing">github</a> 上參考。</p><h4>Reference</h4><ul><li><a href="https://docs.spatie.be/laravel-event-projector/v2/introduction/">laravel-event-projector</a></li><li><a href="https://www.infoq.com/news/2017/07/versioning-event-sourcing/">versioning event sourcing</a></li><li><a href="https://leanpub.com/esversioning/read">Versioning in an Event Sourced System</a></li><li><a href="https://speakerdeck.com/theinrich/event-sourcing-cqrs-and-best-practices?slide=14">trivago event sourcing</a></li><li><a href="https://speakerdeck.com/overeemm/dddeurope-2018-event-sourcing-after-launch?slide=34">Event Sourcing after Launch</a></li><li><a href="https://dev.to/kspeakman/event-storage-in-postgres-4dk2">event storage in postgres</a></li><li><a href="https://www.infoq.com/articles/microservices-aggregates-events-cqrs-part-1-richardson/">ddd cqrs microservices partI</a></li><li><a href="https://www.infoq.com/articles/microservices-aggregates-events-cqrs-part-2-richardson/">ddd cqrs microservices partII</a></li><li><a href="https://blog.leifbattermann.de/2017/04/21/12-things-you-should-know-about-event-sourcing/">12 Things You Should Know About Event Sourcing</a></li><li><a href="http://getprooph.org/">prooph</a></li><li><a href="http://eventsauce.io/">EventSauce</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=753185c0b53a" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Running PHP On AWS Lambda]]></title>
            <link>https://medium.com/@guitarbien/running-php-on-aws-lambda-d03ee559ce5e?source=rss-d6d8f40fa67------2</link>
            <guid isPermaLink="false">https://medium.com/p/d03ee559ce5e</guid>
            <category><![CDATA[laravel]]></category>
            <category><![CDATA[lambda]]></category>
            <category><![CDATA[aws]]></category>
            <category><![CDATA[php]]></category>
            <dc:creator><![CDATA[guitarbien]]></dc:creator>
            <pubDate>Fri, 22 Feb 2019 16:16:02 GMT</pubDate>
            <atom:updated>2019-02-24T03:47:33.370Z</atom:updated>
            <content:encoded><![CDATA[<h3>Running PHP &amp; Laravel On AWS Lambda</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/737/1*zBrQJEuuWiDFzXGR_8DD1Q.png" /></figure><p>Lambda 去年底支援了 Ruby 2.5，但仍遲遲不見 PHP，實在是很讓人失望。不過同時也提供了 custom runtime 的選項，只要是官方沒有支援的語言都可以自行打包上傳 runtime 環境並且執行 PHP 撰寫的 lambda function。</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/956/1*bqy5TuL8LyLbgjcnCUIA5g.png" /><figcaption>Use custom runtime in function code or layer.</figcaption></figure><p>直接來看一下結果：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/953/1*PPQ9VNO4h3M1kWxxZNQk8A.jpeg" /><figcaption>Testing the function.</figcaption></figure><p>這隻 function 輸出了 &quot;Hello, 5566!&quot;，且下方還有 var_dump() 的輸出。這隻程式的內容是什麼呢？</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*asyrRWa3tIHEs02b0J6Eew.png" /></figure><p>可以觀察到幾個重點：</p><ol><li>function 的 input &amp; output 使用了 scalar type hints，這是在 PHP 7 所支援的語法。</li><li>程式將 Guzzle client instance dump 出來，Guzzle 則是從大家熟悉的 composer 載入。</li><li>客製了一個 value 為 /opt 的環境變數 PATH_OPT 來指向 composer autoload.php 的位置。</li><li>右上方 Handler 和 function name 一樣。</li></ol><p>那麼是怎麼讓這個簡單的 php function 能夠在 lambda 上執行呢？除了 hello.php 之外其實還上傳了一些東西放在 <strong>Layer</strong> 裡。目前一共開了兩個 Layer 分別是 php73-runtime 和 composer-vendor：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Ucq34my-kozJwK0mO0Nt0w.jpeg" /></figure><p>php73-runtime 裡面有 php binary 和 runtime bootstrap。binary 檔案需在相容 AWS Lambda 的執行環境自行編譯。而 <strong>bootstrap</strong> 檔案則是使用 php (也可以用 shell 或其他官方支援的語言) 寫的核心程式，其主要工作是透過 curl (這邊使用 guzzle) 呼叫 lambda 的 runtime api 取得 request 後載入對應的 Handler (也就是某支 lambda function) 並將執行完的結果一樣透過 runtime api 輸出。</p><p>(其編譯 binary 的詳細方法請務必參考<a href="https://aws.amazon.com/tw/blogs/apn/aws-lambda-custom-runtime-for-php-a-practical-example/"><strong>這篇文章</strong></a>。)</p><p>另一個 composer-vendor layer 則如字面一樣裡面是一般 composer 套件的 vendor 目錄而已。</p><p>那麼好不容易做到官方支援語言可以做到的事情之後，對於 lambda 新手該怎麼進行下一步呢？莫非要回到十多年之前 PHP 物件導向還不盛行、沒幾個 framework 可以使用的年代來開發嗎：不寫 class 只用 function、不用 autoload 而是到處 require。要如此文藝復興當然也是可以，甚至業務都拆到很細甚至是好開發的，但是以專案程式碼來看可能就不見得好維護。至少以現在最流行的 Laravel 架構來看一定會非常不習慣。</p><p>但是 lambda 配合 framework 我想還是可以的，畢竟 framework 或是套件已經處理好許多事情，我們應該專注在產品業務即可。其最大的重點就在於可以把你所需的套件都放在 layer 內上傳，function (hello.php) 當成是程式的進入點即可。</p><p>例如有沒有可能將現有的 Laravel 專案放到 layer 上，然後在 lambda function 內將 request 傳給該 layer 內的 artisan，讓 Laravel console 來處理呢？結果當然是可以的啦：</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/818/1*Ps5ZzHpWfQCN0-hC2Q9ekA.jpeg" /></figure><p>另外上傳一個叫做 laravel57 的 layer，其內容就是一般的 Laravel 專案。至於餵入參數的方法則是建立一個 artisan command 作為程式進入點 (此處範例為 proxy，class name 和 command name 不必相同，詳情請參考<a href="https://laravel.com/docs/5.7/artisan#writing-commands">官方文件</a>)，這邊僅示範由 argument() 可以收到的 request 為例：</p><pre>/**<br> * Execute the console command.<br> *<br> * <a href="http://twitter.com/return">@return</a> mixed<br> */<br>public function handle()<br>{<br>    $this-&gt;info(&#39;xxxx&#39;);<br>    $this-&gt;info($this-&gt;argument(&#39;json_string&#39;));<br>}</pre><p>bootstrap 會透過 runtime api 取得 json string 的 request body，直接 pass 給 lambda function hello()，而 hello() 只是轉去呼叫 laravel57 layer 的 artisan command 並將結果一層一層返回。</p><p>需要<strong>特別提醒</strong>的是 lambda function 的 code (例如hello.php) 路徑是在 /var/tasks 下，而上傳到 layer 內的資料則是在 /opt 下。目前想像中比較貼近實務上的作法是不要把這些東西混在一起，要當做不同專案分開版控。</p><p>把主要的 production code 獨立作為一個專案，如此可以單獨做 CI。而整個 lambda 功能 (lambda 前面會再掛一個 api gateway) 當做是此專案的 endpoint 即可。至於 CD 流程可能就會比傳統複雜一些了，因為要分開部署這三包東西：</p><ol><li>custom runtime (bin + bootstrap)</li><li>layer (runtime dependency)：composer-vendor</li><li>layer (production code)：laravel57</li></ol><p>(有嘗試過繞開 hello() function 直接在 bootstrap call laravel57 artisan command 但是沒有成功)</p><p>對於不熟悉系統環境的 developers 而言能總是想儘快寫 code 不要去管機器、網路等複雜的設定。寫程式時學習怎麼抽象化介面化，而在 infra 方面也是如此。實體機、虛擬機、docker、雲端服務化等等。相信 serverless 的最終實踐就是 Lambda 了，所有跟業務需求無關的東西都給 AWS 處理好了，我們只需要趕快 coding 即可(還有付帳單)。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=d03ee559ce5e" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Vue Scoped Slot 推導]]></title>
            <link>https://medium.com/@guitarbien/vue-scoped-slot-%E6%8E%A8%E5%B0%8E-9f6b6e8217b0?source=rss-d6d8f40fa67------2</link>
            <guid isPermaLink="false">https://medium.com/p/9f6b6e8217b0</guid>
            <category><![CDATA[scoped-slot]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[vuejs]]></category>
            <dc:creator><![CDATA[guitarbien]]></dc:creator>
            <pubDate>Wed, 03 Oct 2018 14:46:38 GMT</pubDate>
            <atom:updated>2018-10-03T14:46:38.189Z</atom:updated>
            <content:encoded><![CDATA[<p>Scoped Slots 怎麼用看文件就可以了，本文介紹由 props 如何達成 Scoped Slots 一樣的效果。若是資料本身存在於 component 內，但想讓外部自由做有限的調整，則可將 property 以 function 傳入。</p><p>props 單純傳入資料：</p><pre>&lt;!--app.vue--&gt;<br>&lt;contact-list :pseudo-slot=&quot;&#39;Hello&#39; + &#39; World&#39;&quot;&gt;&lt;/contact-list&gt;<br><br>&lt;!--component--&gt;<br>{{ pseudoSlot }}</pre><p>改為傳入 arrow function</p><pre>&lt;!--app.vue--&gt;<br>&lt;contact-list :pseudo-slot=&quot;<strong>()</strong> <strong>=&gt;</strong> &#39;Hello&#39; + &#39; World&#39;&quot;&gt;<br>&lt;/contact-list&gt;<br><br>&lt;!--component--&gt;<br>{{ pseudoSlot<strong>()</strong> }}</pre><p>在 component 內將資料傳入 props 的 function，讓外部決定資料格式</p><pre>&lt;!--app.vue--&gt;<br>&lt;contact-list :pseudo-slot=&quot;(<strong>contact</strong>) =&gt; contact.first.name&quot;&gt;&lt;/contact-list&gt;<br><br>&lt;!--component--&gt;<br>{{ pseudoSlot(<strong>contact</strong>) }}</pre><p>function 內也可以傳入物件</p><pre>&lt;!--app.vue--&gt;<br>&lt;contact-list :pseudo-slot=&quot;(<strong>props</strong>) =&gt; <strong>props.</strong>contact.first.name&quot;&gt;&lt;/contact-list&gt;<br><br>&lt;!--component--&gt;<br>{{ pseudoSlot(<strong>{ contact: contact }</strong>) }}</pre><p>使用 <a href="https://vuejs.org/v2/guide/components-slots.html#Scoped-Slots">Scoped Slots</a> 做到同樣效果</p><pre>&lt;!--app.vue--&gt;<br>&lt;contact-list&gt;<br>    &lt;template <strong>slot-scope</strong>=&quot;props&quot;&gt;<br>      {{ props.contact.name.first }}<br>    &lt;/template&gt;<br>&lt;/contact-list&gt;<br><br>&lt;!--component--&gt;<br>&lt;slot <strong>:contact=&quot;contact&quot;</strong>&gt;&lt;/slot&gt;</pre><p>若已有 DOM 則不需使用 &lt;template&gt;</p><pre>&lt;!--app.vue--&gt;<br>&lt;contact-list&gt;<br>    <strong>&lt;a</strong> slot-scope=&quot;props&quot; :href=&quot;`/contacts/${props.contact.id}`&quot;<strong>&gt;</strong><br>      {{ props.contact.name.first }}<br>    <strong>&lt;/a&gt;</strong><br>&lt;/contact-list&gt;<br><br>&lt;!--component--&gt;<br>&lt;slot :contact=&quot;contact&quot;&gt;&lt;/slot&gt;</pre><p>也可將 ES2015 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Destructuring_assignment#Object_destructuring">Object Destructing</a> 套用進來，減少一個變數</p><pre>&lt;!--app.vue--&gt;<br>&lt;contact-list&gt;<br>    &lt;a slot-scope=&quot;<strong>{ contact }</strong>&quot; :href=&quot;`/contacts/${<strong>contact</strong>.id}`&quot;&gt;<br>      {{ <strong>contact</strong>.name.first }}<br>    &lt;/a&gt;<br>&lt;/contact-list&gt;<br><br>&lt;!--component--&gt;<br>&lt;slot :contact=&quot;contact&quot;&gt;&lt;/slot&gt;</pre><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=9f6b6e8217b0" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[我的白話閱讀心得 -- 單元測試的藝術]]></title>
            <link>https://medium.com/@guitarbien/%E6%88%91%E7%9A%84%E7%99%BD%E8%A9%B1%E9%96%B1%E8%AE%80%E5%BF%83%E5%BE%97-%E5%96%AE%E5%85%83%E6%B8%AC%E8%A9%A6%E7%9A%84%E8%97%9D%E8%A1%93-de322ca2a5f6?source=rss-d6d8f40fa67------2</link>
            <guid isPermaLink="false">https://medium.com/p/de322ca2a5f6</guid>
            <category><![CDATA[unit-testing]]></category>
            <category><![CDATA[php]]></category>
            <category><![CDATA[testing]]></category>
            <category><![CDATA[tdd]]></category>
            <category><![CDATA[software-testing]]></category>
            <dc:creator><![CDATA[guitarbien]]></dc:creator>
            <pubDate>Wed, 25 Jul 2018 14:54:24 GMT</pubDate>
            <atom:updated>2018-07-25T14:58:27.684Z</atom:updated>
            <content:encoded><![CDATA[<p>我認為能用自己的話來解釋東西才是真的懂。</p><p>這本書在 developers 間常被推薦，本身有過些許測試的經驗，但都是東拼西湊而來。因為早期的開發經驗比較少有機會可以去實踐寫測試這件事情(小時候以為都是 java developer 才會做的)，也許是環境關係也許是自我要求不夠，總之我是帶著一些些測試的實務經驗才來閱讀此書，雖然本身是 PHP developer，但期許自己是個 SOLID developer，希望能從中得到許多知識，並且能用自己的話來解釋大師們的理論，並付諸實踐。</p><p>以下是一些對我個人來說需要釐清、記憶、特別有價值的重點，並非所有書中的內容心得，其中還會加入一些開發觀念的想法。</p><h3>一些名詞</h3><ul><li>寫測試：一般人工在測試時是用眼睛看用腦袋判斷，寫測試就是把這個行為寫成程式而已。</li><li>SUT：System Under Test，被測試的東西。</li><li>單元測試的單元指的是 unit of work：就是測試程式去 call 一個 application 的public method，然後產生出一個可以直接被觀察的結果。可以直接被觀察的意思大概就是 該 method 有回傳值，或是這個 application 有其他的 public field / method 可以直接觀察其 state。</li><li>整合測試：不 mock 東西來真的。因為跟上線一樣是來真的，所以很重要，但是整合測試出錯代表跟 production 環境要 debug 一樣，相對於單元測試(因為單元測試範圍理當較小)會比較難抓到問題。</li><li>單元測試：把要測的東西和 &quot;相依物件或資源&quot; 隔離，餵假的東西給程式使用，只專注要測的內容。</li><li>使用 ExpectedException時需要注意如果測試的範圍很大，該例外是不是你預期的那行程式碼拋出的？</li></ul><h3>Dependency</h3><p>寫測試的過程中，如果被測的程式有其他相依物件，我們要測的內容又跟相依物件的資料或回傳值有關係，此時就該在測試中使用一個<strong>假的(我們可控制其內容或回傳值)</strong>物件當做相依物件，給被測程式使用。</p><p>而根據 SOLID 的依賴反轉原則，<strong>依賴</strong>的物件都應該是被注入而來的，並且所依賴的應該要是其抽象型別 (abstract class / interface) 而非依賴實作。</p><p>這邊又可以再延伸一下，到底何謂<strong>依賴 (dependency)</strong>？</p><p>我認為 <a href="https://patricklouys.com/professional-php/">Professional PHP</a> 這本書裡面的說明很白話清楚：</p><blockquote>When one of your classes uses a different class, <strong>to help your class to do its job</strong>, that other class is called a dependency.</blockquote><p>但是不要在你的 class 中直接去 new dependency 來使用。</p><p>那什麼時候該 new，什麼時候不該使用 new？我個人目前也是遵循 <a href="https://patricklouys.com/professional-php/">Professional PHP</a> 這本書裡面的建議：</p><blockquote>Using the new keyword is completely fine when creating an object that <strong>your method is going to return</strong> or if you need to create an object that <strong>you need to pass into a function or mehtod call</strong>.</blockquote><p><strong>new</strong> 關鍵字不是不能用，總是有個地方該去建立 instance 的。</p><p>當你的 method 去 new 出某個物件是為了要回傳給別人用的，或是此處 new 出的物件是要傳入某個 method / function，這兩種情況都可以直接使用 new 建立物件。因為該 class 本身並不是自己要用這些物件，是要給別人用的，而且中間傳入和回傳的型別如果都是抽象，也符合依賴反轉原則。</p><p>而所有 dependency 都該由 DI container 來注入。那當有了 container 之後，什麼情況下還需要使用 <strong>Factory</strong>？我目前是覺得如果建立物件的邏輯/步驟比較多，例如除了要建立這個物件的依賴，還需要給予一些設定值，那就可以把這些邏輯放在 Factory 裡面。</p><p>另外我目前覺得不要使用 Factory::create() 這樣的靜態工廠方法 (忘了正確名稱) 來產生物件。而是像一般 class 一樣，去依賴這個工廠的 interface，然後讓 container 幫你注入這個 factory instance。如此會比較有一致的風格，因為透過工廠的靜態方法去取得 dependency 依然是在依賴那個靜態工廠。</p><h3>注入相依物件的幾個方法</h3><ul><li>constructor</li><li>setter</li><li>從原本的 api 增加參數注入</li></ul><p>Class 在設計時就該決定好用何種方式注入依賴，基本上 constructor 會放必填的依賴物件，而選填的就留給 setter 使用。不過也可以在思考看看既然有選填這個情況，那麼是不是代表 class 的職責過多，也許可以再做調整。況且也不應該為了好測試而特別開出實際用不到的 public method / field。</p><p>PHP 的 class 預設是可以被繼承的，除了在 method 或 class 前加了關鍵字 final這樣就是代表宣告了這個 class 是不能夠再被繼承。我目前將 IDE 建立新檔案的 template 也都預設加上 final ，用最嚴苛的方式來要求自己的 production code。有了這個限制，便會很自然地習慣開 interface，很自然地依賴抽象，mock framework 不需要 (也不能) 直接 mock 實作 (原本是可以的因為沒加 final PHP class 都可以繼承)。</p><p>這邊也可以帶一下 <strong>composition vs inheritance</strong>。不該為了重複使用程式碼而使用繼承，該思考 class 之間的關係是 is A or has A 的關係。習慣預設都加上 final不使用繼承改用注入，若真的設計上需要使用繼承，再把 final 拿掉即可。</p><h3>到底要測什麼？</h3><p>我的觀念是<strong>做什麼測什麼</strong>。程式總是有目的，該做什麼事情就去驗什麼事情。每當開始要寫測試時我腦袋總是一片空白，這時就要想一下<strong> &quot;現在我要幹嘛？&quot;</strong> 然後開始想程式在做什麼？該驗證什麼？該怎麼驗證？</p><p>驗證測試的種類：</p><ul><li>回傳值。</li><li>改變系統狀態。</li><li>與相依物件之間的互動。</li></ul><p>至於使用<strong>假物件</strong>來幫助測試，有很多名詞：test doubles、mock、stub、fake、spy 等等。這邊概念上大概可以分為兩種，如果假物件只負責提供資料以讓程式得以走完這樣算是 stub；如果測試期望去驗證假物件的行為，例如某個 method 有沒有被呼叫過，這樣算是 mock。</p><p>書中的說明是 stub 不會導致 assert 失敗。因為測試是針對待測類別進行驗證，而非 stub。反過來測試就會針對 mock 進行驗證，所以可能會導致 assert 失敗。</p><p>隔離框架在使用上要盡量選擇測試回傳值或系統狀態改變的測試，如此可以減少對程式碼內部細部實作的假設。專案中不應有超過 5% 的測試使用到 mock (not stub)，mock 使用過多會導致測試程式閱讀性差且容易失敗。</p><h3>設計與可測試性</h3><p>程式的可測試性不是目標，而是遵循物件導向開發原則所得到的副產品，更白話來講就是程式寫得好自然會好測試。</p><ul><li>開放封閉、依賴反轉：透過繼承覆寫、或是注入介面進行修改達到。</li><li>單一職責、關注點分離：不要萬能 class，程式切細劃分清楚要做什麼。</li></ul><h3>程式設計指南</h3><h4><strong>預設情況下將方法設定為虛擬方法 / 預設情況下將類別設計成可繼承的</strong></h4><p>這兩點我放在一起說明 (因為在 PHP 來看是一樣的)，目的是要讓測試可以繼承類別覆寫方法。但是<strong>我個人不推崇</strong>這項，因為把類別預設都開放可以繼承，開發人員容易會想透過繼承來收納程式碼，事實上有很多在講述 <strong>composition over inheritance</strong> 或是 <strong>is-a</strong> / <strong>has-a </strong>的文章，都在說明不要濫用繼承。用最嚴格的規範要求自己和團隊也能更容易實踐 SOLID 原則，例如因為預設不能使用繼承，所以使用注入，而開出 interface 達到依賴反轉原則。當然如果清楚自己在幹嘛還是可以用的，只是預設不要用繼承，需要再用就好。</p><h4><strong>使用介面導向的設計</strong></h4><p>一個抽象類別不應該呼叫其他具體類別，除了資料物件(儲存資料的物件，不具有行為)之外，具體類別也不應該<strong>直接</strong>呼叫其他的具體類別。</p><p>怎麼樣算是直接呼叫呢？我覺得這段在講的是 <strong>new</strong>、<strong>依賴</strong>。我個人遵循的原則是：</p><blockquote>Using the new keyword is completely fine when creating an object that <strong>your method is going to return</strong> or if you need to create an object that <strong>you need to pass into a function or mehtod call</strong>.</blockquote><blockquote><a href="https://patricklouys.com/professional-php/">https://patricklouys.com/professional-php/</a></blockquote><p>所以程式所依賴的物件都應該是被<strong>注入</strong> (DI container) 或是透過<strong>工廠</strong>回傳得到的。而工廠的部份也使用實體的工廠，例如：DI container -&gt; memberFactory -&gt; use case layer -&gt; get member instance</p><p>在 DI container 設定好 memberFactory 並注入到 use case layer，然後在 use case layer 透過注入的 factory 取得 member instance。</p><h4>避免在包含邏輯的方法裡面初始化具體類別</h4><p>就是不要程式寫一寫突然 new Class(); 基本上這樣就是依賴了，而依賴應該被注入，也就是書中提到的接縫，可以注入才可以抽換依賴，而要抽換那代表這些物件要有相同的規格，所以要開出 interface。</p><h4>避免直接呼叫靜態方法</h4><p>因為靜態方法就是直接依賴，而且在執行時很難抽換 (除非使用不受限框架)，在考量可測試性下，看到靜態方法要想辦法重構把它抽象出去。更嚴格要求自己的話就是避免使用任何靜態方法，這樣每段邏輯都是一個類別而可以抽換。Singleton 就是一種靜態的共享資源，也缺乏可抽換的彈性。</p><h4>避免在建構式和靜態建構式中包含邏輯程式碼</h4><p>程式中常常會使用到 config 的類別，這些常常會以靜態類別或 singleton 實作，但是如上述所提難以抽換。單純 new 物件就好，如此在使用 DI container 時也十分單純。</p><h4>把 Singleton 邏輯和 Singleton 持有者分開</h4><p>用兩個類別：singleton 類別、使用 singleton 的類別。這樣可以滿足單一職責原則也可以抽換或覆寫該 singleton 類別。</p><p>動態語言沒有編譯或是型別的限制，程式碼天生就是可測試的，因為你可以在執行時期動態替換掉任何東西 (例如 PHP 的 method 參數全部不加 type hint)。既然已經具備了可測試性，那動態與研究不需要遵循 SOLID 了嗎？可測試性並不是軟體的目標，我們的目標當然是解決問題，而可測試性是好的程式的產物之一。</p><p>SOLID 等物件導向開發原則提供的好處是讓程式碼好維護和好理解。程式語言<strong>允許</strong>這樣做，並不代表你<strong>應該</strong>這樣做。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=de322ca2a5f6" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[PHP Mutation Test With Infection]]></title>
            <link>https://medium.com/@guitarbien/php-mutation-test-with-infection-e2dcb4cd6187?source=rss-d6d8f40fa67------2</link>
            <guid isPermaLink="false">https://medium.com/p/e2dcb4cd6187</guid>
            <category><![CDATA[tdd]]></category>
            <category><![CDATA[unit-testing]]></category>
            <category><![CDATA[mutation]]></category>
            <category><![CDATA[code-coverage]]></category>
            <category><![CDATA[php]]></category>
            <dc:creator><![CDATA[guitarbien]]></dc:creator>
            <pubDate>Sun, 18 Mar 2018 17:14:49 GMT</pubDate>
            <atom:updated>2018-03-19T08:16:01.899Z</atom:updated>
            <content:encoded><![CDATA[<p>在寫單元測試的時候對於新開發的程式我會希望能達到百分百的覆蓋率。常常以為程式寫完測試也都有了，但覆蓋率一打開來看就會發現很多地方沒有測試到。大多數情況補上對應的情境就可以了，例如準備個測試案例是 DB 查無資料的情況，可能就會走進某個條件判斷裡面。</p><p>比較難處理的可能是一般而言不會發生，但真的發生了又不得不寫個判斷來應對這個情況。例如：</p><pre>$result = $db-&gt;query($sql, $bind);</pre><pre>if ($result === false) {<br>    // handling sql error<br>}</pre><pre>$dataSet = $result-&gt;result_array();</pre><pre>// things go on ...</pre><p>Production code 不會寫出會造成 sql error 的程式，但 bug 就是會剛好繞過 validator 跑出來，為了要補齊 sql error 時 handling 的測試，最簡單的方式就是在這個 test case 中把$db mock 掉，讓 query() 直接回傳 false，如此就算 sql 和 bind 都正確，也不會去執行，並且一定會回傳錯誤。</p><p>不過對單元測試稍微熟悉後就會發現覆蓋率也不是萬能的。例如有個 method 是：</p><pre>public function isError(): bool<br>{<br>    return count($this-&gt;errors) &gt; 0;<br>}</pre><p>我們的測試不論是針對 $this-&gt;errors 有資料還是沒資料的情況，當只準備了任一種，這個 method 的覆蓋率都是百分之百，因為程式只有一行。</p><p>那除了 developer 對於需求以及測試的目的已經十分熟悉，知道應該補齊其他情境的測試案例，還有沒有其他方法來提醒 developer 注意到這邊可能有其他情境要注意呢？</p><p>這邊要插花提一下 TDD。</p><p>在我的理解，TDD 是利用先寫測試這個行為，來幫助 develop 來收斂需求，避免開發 production code 的時候考慮了太多需求以外的事情。同時也能利用測試來讓自己角色轉換，當做這份 production code 的使用端，來想想怎麼設計才能讓使用端覺得好用。</p><p>(使用端指的並非是 end user 或是 client / server 中的 cliend，概念上來說是 client 沒錯，但對面不一定是 server。白話一些就是去 new 這個 class 的程式就是使用端，可能是你的測試，可能是 controller，可能是某個 factory。)</p><p>在用 TDD 開發的時候，因為我們先寫了測試，並且期望等一下能用 red -&gt; green -&gt; refactoring 的循環來把 production code 帶出來，而且在這之中我們還會用最小最簡單的方式來達成綠燈。其中有個很隱密又很玄的重點：<strong>一開始的紅燈，等等會變綠燈。</strong>也就是一開始的錯誤，其實是正確的。一開始的測試一定是經過 developer 深思熟慮才寫下去的，如此才有讓測試變成綠燈的必要。</p><p>當然也有過一些經驗是 TDD 開發到一半才覺得這個設計不好用想來大改。通常這就是對需求收斂不夠，或是設計思考尚未周全就開始動工的結果。</p><p>那回歸正題，有什麼辦法可以注意到可能有需要補強的測試情境呢？在 PHP 可以使用 <a href="https://github.com/infection/infection">Infection</a> 這套變異測試工具。他的命名很有趣也很到位：Infection 字面上就是感染。他會感染你的程式碼，把 production code 裡面的 &gt; 0 變成 &gt;= 0 或是 &lt; 0。</p><p>我們想想剛剛程式中用到的 isError() 原本回傳 true 的地方如果突然變成了回傳 false，我們的程式邏輯一定就也跟著錯了對吧？這個是十分自然的概念。（很明顯就是 bug）</p><p>相對於剛剛提到 TDD 的開發流程內就是我們用最簡單的步驟讓綠燈跑出來。變異測試像是在做反過來的行為，用最簡單的方式讓原本已經是好的測試壞掉！</p><p>TDD：</p><blockquote>這個測試是對的，等一下 production code 寫出來就會對了</blockquote><p>Mutation Test：</p><blockquote>這個測試是對的，等一下 production code 故意改掉就會錯了</blockquote><p>那 Infection 這套工具會怎麼去感染我們的 production code 呢？可能有幾種方向：針對 property 或 method 的 visibility 去做調整。例如 public、protected、private 幾個關鍵字隨意調換，這樣你的程式跑的下去嗎？</p><p>還有就是直接回一個反向的 return 結果。前面加個 !。</p><p>或是剛剛講到的 &gt;、&lt;、&gt;=、&lt;= 等等的互換，用這些小小的異動來看原本好的測試是不是應該壞掉，如果壞掉了，那就代表是對的，測試情境確實有覆蓋到。如果測試沒壞，代表 production code return true / false 對這個測試來說根本沒差，那通常就是測試案例不足需要補強。也有時候是 production code 沒有遵從一步步的 TDD 流程，中間偷做了許多開發，而在測試一跑下去就發現到這些內容有可能只是單純的 &quot;想太多&quot;。</p><p>在執行 Infection 時需要注意的是，原本 PHPunit 會做覆蓋率的 production code 才會被 Infection 做變異測試。如同一開始所說的，新開發的程式應該是可以沒有藉口的達成初步的 100% 覆蓋率。至少覆蓋率先達成 100% 了，之後再做變異測試時才好釐清這些確實是變異後的錯，而不是原本的測試就有 bug 了。</p><p>實際使用我會執行 ./vendor/bin/infection --only-covered 這樣就會根據 phpunit.xml 的設定，只針對需要的 production 去做 infection。最終補齊測試案例讓 mutant 都能被 killed，這樣就比一開始的 phpunit 100% 覆蓋率更加踏實，更加安心。</p><p>Links：</p><p><a href="https://infection.github.io/">infection.github.io</a></p><p><a href="https://medium.com/@maks_rafalko/infection-mutation-testing-framework-c9ccf02eefd1">Infection — Mutation Testing Framework</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=e2dcb4cd6187" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Building rxjs Observable from scratch]]></title>
            <link>https://medium.com/@guitarbien/building-rxjs-observable-from-scratch-18870768d6f1?source=rss-d6d8f40fa67------2</link>
            <guid isPermaLink="false">https://medium.com/p/18870768d6f1</guid>
            <category><![CDATA[reactive-programming]]></category>
            <category><![CDATA[observables]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[rxjs]]></category>
            <category><![CDATA[collection]]></category>
            <dc:creator><![CDATA[guitarbien]]></dc:creator>
            <pubDate>Mon, 01 Jan 2018 15:20:50 GMT</pubDate>
            <atom:updated>2018-01-01T15:20:50.099Z</atom:updated>
            <content:encoded><![CDATA[<p>剛開始要接觸 rxjs，因為本身技能樹都是點後端居多，前端能閃則閃，連 rx 的官網都還沒看過。不過翻到了一個 rxjs 的 core contributer <a href="https://github.com/staltz">André Staltz</a> 的 <a href="https://www.youtube.com/watch?v=uQ1zhJHclvs">talk</a>。裡頭以 live coding 的方式說明了：</p><ol><li>callback 可以是 sync，也可以是 async。</li><li>以 promise 概念說明當資料是以 async 方式得到時，必須以 callback 處理(因為當下資料還沒來)。可以更進一步建立一個 API，以三個 callback 處理所有情況：資料回傳發生錯誤、資料全部取得完畢、下一份資料。把這三個 callback 封裝成 <strong>observer</strong> 物件。</li><li>subscribe 的意思就是 Give Me Data。</li><li>會呼叫 subscribe (Give Me Data) 的人就是 <strong>observable</strong>。</li><li>每個 observable 宣告自己的 subscribe 要做什麼事情。可以是一個 array、可以是 call API 取得資料、也可以是 event。並且會把每個元素(element/event/a chunk of data) 餵給剛才宣告的 <strong>&quot;下一份資料 callback&quot; </strong>處理。</li><li>array、event、promise、stream 等都可以用 callback 來操作，也都可以用 collection 操作。</li><li>為什麼 rx 沒呼叫 subscribe 就沒有動作呢？因為每個 map、filter 都是一個 observable object，只是包含著許多 methods 的 object，沒有被觸發處理資料(或 event)。</li></ol><blockquote>Observable is a way of getting a callback looking thing and making that be a collection.</blockquote><p>詳細的實作可以在我的 <a href="https://github.com/guitarbien/basic-rxjs-concepts">github</a> 看到，裡面盡量每個 commit 都段落分明，可以依序查看。</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=18870768d6f1" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>