Laravelのbladeで改行コードを含むデータを安全に表示するにはnl2brとhtmlspecialcharsを使おう

Laravel・PHP豆知識・トラブル対策

Laravelのbladeファイル上で、改行コードを付けて、安全にデータを表示するには、nl2br と htmlspecialcharsを使います。

たとえば、データベースに次のデータが保存されているとします。

これを表示する際、こんなふうに改行が消えてしまうときの対策です。

【改行が反映されない状態】

blade.phpファイルで、次のように nl2br と htmlspecialcharsを変数に加えてください。

★変更前: {{$post->body}}

★変更後: {!! nl2br(htmlspecialchars($pose->body)) !!}

すると、データ内にあった改行がちゃんと反映されます。

【改行が反映された状態】

ここから先は、なぜ上記のコードで問題が解決されるのか解説しますね。

Laravelのbladeで改行コードを含むデータを安全に表示するにはnl2brとhtmlspecialcharsを使う理由解説

改行が表示されない理由は、html は改行文字があっても、表示上改行しないようになっているからです。
改行したいときは、<br> という改行を示すタグを使う必要があります。

ですがフォームでのテキスト入力画面で、いちいち <br>をつけるのが面倒ですよね。

そこで改行コードを <br>に変換してしまう関数 nl2br() を使います。

処理① 

{{ nl2br(変数名)}}

ただ、二重波カッコ {{ }}で囲むと、コードがそのまま表示されてしまいます。

二重波カッコはエスケープ処理のために行っており、危険なコードを入れられても安全なように、コードを文字列にしてしまうのです。

つまり、<br>タグを入れても、改行がされないのです!

「エスケープ処理ってなんだろ」と思ったら、下記の記事も目を通してみてくださいね。

エスケープ処理を行わないようにするには、次のように エクスクラメーションマークを{{ }}の中に入れてあげます。

処理② 

{!! nl2br(変数名)!!}

この状態で、ちゃんと改行が表示されるようになります。

ただこうすると、エスケープ処理を除外した状態なので、セキュリティ上安全ではなくなります。

そこで、エスケープ処理を行うhtmlspacialchars()関数を使って、タグを無効化しておきます。

まずhtmlspecialchars()でタグを無効化した後に、nl2br()の処理が行われる形にするため、次のように記述します。

処理③

{!! nl2br(htmlspecialchars(変数名)) !!}

これによって、br タグ以外はエスケープ処理を行う、という処理が可能になります。

 

じゅんこ
じゅんこ

ちなみにこれ、順番が大事です!

上記の順番で書かなければタグが無効化されてしまったりするので、ご注意ください。

おまけ nl2br の意味

最後に、nl2brについて、ちょっと補足です。

nl2brというとなんだか言いにくい感じますが、nl2br は、newline to br を省略した名称です。

newline to br =改行(newline) を br タグにする

という意味です。

じゅんこ
じゅんこ

結構、そのまんまですよね。

わりとよく使うかもしれないので、覚えてしまうと便利です♪

Laravel・PHP豆知識・トラブル対策 Laravel入門講座

【Laravelの教科書・プレゼント】

Junko
Laravelの使い方を覚えたい!と思ったら、ぜひ、役立ててほしいです。 基礎編は無料でプレゼント中です♪
ひつじプログラマ
会員制サイトをいちから作っていくよ。ボタンをクリックして詳細を見てね。
Laravelの教科書の詳細を見る

最新のLaravel10版テキストに加え、Laravel8版・Laravel9版もご用意しています♪

【無料プレゼント】

「LaravelでWebアプリをいちから作れるようになりたい!」

そんなLaravel初心者のあなたへ【Laravelの教科書】基礎編プレゼント中! 会員制フォーラムサイトを学習しながら作れます。

詳細はこちらをクリック

最新のLaravel10版テキストに加え、Laravel8版・Laravel9版もご用意しています♪

Laravelの本を書きました。


ひつじが目印♪
クリックするとamazonページへ。

Laravelの使い方を分かりやすく解説した書籍を出版しました。書店やAmazon等のオンラインショップにて販売中です。
Laravel10対応。Laravel11サポートガイドもご用意しています。詳しくは下記ボタンをクリック♪

書籍の詳細を見てみる

Laravelの本を書きました。


ひつじが目印♪
クリックするとamazonページへ。

Laravel10対応

Laravelの使い方を分かりやすく解説した書籍を出版しました。書店やAmazon等のオンラインショップにて販売中です。

書籍の詳細を見てみる

 

Laravelの教科書限定コミュニティ【Laravelの教科書ラボ】はじめました。
デプロイ講座付。StripeやChatGPT連携など過去10回分のセミナー動画視聴可能。

Laravel実践スキルをのばしたい方におすすめです。

ラボの案内を見てみる

Twitter始めました。
40代からプログラミング!
タイトルとURLをコピーしました