PHP'de Alt Satıra Geçme: \n, PHP_EOL ve nl2br

Yeni bir satır yazdırmak için çift tırnaklı bir dizgenin içine \n yazın: echo "Line 1\nLine 2";. PHP_EOL sabiti aynı işi yapar ve bir satırın sonunda daha açık okunur: echo 'Done' . PHP_EOL;. Bir web sayfasında yeni satır bir satır sonu olarak görünmez; orada <br> veya nl2br() gerekir.

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

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

Tek tırnak ile çift tırnak

\n ve \t gibi kaçış dizileri yalnızca çift tırnak içinde çalışır. Tek tırnak içinde '\n' iki karakterdir: bir ters eğik çizgi ve n harfi. "\n çalışmıyor" sorununun olağan nedeni budur.

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

Dizgeler sayfası çift tırnağın anladığı her kaçış dizisini listeler.

PHP_EOL ile "\n" karşılaştırması

PHP_EOL PHP'nin çalıştığı sistemin satır sonudur: Linux ve macOS'ta "\n", Windows'ta "\r\n". Terminal çıktısı ve aynı makinede okuyacağınız dosyalar için kullanın. Bir biçim kendi satır sonunu tanımlıyorsa onun yerine onu kullanın: HTTP başlıkları ve e-posta "\r\n" ister, çoğu araç ise her yerde "\n" okumakta sorun yaşamaz.

<?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" bir satır başı (carriage return), "\n" bir satır beslemedir (line feed). Windows dosyaları satırları ikisiyle birden, "\r\n" ile bitirir; bir Windows kullanıcısından veya bir <textarea> alanından gelen metnin çoğu zaman beklemediğiniz \r karakterleri içermesinin nedeni budur.

HTML'de yeni satır: br ve nl2br

Bir tarayıcı yeni satırları tek bir boşluğa indirger, bu yüzden echo "a\nb" sayfada a b gösterir. Ya <br> etiketini kendiniz yazdırın ya da yeni satırları metninizde tutun ve her birinin önüne <br /> ekleyen nl2br() ile dönüştürün. Bunu çalıştırın ve Output ile Page sekmelerini karşılaştırın:

<?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 sekmesinde üçü de benzer görünür. Page sekmesinde ilki tek satırda birleşir, nl2br() onu böler ve <pre> yeni satırları yazıldığı gibi korur.

textarea girdisini satır sonlarıyla gösterme

Bir <textarea> alanından gelen metin kullanıcının yazdığı satırları korur, ama onu HTML'e yazdırmadan önce kaçışlamanız gerekir. Sıra önemlidir: önce htmlspecialchars(), sonra nl2br(), aksi halde <br /> etiketlerinin kendisi kaçışlanırdı. Çalıştırın, kutuya birkaç satır yazın ve Preview düğmesine basın: aynı betik $_POST doldurulmuş olarak yeniden çalışır.

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

Bir textarea satır sonu "\r\n" veya "\n" olarak gelebilir; ikisi de "\n" içerir, bu yüzden o karakteri saymak her iki durumda da çalışır. htmlspecialchars() burada kaçışlamanın neden isteğe bağlı olmadığını açıklar.

Bir dizgeyi yeni satıra göre bölme

explode("\n", $text) kendi oluşturduğunuz metinde çalışır. Kullanıcılardan veya dosyalardan gelen metinde satır sonları "\r\n", "\n" veya "\r" olabilir; preg_split('/\R/', $text) hepsini işler, çünkü \R her satır sonuyla eşleşir.

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

Bir dizgeden satır sonlarını silme

Çok satırlı bir metni tek satıra çevirmek için her tür satır sonunu değiştirin. "\r\n" değerini tek karakterlerden önce değiştirin, yoksa her Windows satır sonu iki boşluğa dönüşür:

<?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() ve rtrim() bir dizgenin uçlarındaki yeni satırları siler ama ortadakileri asla silmez; bu yüzden bir dosyadan okunan bir satır için doğru, satırları birleştirmek için yanlış araçtır.