nl2br
تابع nl2br در PHP، کاراکتر پایان خط \n را به تگ HTML <br> تبدیل می کند. «پایان خط (Newline)» یعنی رفتن به خط بعد، مثل وقتی در چت اینتر می زنی.
سینتکس و کارکرد nl2br
سینتکس: nl2br(string, xhtml). ورودی string متن است. ورودی xhtml یک بولین است. اگر true باشد، خروجی <br /> می دهد. اگر false باشد، خروجی <br> می دهد.
نمونه پایه: تبدیل \n به <br />
<?php
echo nl2br("One line.\nAnother line.");
?>
نمونه XHTML غیرفعال: تولید <br>
<?php
echo nl2br("One line.\nAnother line.", false);
?>
گام های عملی
- رشته چندخطی بساز. از \n برای رفتن خط بعد استفاده کن.
- تابع nl2br را صدا بزن و رشته را بده.
- در صورت نیاز، مقدار xhtml را false قرار بده.
نکته ها و تغییرات
نکته: مقدار xhtml از PHP 5.3 اضافه شد. قبل از PHP 4.0.5 خروجی <br> بود. بعد از آن، خروجی پیش فرض <br /> است.
جمع بندی سریع
- nl2br، \n را به تگ خط جدید تبدیل می کند.
- پیش فرض خروجی، <br /> است.
- با xhtml=false، <br> تولید می شود.
- برای نمایش متن چندخطی در HTML عالی است.