Baris Baru di PHP: \n, PHP_EOL, dan nl2br

Tulis \n di dalam string dengan tanda kutip ganda untuk mencetak baris baru: echo "Line 1\nLine 2";. Konstanta PHP_EOL melakukan hal yang sama dan lebih jelas dibaca di akhir baris: echo 'Done' . PHP_EOL;. Di halaman web, baris baru tidak tampil sebagai pergantian baris; di sana kamu butuh <br> atau nl2br().

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

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

Tanda kutip tunggal vs tanda kutip ganda

Escape sequence seperti \n dan \t hanya berfungsi di dalam tanda kutip ganda. Di dalam tanda kutip tunggal, '\n' adalah dua karakter: backslash dan huruf n. Inilah alasan yang biasa di balik "\n tidak berfungsi".

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

Halaman string mencantumkan setiap escape sequence yang dikenali oleh tanda kutip ganda.

PHP_EOL vs "\n"

PHP_EOL adalah akhiran baris dari sistem tempat PHP berjalan: "\n" di Linux dan macOS, "\r\n" di Windows. Pakai untuk output terminal dan file yang akan kamu baca di komputer yang sama. Saat sebuah format menentukan akhiran barisnya sendiri, pakai itu: header HTTP dan email butuh "\r\n", dan sebagian besar alat bisa membaca "\n" dengan baik di mana pun.

<?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" adalah carriage return, "\n" adalah line feed. File Windows mengakhiri baris dengan keduanya, "\r\n", itulah sebabnya teks dari pengguna Windows atau dari <textarea> sering berisi karakter \r yang tidak kamu duga.

Baris baru di HTML: br dan nl2br

Browser meleburkan baris baru menjadi satu spasi, jadi echo "a\nb" tampil sebagai a b di halaman. Cetak <br> sendiri, atau biarkan baris baru tetap ada di teksmu lalu ubah dengan nl2br(), yang menyisipkan <br /> sebelum setiap baris baru. Jalankan kode ini dan bandingkan tab Output dan tab Halaman:

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

Di tab Output, ketiganya terlihat mirip. Di tab Halaman, yang pertama menyatu dalam satu baris, nl2br() memecahnya, dan <pre> mempertahankan baris baru seperti yang ditulis.

Menampilkan input textarea beserta baris barunya

Teks dari <textarea> mempertahankan baris-baris yang diketik pengguna, tetapi kamu harus melakukan escape sebelum mencetaknya ke HTML. Urutannya penting: htmlspecialchars() dulu, lalu nl2br(), kalau tidak tag <br /> itu sendiri yang akan di-escape. Jalankan, ketik beberapa baris ke kotaknya, lalu tekan Preview: script yang sama berjalan lagi dengan $_POST yang sudah terisi.

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

Baris baru dari textarea bisa datang sebagai "\r\n" atau "\n"; keduanya berisi "\n", jadi menghitung karakter itu berfungsi untuk kedua kasus. htmlspecialchars() menjelaskan kenapa escaping tidak boleh dilewatkan di sini.

Memecah string berdasarkan baris baru

explode("\n", $text) berfungsi untuk teks yang kamu buat sendiri. Untuk teks dari pengguna atau file, akhiran barisnya bisa berupa "\r\n", "\n", atau "\r"; preg_split('/\R/', $text) menangani semuanya, karena \R cocok dengan baris baru jenis apa pun.

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

Menghapus baris baru dari string

Untuk mengubah teks multibaris menjadi satu baris, ganti setiap jenis akhiran baris. Ganti "\r\n" sebelum karakter tunggalnya, kalau tidak setiap baris baru Windows akan menjadi dua spasi:

<?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() dan rtrim() menghapus baris baru di ujung-ujung string tetapi tidak pernah di tengahnya, jadi keduanya adalah alat yang tepat untuk baris yang dibaca dari file dan alat yang salah untuk menggabungkan baris.