Xuống dòng trong PHP: \n, PHP_EOL và nl2br

Viết \n trong một chuỗi dấu nháy kép để in xuống dòng: echo "Line 1\nLine 2";. Hằng số PHP_EOL làm việc tương tự và dễ đọc hơn ở cuối dòng: echo 'Done' . PHP_EOL;. Trên trang web, ký tự xuống dòng không hiện thành ngắt dòng; ở đó bạn cần <br> hoặc nl2br().

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

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

Dấu nháy đơn và dấu nháy kép

Các chuỗi escape như \n và \t chỉ có tác dụng trong dấu nháy kép. Trong dấu nháy đơn, '\n' là hai ký tự: một dấu gạch chéo ngược và chữ n. Đây là lý do thường gặp nhất khiến "\n không chạy".

<?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;

Trang chuỗi liệt kê mọi chuỗi escape mà dấu nháy kép hiểu được.

PHP_EOL và "\n"

PHP_EOL là ký tự kết thúc dòng của hệ thống mà PHP đang chạy: "\n" trên Linux và macOS, "\r\n" trên Windows. Dùng nó cho đầu ra trên terminal và cho tệp bạn sẽ đọc trên cùng máy. Khi một định dạng tự quy định ký tự kết thúc dòng, hãy dùng ký tự đó: header HTTP và email cần "\r\n", còn phần lớn công cụ đọc "\n" tốt ở mọi nơi.

<?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" là ký tự về đầu dòng (carriage return), "\n" là ký tự xuống dòng (line feed). Tệp trên Windows kết thúc dòng bằng cả hai, "\r\n", vì vậy văn bản từ người dùng Windows hoặc từ một <textarea> thường chứa những ký tự \r bạn không ngờ tới.

Xuống dòng trong HTML: br và nl2br

Trình duyệt gộp các ký tự xuống dòng thành một dấu cách, nên echo "a\nb" hiện thành a b trên trang. Hoặc bạn tự in <br>, hoặc giữ ký tự xuống dòng trong văn bản rồi chuyển chúng bằng nl2br(), hàm này chèn <br /> trước mỗi ký tự xuống dòng. Chạy code này và so sánh tab Đầu ra với tab Trang:

<?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";

Ở tab Đầu ra, cả ba trông giống nhau. Ở tab Trang, cái đầu tiên dính liền trên một dòng, nl2br() ngắt nó ra, còn <pre> giữ nguyên các ký tự xuống dòng như khi viết.

Hiển thị nội dung textarea kèm các dòng

Văn bản từ một <textarea> giữ nguyên các dòng người dùng gõ, nhưng bạn phải escape nó trước khi in vào HTML. Thứ tự rất quan trọng: htmlspecialchars() trước, rồi mới nl2br(), nếu không chính các thẻ <br /> sẽ bị escape. Chạy code, gõ vài dòng vào ô rồi nhấn Preview: cùng script đó chạy lại với $_POST đã có dữ liệu.

<?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; ?>

Một chỗ xuống dòng trong textarea có thể đến dưới dạng "\r\n" hoặc "\n"; cả hai đều chứa "\n", nên đếm ký tự đó là đúng trong cả hai trường hợp. htmlspecialchars() giải thích vì sao ở đây không thể bỏ qua bước escape.

Tách chuỗi theo dòng

explode("\n", $text) dùng được cho văn bản do bạn tự tạo. Với văn bản từ người dùng hoặc từ tệp, ký tự kết thúc dòng có thể là "\r\n", "\n" hoặc "\r"; preg_split('/\R/', $text) xử lý được tất cả, vì \R khớp với mọi kiểu xuống dòng.

<?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));

Bỏ ký tự xuống dòng khỏi chuỗi

Để biến văn bản nhiều dòng thành một dòng, hãy thay mọi kiểu ký tự kết thúc dòng. Thay "\r\n" trước các ký tự đơn lẻ, nếu không mỗi chỗ xuống dòng kiểu Windows sẽ thành hai dấu cách:

<?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() và rtrim() bỏ ký tự xuống dòng ở hai đầu chuỗi nhưng không bao giờ ở giữa, nên chúng là công cụ đúng cho một dòng đọc từ tệp và là công cụ sai để nối các dòng.