Laravel 彙整 - Zeroplex 生活隨筆

從官方網站整理下來：

Airlock

使用 Airlock 可以更輕鬆的支援 single page application (SPA)、token-based API 等等，同時也可以針對 token 設定可存取犯元 (scope)。 (感覺上類似 OAuth)

Custom Eloquent Casts

以往使用者從 Eloquent ORM 拉出資料以後，使用者可以自訂 cast type，也就是說可用者可以自動 cast attribute 成特定格式。範例可以參考 Laravel 的 Pull Request。

Blade

新增不少功能來 render HTML。詳細說明請參考 Larvel Docs。

HTTP Client

為了史 API 更靈活，Laravel 使用 Guzzle HTTP client 來與其他 API 溝通。

Routing Cache

透過新的方式來做 route 的 cache，即使大型網站 (800 routes) ，route matching 的速度也可以比以往快上 20 倍。

Laravel, PHP

Laravel UrlGenerator 判斷 HTTP or HTTPS 的因素

2019 年 10 月 7 日2021 年 3 月 12 日日落尚無留言

第一個要求 Laravel 要使用 HTTP or HTTPS (以下簡稱 protocol … 因為字太多了 .._Drz) 的方法，其實就是在「.env」做設定，例如：

APP_URL=http://zeroplex.tw

再來網路上應該會找到，要開發者在 AppServiceProvider 中加入設定：

URL::forceScheme('https');

這邊的 URL facade，可以從 config/app.php 中追蹤到，是 IlluminateRoutingUrlGenerator::class 的 alias，設定了 forceSheme() 以後，未來透過 UrlGenerator 建立的 link 都會是設定好的 protocol。

BUT …. 就是這個 BUT，若是遇到另一個其他的 method 來產生 URL (例如 IlluminateRoutingRedirector::route() …)，這樣就可能吃到開發者設定的 protocol ，則由 Laravel 會自動抓進來的 request 來判斷該用什麼 protocol，若 application 剛好是靠 Nginx 在 handle HTTP SSL 的話，request 到 Laravel 這端時 HTTPS 就已經轉成 HTTP，導致 Laravel 以為 application 沒有上 HTTPS。

若要讓 reverse proxy 後面的 Laravel application 都固定用 HTTPS 的話，可以再到 app/Http/Middleware/TrustedProxy.php 去修改設定，讓 Laravel 識別 proxy 做出對應的動作 (給正確的 protocol)。

Ref: Laravel 5 force HTTPS issue with login routing to HTTP

AWS, Laravel, Nginx, PHP

使用 Eloquent migration 刪除有 key constrain 的 table / index

2019 年 7 月 18 日2021 年 3 月 12 日日落尚無留言

建立 table 時可能會同時建立 foreign key：

$table->foreign('good_id')
    ->references('id')
    ->on('goods')
    ->onDelete('cascade');

$table->index('value');

這個情況下要直接 dropIndex() 是會出現錯誤的，要先把 key constraint 解掉再來刪除 index。

而 constraint key name 用 show index from TABLE 是看不到的，但是可以使用下面的語法看到 create table 時做的事情：

show create table NAME

看到 contrain key name 以後先用 dropForeign() 刪除，再 dropIndex() 即可。

ps. 記得事情處理完以後，要把 constraint 加回去喔

Laravel, PHP

注意 PHPUnit 的 fixture 行為

2019 年 6 月 28 日2021 年 3 月 12 日日落尚無留言

理論上，各個 test case 不應該互相影響，所以 PHPUnit 設計的 fixtures 像是 setUp() 和 tearDown() 都會在各個 test case 前後執行。

簡單做個測試：

<?php

use PHPUnitFrameworkTestCase;

class LibTest extends TestCase
{
    public function setUp(): void
    {
        $this->data = null;
    }

    public function tearDown(): void
    {
        $this->data = null;
    }

    public function testOne()
    {
        $this->data = 123;
        $this->assertEquals(123, $this->data);

        return $this->data;
    }

    
    public function testTwo($data)
    {
        $this->assertEquals(123, $this->data);
    }
}



PHPUnit 8.2.3 by Sebastian Bergmann and contributors.

.F

即使在 test case 加上 @depends 標記，fixture 也會運作，所以若是要讓下一個 test case 繼續使用的測試值，都必須用 return 的方式傳值。

—-

另外，Laravel 提供的 testing tools 也有相同的行為。例如：「RefreshDatabase」，在 test case 執行結束以後就會把資料清空，因此如果要對 DB 做多像檢查，就必須在同一個 test case 中建立多個 assertions (個人不喜歡這樣做)，不然即使加上 @depends，DB 中的資料也會被 refresh 掉。

Laravel, PHP, Testing

在 Laravel unit test 手動建立 HTTP request

2019 年 6 月 27 日2021 年 3 月 12 日日落尚無留言

現在有個 controller 收到 HTTP POST data 以後才會動作，且這個 controller 為 AJAX controller，沒有 view 沒辦法用 Selenium 測試：

class TargetController extends Controller
{
    public function doSomething(Request $req)
    {

    }
}

要測試的話，其實可以透過一些工具手動測試，像是 PostMan 等類似的工具。但這種測試會遇到一些問題：Middle 有檢查使用者身份、需要拿到 access token 才能進 controller 等等。這樣會讓測試多了不少不確定因素 (變因)，導致測試結果不準確。

要進行測試較好的方法，就是建立一個 HTTP request 來模擬實際情況：

$req = new lluminateHttpRequest();

$ctrl = new TargetController()
$result = $ctrl->doSomething($req);

不過可惜的是 Request 這個類別，設計原始的用意是從 $_GET、$_POST、$_FILE 等全域變數整理成物件方便 access，所以若要在 request 中加入參數，目前只能透過 replace() 來增加。例如需要新增 key/value pair，必須這樣撰寫：

$request->replace([
    'key' => 'value',
]);

至於模擬檔案上傳 …. 我還在找方法，確定了以後再來寫筆記。

Ref：

Laravel, PHP