2
0

MarkupPreviewController.php 1.9 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\StoreMarkupPreviewRequest;
  6. use App\Http\Resources\V3\MarkupPreviewResource;
  7. use App\Services\V3\MarkupPreviewService;
  8. /**
  9. * 源码预览(模板生成器、编辑器的「预览」)。
  10. *
  11. * 新能力,没有一一对应的 v2 端点:v2 只有绑定在某篇文章上、走旧渲染器的 `PUT /v2/article-preview/{id}`
  12. * (`ArticleController@preview`),那份在 dashboard-v4 下线前原样保留,不要改动。
  13. */
  14. class MarkupPreviewController extends Controller
  15. {
  16. use ResolvesCurrentUser;
  17. public function __construct(private readonly MarkupPreviewService $previews) {}
  18. /**
  19. * 预览一段源码
  20. *
  21. * 把还没保存的 markdown 渲染成节点树(与术语、批注的 `body` 同形),不写库,所以是 200 而不是 201。
  22. * 口径同阅读页的读模式:术语按第一个 channel 查,句子模板缺省读这些 channel 的译文。
  23. * 给了 `channels` 的,每个都要有读权限:不存在 404,看不见 403。
  24. *
  25. * @bodyParam content string required 源码,最多 20000 字
  26. * @bodyParam content_type string 方言。Enum: markdown, markdown-e2。Default: markdown
  27. * @bodyParam channels string[] 内容所属的 channel uid,最多 10 个
  28. * @bodyParam lang string 没给 channel 时用的语言,如 zh-Hans。缺省用界面语言(Accept-Language 协商的结果)
  29. *
  30. * @responseStatus 403 给的 channel 没有读权限
  31. * @responseStatus 404 给的 channel 不存在
  32. */
  33. public function __invoke(StoreMarkupPreviewRequest $request)
  34. {
  35. return MarkupPreviewResource::make($this->previews->preview(
  36. $request->validated(),
  37. $this->currentUser($request)['user_uid'],
  38. app()->getLocale(),
  39. ));
  40. }
  41. }