NissayaCardController.php 1.4 KB

123456789101112131415161718192021222324252627282930313233343536
  1. <?php
  2. namespace App\Http\Controllers\V3;
  3. use App\Http\Controllers\Controller;
  4. use App\Http\Requests\V3\ShowNissayaCardRequest;
  5. use App\Http\Resources\V3\NissayaCardResource;
  6. use App\Services\V3\NissayaCardService;
  7. /**
  8. * 缅文 nissaya 词尾卡片(只读、公开)。
  9. *
  10. * 取代 `GET /v2/nissaya-card/{ending}`(`NissayaCardController@show`)。v2 那份在 dashboard-v4 下线前原样保留,不要改动。
  11. */
  12. class NissayaCardController extends Controller
  13. {
  14. public function __construct(private readonly NissayaCardService $cards) {}
  15. /**
  16. * 缅文词尾卡片
  17. *
  18. * 词尾对应的语法术语(说明是新渲染器的节点树),以及它表达的语法关系:关系名与格位都带本地译名,
  19. * 另有含义分类与翻译建议。术语取 `_System_Grammar_Term_{lang}_`,没有就用 en(`lang` 字段是实际用到的语言)。
  20. * 词尾查不到时 `term` 为 null、`relations` 为空,不是 404。
  21. *
  22. * @unauthenticated
  23. *
  24. * @urlParam ending string required 缅文词尾,如 သည်
  25. *
  26. * @queryParam lang string 语言,如 zh-Hans。缺省用界面语言(Accept-Language 协商的结果)
  27. */
  28. public function __invoke(ShowNissayaCardRequest $request, string $ending)
  29. {
  30. return NissayaCardResource::make($this->cards->card($ending, $request->validated('lang') ?? app()->getLocale()));
  31. }
  32. }