偷懶是程設師的美德
最近在接 wordpress 的文章，要顯示在 RSS，但遇到文字之間出現 “\x08” 造成 RSS 格式錯誤，可使用這種方式過濾掉 ASCII
|
1 2 3 4 5 6 7 8 9 10 11 12 |
/** * 移除 ascii 由 wordpress 產生的問題，造成 RSS 無法讀取 {@see https://xilou.info/p/121} * * @param $text * @return string|string[]|null */ public function removeAscii($text) { return preg_replace('/[\x00-\x08\x0b-\x0c\x0e-\x1f]/','', $text); } |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
npm cache clean -f npm install -g n // 若要更新到最後一個版本 n latest // 若要更新到穩定版本 n stable // 檢查一下 node -v |
|
1 2 3 |
npm install -g npm |
參考網友文章
以下介紹兩種方法都可以達到目的
|
1 2 3 4 5 6 |
Interface MemberInterface { public function getName(); } |
|
1 2 3 4 5 6 7 8 9 |
class Member implements MemberInterface { public function () { return "Cary"; } } |
如果希望在 getName() 的時候修改回傳 “A001 – Cary”，那麼可以在方法帶入的參數使用預設值 null 來符合介面定義，修改如下
|
1 2 3 4 5 6 7 8 9 |
class Member implements MemberInterface { public function getName($id = null) { return "{$id} - Cary"; } } |
|
1 2 3 4 |
$member = new Member(); echo $member->getName("A001"); |
保持介面定義的方法樣式，但為了填入參數，我們必須要製作另外一個方法來寫入類別屬性，例如修改為
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
class Member implements MemberInterface { public function setId($id) { $this->id = $id; } public function getName() { $id = $this->id; return "{$id} - Cary"; } } |
|
1 2 3 4 5 |
$member = new Member(); $member->setId("A001"); echo $member->getName(); |
方法一，適合用在 只定義方法名稱 但不定義寫入的參數要長甚麼樣子。因為都直接定義在類別的方法中，因此比較一目了然。
|
1 2 3 4 5 6 7 |
$memberA = new MemberA(); $memberA->getName("A001"); // 接手人 Ａ 可能這樣寫，結果一個禮拜後離職 $memberB = new MemberB(); $memberB->getName("B001"); // 外包商接手人 Ｂ，參考 Ａ 很直覺得會使用這種方法 |
方法二，因為 setId() 方法並沒有定義在 Interface，是依照各個類別自行應用。在不同類別，要使用 getName() 的時候，需要使用的寫法可能會不一樣。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
$memberA = new MemberA(); $memberA->setId("A001"); // 接手人 Ａ 可能這樣寫，結果一個禮拜後離職 echo $memberA->getName(); $memberB = new MemberB(); $memberB->setUserId("B001") // 外包商接手人 Ｂ 可能這樣寫，沒有依照 Ａ 的命名樣式 echo $memberA->getName(); $memberC = new MemberC(); $memberC->id($id); // 接手人 C 可能剛學 PHP 一個月，接手處理這個問題 echo $memberC->getName(); // 接手人 D 整頓程式碼，就會 WTF ... |
不過，最怕的當然還是方法一、方法二的混用的狀況啦，因此定義 Interface 要實作 setter 與 getter，就很需要一些經驗了。
這裡介紹兩種用法的比較：
我們開發常常會有一種情況，把一筆陣列資料輸入到某隻 method()，但因為是陣列，在強型別 type hinting 的時候，不知道怎麼做限制。例如加入購物車 Cart，可能會放入多筆商品，常見的寫法是：
|
1 2 3 4 5 6 7 8 9 10 11 12 |
<?php $products = [ // 這裡省略產品類別範例 // Product("商品名稱", "數量", "單價", "單位") new Product("手機", 2, 100, "支"), new Product("衣服", 3, 50, "件") ]; $cart = new Cart($products); |
我們常見設計的購物車類別：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
<?php class Cart { /** * 購物車的商品項目 * @var array */ private array $items; /** * 建構子把輸入的參數賦予到類別屬性 * @param array $products */ public function __construct(array $products) { $this->items = $products; } } |
這會有一個小問題，我們在建構子 __construct(array $products) 使用強型別規範輸入 array 卻無法明定陣列中的每項型態，這對接手或日後維護的人來說，無法一目瞭然陣列裡面的項目長什麼樣子。
如果我們可以針對陣列中的每個值做類型提示，那麼無論閱讀上或是搭配 IDE 如 phpStorm 都能做出優美的提示。 因此能透過 “…” 參數語法來表示，以下修改上述範例：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
// 方法一，一次丟入陣列 $products = [ new Product("手機", 2, 100, "支"), new Product("衣服", 3, 50, "件") ]; // 注意帶入的時候要加上 "..." $cart = new Cart(...$products); // 方法二，在參數追加 $cart = new Cart( new Product("手機", 2, 100, "支"), new Product("衣服", 3, 50, "件") ); |
那麼購物車類別如何修改？其實很簡單
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
<?php class Cart { private array $items; /** * 我們透過 ... 語法，代表參數可以輸入多筆類別是 Product 的物件 * @param Product[] $products */ public function __construct(Product ...$products) { $this->items = $products; } } |
上面建構子改良後有兩種用法，方法一是我覺得實務上最常用的方式
|
1 2 3 4 5 6 7 |
$products = [ new Product("手機", 2, 100, "支"), new Product("衣服", 3, 50, "件") ]; $cart = new Cart(...$products); |
因為使用者放入的商品數量並不固定，因此方法一實務上最常見。IDE 也能非常清楚的提示：
而方法二適合用在我們寫 Code 的應用上
|
1 2 3 4 5 6 |
$cart = new Cart( new Product("手機", 2, 100, "支"), new Product("衣服", 3, 50, "件") ); |
例如 Laravel 的 dd() 就是個好懂的範例
|
1 2 3 4 |
dd($name); dd($name, $age); |
中型實務上，展開運算子的強型別我們會使用 Interface 而不是 class 。例如這項發票中心系統 InvoiceCenter 的建構子簡化如下：
注意函式參數第三個，我們在 type hint 做展開運算子使用的是介面 ProductInterface 而不是 類別 Product。因此我們實例化類別的時候會是這樣：
沒錯就是依賴反轉，我們把這項發票中心系統 InvoiceCenter，所依賴的第三方廠商 API 從外部注入，也就是說廠商A
我們要換成廠商B，也許叫做 xxPay，那麼他們的發票系統我們也只需要實作這三項 Interface。而第三個參數 new Product() 就是我們本篇提到的應用。IDE 會告訴你這個陣列的每個類別，務必實作 ProductInterface
假設我們帶入任何一項類別，沒有實作介面 ProductInterface 那麼會輕鬆報錯給你看，這對維護人員太有效了
本篇概念參考來源 https://stackoverflow.com/questions/34273367/type-hinting-in-php-7-array-of-objects
Laravel 7 我寫了一隻 command，透過 schedule 註冊每個小時都要跑這隻程式
|
1 2 3 4 5 6 |
protected function schedule(Schedule $schedule) { $schedule->command("deploy")->hourly()->unlessBetween('01:00', '07:00'); } |
透過指令
|
1 2 3 |
php artisan schedule:run |
確實可以執行如 “git pull”, “composer install”, “php artisan optimize”, “npm install” …… 但是透過 crontab 卻會異常，顯示 “exec: composer: not found” 找不到指令的問題。以下兩種方法
首先 Laradock 的專案資料夾會看到 workspace/crontab/laradock，已經寫好了每分鐘執行 php artisan，把它註解掉，因為這個身份是 “laradock”，我們要使用的是 “root”
|
1 2 3 |
vim workspace/crontab/laradock |
|
1 2 3 |
# * * * * * laradock /usr/bin/php /var/www/artisan schedule:run >> /dev/null 2>&1 |
接著跑起所需要的環境
|
1 2 3 4 |
docker-compose build workspace php-fpm docker-compose up -d nginx mongo redis |
進入 workspace 修改 crontab
|
1 2 3 4 5 6 7 8 9 |
docker-compose exec workspace bash # 我們確定使用者身份 laradock 已經被註解掉了 vim /etc/cron.d/laradock # 增加 root vim /etc/crontab |
添加這行
|
1 2 3 |
* * * * * root cd /var/www && php artisan schedule:run >> /dev/null 2>&1 |
這樣就能使用 root 身份執行 schedule 了。
註腳掉原本使用者 laradock 的 crontab
|
1 2 3 4 |
docker-composer exec workspace bash vim /etc/cron.d/laradock |
|
1 2 3 |
# * * * * * laradock /usr/bin/php /var/www/artisan schedule:run >> /dev/null 2>&1 |
增加 root 的 crontab
|
1 2 3 |
vim /etc/crontab |
|
1 2 3 |
* * * * * root cd /var/www && php artisan schedule:run >> /dev/null 2>&1 |
這樣就可以了。
如果有用到 Git Pull ，因為是自動化的關係，因此要使用 ssh ，請參考這篇網友分享的文章，設定不需要打帳號密碼的方式。