السطر الجديد في PHP: \n وPHP_EOL وnl2br

اكتب \n داخل نص بين علامتي تنصيص مزدوجتين لطباعة سطر جديد: echo "Line 1\nLine 2";. ويفعل الثابت PHP_EOL الشيء نفسه ويُقرأ بوضوح أكبر في نهاية السطر: echo 'Done' . PHP_EOL;. في صفحة الويب، لا يظهر السطر الجديد فاصلَ سطر؛ هناك تحتاج إلى <br> أو nl2br().

<?php
echo "Line 1\nLine 2\n";
echo 'Done' . PHP_EOL;

echo "Name:\tAda\n";      // \t is a tab
echo "Language:\tPHP\n";

علامتا التنصيص المفردتان مقابل المزدوجتين

تسلسلات الهروب مثل \n و\t لا تعمل إلا داخل علامتي التنصيص المزدوجتين. داخل المفردتين، تكون '\n' محرفين: شرطة مائلة عكسية والحرف n. وهذا السبب المعتاد لعبارة «\n لا يعمل».

<?php
echo 'Single: one\ntwo', "\n";
echo "Double: one\ntwo", "\n";

echo strlen('\n'), "\n";  // 2 characters
echo strlen("\n"), "\n";  // 1 character

// Joining single-quoted text with a newline
echo 'one' . "\n" . 'two' . PHP_EOL;

تسرد صفحة النصوص كل تسلسلات الهروب التي تفهمها علامتا التنصيص المزدوجتان.

PHP_EOL مقابل "\n"

PHP_EOL هو نهاية السطر للنظام الذي تعمل عليه PHP: "\n" على Linux وmacOS، و"\r\n" على Windows. استخدمه لمخرجات الطرفية والملفات التي ستقرؤها على الجهاز نفسه. وعندما يحدد تنسيق ما نهاية سطره الخاصة، فاستخدمها بدلًا منه: تحتاج ترويسات HTTP والبريد الإلكتروني إلى "\r\n"، ومعظم الأدوات تقرأ "\n" جيدًا في كل مكان.

<?php
var_dump(PHP_EOL);
var_dump(PHP_EOL === "\n");

$lines = ['apples', 'pears', 'plums'];
file_put_contents('list.txt', implode(PHP_EOL, $lines) . PHP_EOL);

echo file_get_contents('list.txt');
echo "Lines in file: ", count(file('list.txt')), "\n";

"\r" هو رجوع العربة، و"\n" هو تغذية السطر. تنهي ملفات Windows الأسطر بالاثنين، "\r\n"، ولهذا كثيرًا ما يحتوي النص القادم من مستخدم Windows أو من <textarea> على محارف \r لم تتوقعها.

السطر الجديد في HTML: br وnl2br

يدمج المتصفح الأسطر الجديدة في مسافة واحدة، لذا تعرض echo "a\nb" على الصفحة a b. إما أن تطبع <br> بنفسك، أو تُبقي الأسطر الجديدة في نصك وتحوّلها بـ nl2br()، التي تُدرج <br /> قبل كل منها. شغّل هذا وقارن بين تبويبي Output وPage:

<?php
$address = "221B Baker Street\nLondon\nNW1 6XE";

echo "<p><strong>Raw newlines:</strong> ", $address, "</p>\n";
echo "<p><strong>With nl2br:</strong><br>", nl2br($address), "</p>\n";
echo "<p><strong>With pre:</strong></p><pre>", $address, "</pre>\n";

في تبويب Output تبدو الثلاثة متشابهة. وفي تبويب Page يجتمع الأول في سطر واحد، وتقسّمه nl2br()، ويحتفظ <pre> بالأسطر الجديدة كما كُتبت.

عرض مُدخلات textarea مع فواصل أسطرها

يحتفظ النص القادم من <textarea> بالأسطر التي كتبها المستخدم، لكن يجب أن تهرّبه قبل طباعته في HTML. والترتيب مهم: htmlspecialchars() أولًا، ثم nl2br()، وإلا هُرّبت وسوم <br /> نفسها. شغّله، واكتب بضعة أسطر في المربع واضغط Preview: يعمل السكربت نفسه مرة أخرى مع امتلاء $_POST.

<?php
$note = $_POST['note'] ?? '';
?>
<form method="post">
    <textarea name="note" rows="4" cols="30"><?= htmlspecialchars($note) ?></textarea><br>
    <button>Preview</button>
</form>
<?php if ($note !== ''): ?>
    <h3>Preview</h3>
    <p><?= nl2br(htmlspecialchars($note)) ?></p>
    <p><?= substr_count($note, "\n") + 1 ?> lines</p>
<?php endif; ?>

قد يصل فاصل السطر في textarea على شكل "\r\n" أو "\n"؛ وكلاهما يحتوي "\n"، لذا يعمل عدّ ذلك المحرف في الحالتين. وتشرح htmlspecialchars() لماذا لا يكون التهريب اختياريًا هنا.

تقسيم نص عند السطر الجديد

تعمل explode("\n", $text) مع النص الذي أنشأته بنفسك. أما النص القادم من المستخدمين أو الملفات، فقد تكون نهايات أسطره "\r\n" أو "\n" أو "\r"؛ وتتعامل preg_split('/\R/', $text) معها كلها، لأن \R يطابق أي فاصل سطر.

<?php
$text = "first\r\nsecond\nthird\rfourth";

$lines = preg_split('/\R/', $text);
print_r($lines);

// explode leaves \r at the end of "first"
$naive = explode("\n", $text);
var_dump($naive[0]);

// Skip empty lines too
$text2 = "a\n\nb\n\n\nc\n";
print_r(preg_split('/\R/', $text2, -1, PREG_SPLIT_NO_EMPTY));

حذف فواصل الأسطر من نص

لتحويل نص متعدد الأسطر إلى سطر واحد، استبدل كل نوع من نهايات الأسطر. استبدل "\r\n" قبل المحارف المفردة، وإلا أصبح كل فاصل سطر في Windows مسافتين:

<?php
$text = "Hello\r\nworld\nfrom\rPHP\n";

$oneLine = str_replace(["\r\n", "\r", "\n"], ' ', $text);
var_dump($oneLine);

$regex = preg_replace('/\R/', ' ', $text);
var_dump(trim($regex));

// Only the newline at the end
var_dump(rtrim("last line\n", "\r\n"));

تحذف trim() وrtrim() الأسطر الجديدة في طرفي النص لكن ليس في وسطه أبدًا، لذا فهما الأداة الصحيحة لسطر مقروء من ملف والأداة الخاطئة لضم الأسطر.