安全な保存と表示
リッチテキストエディタが作る HTML は、利用者の入力です。保存するときと表示するときの両方で、サーバー側で無害化してください。 エディタはブラウザ側でも内容を無害化しますが、エディタを通さずにエンドポイントへ直接送信することは誰にでもできます。信頼できるのはサーバーだけです。
Laravel の場合
保存時: SanitizedHtml Cast
use OhashiEditor\Laravel\Casts\SanitizedHtml;
class Post extends Model
{
protected function casts(): array
{
return ['body' => SanitizedHtml::class];
}
}
body に代入された内容は、データベースに届く前に無害化されます。null は null のままです。
表示時: <x-ohashi-content>
<x-ohashi-content :html="$post->body" class="prose" />
<!-- 出力 -->
<div class="orte-rendered-content prose">…無害化済みの HTML…</div>
保存されている内容にかかわらず、表示のたびに無害化します。Cast を入れる前に保存された行や、データベースに直接書かれた内容にも効きます。外側の要素には独自のスタイルが無いので、サイトの本文スタイル(例: Tailwind の prose)がそのまま当たります。
そのまま出力しない
{!! $post->body !!} とは書かず、<x-ohashi-content> を使ってください。
フォームリクエストで長さを制限する
2 MiB(変更可)を超える入力は、切り詰めずに例外にします。切り詰めると、文章の一部だけが保存され、残りが黙って失われるためです。利用者に分かるメッセージを出せるよう、先に長さを検証してください。
public function rules(): array
{
return [
// Laravel の max は文字数で数えます。日本語は 1 文字あたり約 3 バイトなので、
// バイト数の上限より十分小さくしてください。
'body' => ['required', 'string', 'max:300000'],
];
}
上限を変える場合:
OHASHI_EDITOR_MAX_INPUT_BYTES=4194304
Laravel を使わない場合
サニタイザは Laravel に依存していません。
use OhashiEditor\HtmlSanitizer;
use OhashiEditor\Exception\SanitizationException;
$sanitizer = new HtmlSanitizer();
try {
$clean = $sanitizer->sanitize($_POST['body'] ?? '');
} catch (SanitizationException $e) {
// $e->errorCode() === OhashiEditor\ErrorCode::InputTooLong(OE-SAN-3002)
}
echo '<div class="orte-rendered-content">' . $sanitizer->sanitize($storedHtml) . '</div>';
残るもの
サニタイザは、エディタが作れるものだけを残し、それ以外を取り除きます。
| 残るもの | 要素 |
|---|---|
| 文章 | p br h2 h3 h4 strong b em i s del u code pre blockquote hr |
| リスト | ul ol li |
| リンク | a。href(http・https・mailto・tel・相対 URL)と target="_blank" のみ。すべてのリンクに rel="noopener noreferrer" が付きます |
| 画像 | img。src(http・https・相対 URL、または PNG/JPEG/GIF/WebP/AVIF の data URL)・alt・width(数値か %) |
| 表 | table thead tbody tr th td。小さな colspan / rowspan |
<span>・<div>・<font>などの囲みは取り除きますが、中の文字は残します。<script>・<style>・<iframe>・<svg>・フォームなどは中身ごと取り除きます。標準外の要素も同様です。style・class・id・すべてのイベントハンドラ属性(onclickなど)は取り除きます。