一陣子沒見了最近好嗎?停刊電子報的這幾週我學習到不少新東西,剛好月底到了有些空檔,還是該來記錄一下了。首先是發現到 Packt 這個電子書平台,之前逛 Kobo 的 PHP 書籍就常看到他們家的,因為每本都不便宜,所以想說直接去他們平台上買看會不會比較划算。
![]() |
他們的書系有比較多關於 PHP 的進階知識,像是程式碼架構、設計模式、最新 PHP 版本的介紹等等,對於想更精進 PHP 開發的我有很大的幫助,最近在看的是 Clean Code in PHP ,電子書定價 28.99 鎂,實體書 36.99 鎂。
正當準備刷下去的時候赫然發現他們竟然有訂閱方案,一個月只要 12.99 就可以看到飽,只要一個月看一本就回本了,於是二話不說立刻訂閱下去。在閱讀上可以直接用瀏覽器看,也可以下載他們家的 App,但他們的 App 爛到我不知道該怎麼吐槽了。
不能畫線就算了,連基本的字級放大縮小也沒有,行距調整就更別想,用他們的 App 看沒兩頁我眼睛就在喊救命,他們的 App 就只有上下頁的功能,其他全部都沒有XD
由於我是用電子書裝置閱讀,不管是用瀏覽器還是 App 看體驗都超差,直到我想起我的閱讀神器:Readwise Reader。由於 Packt 的書基本上就是網頁,要看網頁內容使用 Reader 再適合也不過了,於是我就把 Packt 的頁面加入閱讀,終於可以把字放大跟畫重點了,同時還可以跟 Heptabase 整合筆記,對於後續整理超方便。
而且使用 Reader 的最大好處是它可以直接把內容擷取下來,也就是說假使日後我不再訂閱 Packt 的方案後,我依舊也可以保有書的內容,不確定這算不算是個漏洞,但基本上不要拿去轉售或散佈書籍內容應該是還好。總之 Gaze + Packt + Reader + Heptabase 是我現在用的很順手的學習模式。
除了 Packt,最近的工作也發生了變化,首先是與合作兩年多的客戶結束承攬關係,讓我重新檢視自己的工作狀態,一直以為自己把每個專案都照顧得很好,但想不到還是發生預期外的狀況,因此我把手邊的工作再進一步縮減,除了推掉原本準備要承接的專案外,還找了新夥伴來協助手邊的工作,希望把既有的工作做得更仔細更完善。
尤其是看了 Clean Code in PHP 之後,除了複習已知但很少落實在工作上的工具外,對於 Clean Code 更是有了不同的認識,書中提及一個概念是我從沒想過的:Clean Code 關注的不只是 Code,而是在軟體開發過程中的每個人,之所以會有高階程式語言的誕生,目的就是為了要人類可以理解程式內容,而非只有機器看得懂的低階語言,因此寫出別人(或三個月後的自己)可以看得懂的程式碼是身為軟體工程師最需要關注的重點。
有時候看著自己以前寫的東西,就會有種想要全部打掉重練的衝動,但程式碼的現況都是當時的情境所產生的結果,如果現在覺得不滿意,並不代表當時自己的腦殘,只是沒有花時間去重新整理,對於這點我在重構自己的 WooCommerce 推播外掛特別有感,當重構完成後我很篤定一件事,那就是初期開發這支外掛的自己絕對沒想到可以這樣做,沒有時間的累積是不會有新的想法。
關於這本書以及自己的重構心得留待日後分享,這禮拜我最想聊的是關於 WordPress 外掛的更新機制:
關於付費外掛的更新部署,我都是透過 Appsero 來完成,其他類似的服務還有 Freemius,如果是免費外掛的話可以直接上架 WordPress(.)org 進行託管,那麼在什麼情境下會需要自行託管呢?
如果你跟我一樣遇到上述服務不適合你的使用情境,又不想為了上架 .org 而花費時間去符合規範,又或者是你希望設計自己的更新流程而不想用別人寫好的框架,那麼這篇文章提及的工具可以作為一個基礎架構,了解整個程式碼的運作邏輯後,可以根據需求再自行客製化,這樣就不用被第三方服務所約束。
我的情境很單純:讓使用者可以在 WordPress 後台外掛頁面更新我所提供的免費外掛。
需要一個主機空間存放外掛的資訊檔以及新版外掛的 zip 檔,可以使用 Dropbox 或是 Google 雲端硬碟之類的空間,也可以放在自己的伺服器上,我最推薦的是放在 Github,這樣就可以跟版本控管的流程整合。
外掛資訊檔是一個 JSON 格式的文件,範例如下:
![]() |
這份檔案可以命名為 my-plugin.json 然後放在自己的空間,上傳後的路徑我們會拿來作為取得新版外掛的依據,該資訊檔的關鍵是 version 以及 download_url 這兩個參數。如果要推播新的更新通知,只要把 version 版本號升版即可。
而 download_url 是新版外掛的下載位置,如果放在 Github 上面的話可以使用 Release 來產出 zip,搭配 Github Actions 還可以自動打包不用手動處理。
處理 WordPress 外掛主要有三個勾點,分別是 plugins_api、site_transient_update_plugins 以及 upgrader_process_complete。WordPress 判斷是否有外掛需要更新依賴的是資料庫暫存 Transient API。
在 wp_options 資料表裡面有一個 _site_transient_update_plugins 欄位,裡面以序列化的方式記錄了所有外掛的相關資訊。其中一個參數叫做 new_version,當 WordPress 讀到我們的外掛版本小於 new_version 時就會觸發更新通知,並且以 package 參數中的網址作為新版外掛的下載連結:
![]() |
當使用者進入 WordPress 後台的外掛頁或是更新頁時,會觸發 get_transient() 方法,其中勾點 site_transient_update_plugins 就可以拿來修改上面這一堆序列化的內容,具體的邏輯是:
需要注意的是步驟二的第二個判斷是 version_compare( '1.0.0', $remote->version, '<' ) 的第一個參數要換成你目前外掛的版本號,通常我會用常數來定義,這樣在更版時就會比較好控制,第三與第四個判斷是檢查使用者的 WordPress 與 PHP 版本,要符合 my-plugin.json 裡面定義的最低版本要求才會收到更新通知。
除了主要的更新機制外,還有顯示新版資訊以及更新檔安裝完成後的處理,完整的程式碼可以參考 Misha Rudrastyh 大大的文章,為了方便使用,我把它加以整理後做成 Composer 套件,使用方法如下:
透過 Composer 進行安裝,使用時建立 Updater 物件並提供三個參數,分別是外掛代稱、目前外掛版本以及外掛資訊檔的下載路徑。
另外我還在外掛更新後增加了一個勾點 ods_updater_after_purge,這是讓開發者可以在外掛更新完成後加入一些任務的處理,像是更新資料表、跳出提醒通知等行為,都可以透過該勾點進行處理。
具體用法可以參考 Github 存放庫的說明:https://github.com/oberonlai/wp-updater
有個這個框架後接下來要託管付費外掛也能以此基礎繼續發展下去,像是在外掛下載連結可以帶入序號,當伺服器收到請求後就可以驗證該序號是否由已授權的網站發出的,確認沒問題才能下載,也可以整合私有存放庫讓部署流程更加自動化,這部分待日後實作後再分享出來~
完整程式碼說明:
https://oberonlai.blog/wordpress-plugin-update/
-
很久沒寫電子報有好多東西想寫,時間有限只能慢慢輸出了,下週見~
之前朋友約出來喝咖啡時他分享下一個階段的 AI 可能會發展成監督式的 AI,也就是當 AI 自己在跑的時候,會有另外一個 AI 來檢查它現在做的每一件事情是否都真的有往正確的方向推進。 當下聽到覺得這個 idea 很棒,但具體要怎麼實作完全沒有概念,更不用說這樣子 token 消耗的成本會不會變成兩倍?而且監督 AI 的 AI 需要有什麼能力?該以哪一種方式來進行監督?然後又該如何把找出的問題回報給原本的 AI 呢? 這一切問題在我最近研究 Claude Code 以外的工具時意外發現了解決方案,那就是之前我拿來做為 Discord Bot 的 AI 引擎 OMP。 OMP 是 PI 的分支,想理解什麼是 OMP 可以先從 PI 開始理解,PI 是一套開源且輕量化的 Coding CLI,也是跟 Claude Code 一樣跑在終端機的寫程式 Agent。 相較於 Claude Code 的封閉,PI 完全開源,並且支援多家不同的模型,PI 強調有需要什麼工具再自己額外安裝,就不會像 Claude Code 一樣原廠給你什麼就只能用什麼。 而 OMP 是 PI 的分支,它的概念跟...
之前分享我請 AI 設計的一套專門用來管理手邊待辦清單的專案管理軟體,邊用的時候我就在邊思考著:當我新增這些任務之後,我還是要回到終端機去把這些任務的描述、相關的文件以及完成的目標告訴 AI,然後等它跑完之後我再驗收,再回到我的計時軟體裡面來記錄是已完成還是該暫停。 如果可以在開立任務的時候,就能直接指派 AI 來做這件事情,是不是就可以少一個重複描述、開發需求的流程?剛好有了這個想法之後,就在 YouTube 上面看到一個叫做 Auto Claude 的專案。 它把 Claude 直接跟看板軟體整合,並且可以在裡面詢問 AI 關於專案的細節以及產生開發藍圖,也能設定專案的亮點與相關資訊。 我看到後驚為天人,覺得這似乎是另外一種理想的 AI 開發軟體,本想直接下載裝起來用,但請 Claude 研究後發現它有一些問題,於是就想說自己來開發,順便理解關於整個 Loop Engineering 的概念。 Claude Orchestrator 這次一樣是使用 Glaze 來開發,請它建立好專案的環境之後,然後再回到終端機去接手後續的多工並行。我的做法是先請 AI 去參考 Auto...
常常在社群媒體上看到各種自動化工具的廣告,從早期的 n8n 開始到現在 AI Agent 自動完成任務,這些工具跟流程都很棒。但是回到使用者本身,我們真的知道自己有哪些工作是可以被自動化或是應該「自動化」的嗎? 這就讓我回想起以前給自己的工作要求,那就是要把手上所做的每一件事情都記錄下來,並且可以明確看到每項任務的執行時間以及頻率,這樣事後才有辦法做回顧,我把這樣的理念也應用到承接專案的層面上。 這也是為什麼我有一些專案都是採取時薪計價的開發模式,因為我需要讓客戶知道他的預算都花在哪些項目,來藉此把資源用在合適的任務上。 我最早使用的即時軟體叫做 Ora,這是一套結合看板管理、敏捷開發流程、時數統計,甚至還有內建聊天討論串的一套強大工具。 它長期都是免費的,付費方案是團隊成員超過計算,所以我都是使用它來進行與客戶的專案管理,它的介面十分清楚且一目瞭然,可以縱觀地知道是哪一類型的任務花最多時間,也可以細看到具體是在處理哪一個問題所消耗的時數。 但當某天我打開準備使用它的時候,發現它被另外一套專案管理軟體 ClickUp...