HOWTO · PHP

PHP에서 여러 줄 문자열 작성

이 기사에서는 PHP에서 여러 줄 문자열을 작성하는 방법을 소개합니다. 이스케이프 시퀀스 및 연결 할당 연산자가 포함됩니다.

이 페이지의 내용

PHP에서 여러 줄 문자열을 작성하려면 여러 줄에 걸친 리터럴 텍스트에는 heredoc 또는 nowdoc을 사용하고, 큰따옴표 문자열 안에 \n 또는 \r\n을 넣거나, .=와 PHP_EOL를 사용해 문자열 조각을 이어 붙일 수 있습니다. 이 방법들은 문자열에 줄바꿈 문자를 넣습니다. 화면에서 텍스트가 줄 바뀌어 보이는 위치는 표시 환경에 따라 달라지므로 시각적 줄 바꿈을 제어하는 것은 아닙니다. 변수 보간 여부와 필요한 줄 끝 규약을 기준으로 방법을 선택하세요.

여러 줄 문자열 리터럴에는 heredoc 또는 nowdoc 사용하기

heredoc과 nowdoc을 사용하면 줄이 바뀔 때마다 이스케이프 시퀀스를 쓰지 않고도 소스 코드에서 여러 줄에 걸쳐 문자열을 작성할 수 있습니다. heredoc은 큰따옴표 문자열처럼 동작하므로 PHP의 변수가 보간됩니다. nowdoc은 작은따옴표 문자열처럼 동작하므로 변수 이름이 문자 그대로 남습니다. 닫는 식별자는 여는 식별자와 일치해야 하며, 그 자체가 닫는 구분자입니다. 예시에서는 여는 식별자와 닫는 식별자가 모두 TEXT입니다. 닫는 식별자는 PHP의 식별자 규칙도 따라야 합니다.

다음 예를 살펴보세요.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

<?php
$name = 'Mina';
$message = <<<TEXT
Hello, $name.
Your report is ready.
TEXT;

$template = <<<'TEXT'
Hello, $name.
Your report is ready.
TEXT;

echo $message, PHP_EOL, $template;

heredoc 값에서는 $name이 있던 자리에 Mina가 들어갑니다. nowdoc 값에서는 $name이 텍스트의 일부로 그대로 남습니다. 두 값 모두 소스에서 두 줄 사이에 줄바꿈이 들어 있습니다. 변수 값이 들어가는 읽기 쉬운 템플릿에는 heredoc을, 내용을 문자 그대로 유지해야 할 때는 nowdoc을 사용하세요.

이스케이프 시퀀스로 줄바꿈 넣기

큰따옴표 문자열에서 \n은 줄 바꿈 문자(line feed)를 추가합니다. 짧은 문자열을 소스 코드 한 줄에 유지하거나 줄이 바뀌는 위치를 정확히 지정할 때 유용합니다. \n 이스케이프를 두 번 연속 사용하면 텍스트 사이에 빈 줄이 생깁니다. 작은따옴표 문자열에서는 \n이 줄 바꿈 문자로 해석되지 않으므로 이 방법에는 큰따옴표를 사용하세요.

\r\n은 캐리지 리턴 뒤에 줄 바꿈 문자가 오는 시퀀스입니다. 텍스트를 표시하는 프로그램은 이 두 문자를 흔히 하나의 줄바꿈으로 처리합니다. 캐리지 리턴은 PHP에서 텍스트 포인터를 왼쪽으로 이동시킨다는 뜻이 아니라 문자열 안에 들어 있는 문자입니다. Windows 스타일 텍스트 파일처럼 받는 형식에서 CRLF를 명시적으로 요구할 때 이 시퀀스를 선택하세요. 일반적인 플랫폼별 줄 구분에는 아래에서 설명하는 PHP_EOL를 사용하면 됩니다.

연결과 PHP_EOL로 여러 줄 문자열 만들기

.= 연산자는 오른쪽 값을 왼쪽 문자열 뒤에 덧붙입니다. 첫 번째 문자열 조각을 할당한 다음, 각 조각을 구분자와 함께 이어 붙이세요. PHP_EOL는 PHP가 실행되는 플랫폼에서 관례적으로 사용하는 줄 끝 시퀀스를 제공합니다.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

<?php
$message = 'First line';
$message .= PHP_EOL . 'Second line';
$message .= PHP_EOL . 'Third line';
echo $message;

이 순차적인 방식은 문자열을 더하는 과정을 읽기 쉽게 유지합니다. 첫 번째 할당 뒤에는 $message에 누적된 텍스트가 들어 있고, .=를 실행할 때마다 그 뒤에 내용이 추가됩니다. 다음 조각을 새 줄에서 시작하려면 그 조각 앞에 PHP_EOL를 넣으세요. 사용하는 쪽에서 요구하지 않는다면 마지막 조각 뒤에 구분자를 붙일 필요는 없습니다.

사용 사례에 맞는 줄바꿈 형식 선택하기

현재 플랫폼의 일반 텍스트로 문자열을 쓸 때 그 플랫폼의 관례적인 줄 끝이 적절하다면 PHP_EOL를 사용하세요. 이는 플랫폼 상수이며 모든 수신 시스템이 같은 바이트를 받아들인다는 보장은 아닙니다. 프로토콜, 파일 형식 또는 외부 서비스에서 LF나 CRLF를 지정한다면 호스트 플랫폼에 맡기지 말고 해당 시퀀스를 명시적으로 넣으세요.

heredoc과 nowdoc은 주로 여러 줄의 리터럴 내용을 표현하는 방식과 변수 보간 여부를 선택할 때 사용합니다. 소스에 입력한 줄바꿈은 문자열의 일부가 됩니다. 짧은 문자열이나 구분자를 정확히 지정해야 할 때는 이스케이프 시퀀스가 유용합니다. 변수나 계산된 값으로 조각을 구성할 때는 연결을 사용할 수 있습니다. 어떤 방법을 쓰든 터미널, 브라우저, 텍스트 파일, 프로토콜은 줄 끝을 서로 다르게 표시하거나 해석할 수 있으므로 대상의 요구사항을 확인하세요.