Когда нужно использовать константу PHP_EOL в PHP и чем она отличается от \n?

Когда и зачем использовать PHP_EOL

Отличный вопрос, который мучает многих новичков. Давайте разберёмся по полочкам.

Что такое PHP_EOL? Это предопределённая константа, которая содержит правильный символ(ы) конца строки для операционной системы, на которой выполняется PHP:

• На Windows: \r\n (возврат каретки + перевод строки)
• На Linux/Mac: \n (только перевод строки)
• На старых Mac (до OS X): \r (только возврат каретки)

Когда использовать PHP_EOL — обязательно

1. Запись в текстовые файлы, которые будут открываться в блокнотах/редакторах на разных ОС

Ваш пример с лог-файлом — идеальный случай. Если вы пишете \n на Windows, файл откроется в Блокноте как одна строка (Блокнот Windows не понимает одинокий \n). А если пишете \r\n на Linux, некоторые редакторы покажут лишние символы. PHP_EOL решает эту проблему автоматически:

<?php
// Правильно для кроссплатформенной записи в файл
$log = date('Y-m-d H:i:s') . " - Пользователь залогинился" . PHP_EOL;
file_put_contents('log.txt', $log, FILE_APPEND);

// Или с fwrite
$fp = fopen('log.txt', 'a');
fwrite($fp, "Строка" . PHP_EOL);
fclose($fp);
?>

2. Вывод в консоль/терминал

Когда ваш скрипт запускается из командной строки (CLI), используйте PHP_EOL, чтобы перенос строки соответствовал ожиданиям терминала:

<?php
echo "Загрузка завершена" . PHP_EOL;
// На Windows выведет "Загрузка завершена\r\n"
// На Linux выведет "Загрузка завершена\n"
?>

3. Формирование логов/отчётов для чтения человеком

Если файл будут открывать в разных ОС, PHP_EOL — ваш выбор.

Когда НЕЛЬЗЯ использовать PHP_EOL

1. HTTP-заголовки и HTTP-протокол

Согласно стандарту HTTP (RFC 7230), заголовки должны разделяться \r\n (строго CRLF). PHP_EOL на Linux даст только \n, что сломает заголовки:

<?php
// НЕПРАВИЛЬНО — никогда так не делайте!
header("X-Custom: value" . PHP_EOL);

// ПРАВИЛЬНО — всегда жёстко пишем \r\n
header("X-Custom: value\r\n");
?>

2. Формирование email-сообщений (ваш второй пример)

Протокол SMTP (RFC 2822) также требует \r\n для разделения строк в теле письма и заголовках. PHP_EOL здесь не подходит, потому что на Linux он даст \n, и почтовый сервер может добавить лишние символы или склеить строки:

<?php
// НЕПРАВИЛЬНО — письма будут с артефактами
$message = "Строка 1" . PHP_EOL . "Строка 2";

// ПРАВИЛЬНО — всегда \r\n для email
$message = "Строка 1\r\nСтрока 2";
mail($email, $subject, $message);
?>

3. Генерация CSV-файлов

CSV-формат (RFC 4180) также требует \r\n для разделения записей. Использование PHP_EOL приведёт к несовместимости с Excel на разных платформах:

<?php
// НЕПРАВИЛЬНО
fputcsv($fp, $data, ',', '"'); // PHP сам добавит PHP_EOL в конце строки

// ПРАВИЛЬНО — используем флаг для принудительного \r\n
fputcsv($fp, $data, ',', '"', "\r\n");
?>

Практическое правило

Запомните простое правило: PHP_EOL — для вывода человеку (консоль, логи, текстовые файлы для чтения), жёсткие \r\n — для машинных протоколов (HTTP, SMTP, CSV, API).

Альтернатива: если вы пишете библиотеку, которая может работать на любой ОС, используйте PHP_EOL для текстовых файлов. Если пишете веб-приложение, которое генерирует ответы для браузера — вам не нужен ни PHP_EOL, ни \n, используйте <br> или CSS.

<?php
/**
 * Возвращает корректный EOL для заданного контекста
 * @param string $context 'file' (текстовый файл), 'http', 'email', 'csv'
 * @return string
 */
function getEol($context = 'file') {
    $eolMap = [
        'file'  => PHP_EOL,
        'http'  => "\r\n",
        'email' => "\r\n",
        'csv'   => "\r\n",
        'cli'   => PHP_EOL,
    ];
    return $eolMap[$context] ?? PHP_EOL;
}

// Использование:
$log = "Ошибка: " . $error . getEol('file');
$header = "X-Custom: value" . getEol('http');
$csvLine = implode(',', $data) . getEol('csv');
?>