TipitakaParagraphChannelController.php 1.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546
  1. <?php
  2. namespace App\Http\Controllers\V3;
  3. use App\Http\Controllers\Concerns\ResolvesCurrentUser;
  4. use App\Http\Controllers\Controller;
  5. use App\Http\Requests\V3\IndexTipitakaParagraphChannelRequest;
  6. use App\Http\Resources\V3\ChannelResource;
  7. use App\Services\V3\TipitakaChannelService;
  8. /**
  9. * 某一段有内容的 channel(mobile 与 wikipali-plugins 读某段的各版本用)。
  10. *
  11. * 取代 `GET /v2/channel?view=paragraphs`(`ChannelController@index`)。与 v2 不同:只列看得见的
  12. * (v2 连私有 channel 也列),一次一段(v2 的 para 可逗号多段,没有调用方用)。
  13. * v2 那份在 dashboard-v4 下线前原样保留,不要改动。
  14. */
  15. class TipitakaParagraphChannelController extends Controller
  16. {
  17. use ResolvesCurrentUser;
  18. public function __construct(private readonly TipitakaChannelService $channels) {}
  19. /**
  20. * 列出某段有内容的 channel
  21. *
  22. * 最近更新的在前。不登录只看得到公开的。
  23. *
  24. * @unauthenticated
  25. *
  26. * @urlParam book integer required 书
  27. * @urlParam para integer required 段
  28. *
  29. * @queryParam page integer 页码。Default: 1
  30. * @queryParam per_page integer 每页数量,最大 200。Default: 100
  31. */
  32. public function __invoke(IndexTipitakaParagraphChannelRequest $request, int $book, int $para)
  33. {
  34. return ChannelResource::collection($this->channels->forParagraph(
  35. $book,
  36. $para,
  37. $this->currentUserUid($request),
  38. $request->integer('per_page', 100),
  39. ));
  40. }
  41. }