ירידת שורה ב-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";

גרשיים בודדים מול מירכאות כפולות

רצפי escape כמו \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;

העמוד מחרוזות מפרט כל רצף escape שמירכאות כפולות מבינות.

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> שומר על השורות שהמשתמש הקליד, אבל חייבים לבצע לו escape לפני שמדפיסים אותו לתוך HTML. הסדר חשוב: קודם htmlspecialchars(), ואז nl2br(), אחרת תגיות ה-<br /> עצמן היו עוברות escape. הריצו את זה, הקלידו כמה שורות בתיבה ולחצו על 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() מסבירה למה escape אינו אופציונלי כאן.

פיצול מחרוזת לפי ירידת שורה

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() מסירות ירידות שורה בקצוות של מחרוזת אבל אף פעם לא באמצע, ולכן הן הכלי הנכון לשורה שנקראה מקובץ והכלי הלא נכון לחיבור שורות.