PHP nl2br() 함수 – 줄바꿈 문자를 HTML 줄바꿈으로 변환하기

정의 및 사용 방법

nl2br() 함수는 문자열에 포함된 줄바꿈 제어 문자를 HTML의   태그로 변환하여 브라우저에서 줄바꿈이 표시되도록 합니다.

  태그는 HTML에서 줄을 바꾸는 역할을 하는 '줄 바꿈(line break)' 요소입니다.

nl2br()은 New Line To BR('줄바꿈을   태그로')의 줄임말입니다.
주어진 문자열에서 브라우저에서는 표시되지 않지만 PHP 프로그래밍에서 사용되는 모든 줄바꿈 제어 문자(\r\n, \n\r, \n, \r) 앞에 HTML의   태그를 삽입하여 반환합니다.
이렇게 삽입된   태그는 HTML에서 줄을 바꾸는 역할을 하기 때문에 브라우저에서도 그대로 줄바꿈을 유지하게 합니다.

이 함수는 주로 사용자가 게시판이나 댓글 등 <textarea>에 키보드의 엔터(Enter) 키를 눌러 입력한 글의 줄바꿈을 브라우저에서도 그대로 출력할 때 사용합니다.

PHP

// 사용자가 입력하거나 DB에서 가져온 개행 문자가 포함된 텍스트
$text = "안녕하세요.\n엔터를 치니 줄바꿈하네요^^";

// nl2br() 함수 적용
echo nl2br($text, false);

nl2br() 함수의 매개변수
`$string`	필수. 원본 문자열입니다.
`$use_xhtml`	옵션. XHTML 방식의 `<br />` 태그를 사용할지 아니면, HTML5 방식의 `<br>` 태그를 사용할지 여부를 지정합니다. XHTML 방식의 `<br />` 태그를 사용하려면 `true`를 지정합니다. HTML5 방식의 `<br>` 태그를 사용하려면 `false`를 지정합니다. 기본값은 `true`입니다.

$use_xhtml이 true로 지정되어 있으면 모든 줄바꿈 제어 문자(\r\n, \n\r, \n, \r) 앞에 HTML의   태그를, 반면에 false로 지정되어 있으면   태그를 삽입하여 반환합니다.

PHP에서 문자열을 홑따옴표(' ')로 감싸면 역슬래시( \)가 포함된 제어 문자는 제어 문자로 인식되지 않고, 문자 그대로 인식합니다.

이러한 특징은 줄바꿈 제어 문자(\r\n, \n\r, \n, \r)에도 동일하게 적용됩니다. 따라서, nl2br() 함수의 원본 문자열($string)을 감쌀 때에는 반드시 쌍따옴표(" ")를 사용해야 합니다.

PHP 잘못된 예: 홑따옴표 사용 (\n이 문자 그대로 출력됨)

$text = '안녕하세요.\n엔터를 치니 줄바꿈하네요^^';

// nl2br() 함수 적용
echo nl2br($text, false);

PHP 올바른 예: 쌍따옴표 사용 (\n이 실제 제어 문자로 인식됨)

$text = "안녕하세요.\n엔터를 치니 줄바꿈하네요^^";

// nl2br() 함수 적용
echo nl2br($text, false);