PHP Parse Error: syntax error, unexpected token - 원인 분석과 완벽 해결법

PHP 코드를 작성하다가 갑자기 화면에 뜨는 'Parse Error: syntax error, unexpected' 메시지를 본 적 있을까? 대부분의 개발자들은 이 에러가 뜨면 황급해하며 인터넷을 검색하고, 결국 에러가 난 라인 근처를 아무 생각 없이 고쳐본다. 다만 정확히 왜 이 에러가 났는지, 어디서부터 찾아야 하는지, 같은 실수를 다시 하지 않으려면 뭘 알아야 하는지를 정확히 이해하는 개발자는 많지 않다. 이번 글에서는 Parse Error의 정확한 의미, 자주 나타나는 원인들, 그리고 효율적인 디버깅 방법까지 완벽하게 정리해서 소개하겠다.

Parse Error란 무엇인가

Parse Error는 PHP 인터프리터가 코드를 읽으면서 문법(syntax) 규칙을 어겼을 때 발생하는 에러다. 컴파일 언어처럼 사전에 전체 코드를 검사하는 게 아니라, PHP는 코드를 한 줄씩 읽다가 문법 오류를 만나는 순간 멈춘다. 중요한 건 "에러가 난 라인이 반드시 실제 문제가 있는 라인은 아니"라는 점이다. 보통 에러 메시지는 문제를 "발견한" 라인을 가리킬 뿐, 진짜 문제는 그 몇 줄 위에 있을 수 있다.

자주 만나는 Parse Error 원인 5가지

1. 따옴표 짝이 맞지 않음 (가장 흔함)

문자열을 감싸는 작은따옴표(') 또는 큰따옴표(")를 닫지 않으면 PHP는 계속해서 문자열 안에 있다고 생각한다. 나중에 파일이 끝나거나 새로운 따옴표가 나타날 때까지 문법 오류를 찾지 못한다.

✗ 잘못된 코드
<?php
$name = "John;  // 큰따옴표 닫혀있지 않음
echo $name;
?>

위 코드는 다음 줄부터 전부 문자열의 일부로 인식되어 Parse Error가 발생한다. 에러 메시지는 파일이 끝나는 지점에서 "unexpected EOF" 또는 "unterminated string"이라고 나타날 수 있다.

✓ 올바른 코드
<?php
$name = "John";  // 따옴표 닫음
echo $name;
?>

2. 괄호 쌍 맞지 않음

함수 호출, 조건문, 배열 등에서 열린 괄호 ( { [ 를 닫지 않으면 Parse Error가 발생한다. IDE의 자동 완성 기능을 믿고 손으로 닫는 괄호를 빼먹기 쉽다.

✗ 잘못된 코드
<?php
if ($age > 18) {
    echo "성인입니다";
// 닫는 중괄호 빠짐
?>

✓ 올바른 코드
<?php
if ($age > 18) {
    echo "성인입니다";
}  // 닫는 중괄호 추가
?>

3. 세미콜론(;) 빠짐

PHP는 한 줄의 명령문 끝에 반드시 세미콜론을 요구한다. 마지막 문장이거나 } 바로 앞이면 간과하기 쉽다.

✗ 잘못된 코드
<?php
$count = 10
echo $count;  // 위 줄 끝에 세미콜론 없음
?>

에러 메시지는 echo 라인에서 "unexpected" 키워드가 나타났다고 말할 것이다. 하지만 실제 원인은 그 위 줄의 세미콜론 누락이다.

✓ 올바른 코드
<?php
$count = 10;  // 세미콜론 추가
echo $count;
?>

4. 예약어나 함수 이름 오타

if, else, function, return, foreach 같은 예약어를 잘못 입력하거나, 존재하지 않는 함수를 호출하면 Parse Error가 아닌 "Undefined function" Warning이 나타날 수 있다. 다만 예약어를 완전히 엉뚱하게 쓰면 Parse Error가 난다.

✗ 잘못된 코드
<?php
funciton getData() {  // function 오타
    return "data";
}
?>

✓ 올바른 코드
<?php
function getData() {  // 올바른 스펠링
    return "data";
}
?>

5. 잘못된 배열 또는 객체 문법

PHP 배열이나 객체 속성에 접근할 때 잘못된 괄호를 사용하거나, 연산자를 빠뜨리면 Parse Error가 발생한다.

✗ 잘못된 코드
<?php
$data = array('name' => 'John');
echo $data[name];  // 키를 따옴표로 감싸야 함
?>

✓ 올바른 코드
<?php
$data = array('name' => 'John');
echo $data['name'];  // 따옴표로 감싼 키
?>

효율적인 디버깅 방법

Step 1. 에러 메시지를 정확히 읽기

에러 메시지는 "Parse error: syntax error, unexpected TOKEN in /path/to/file.php on line N"의 형태다. N번 라인을 먼저 확인하되, 실제 문제는 그 몇 줄 위에 있을 수 있다는 점을 기억하자. "unexpected" 뒤의 키워드(if, echo, }, 등)가 중요한 단서가 된다.

Step 2. 에러 라인 위부터 거슬러 올라가기

에러가 40번 라인이라고 해도, 35~40번 라인의 따옴표, 괄호, 세미콜론을 모두 확인하자. 닫혀있지 않은 문자열이나 중괄호가 있는지 눈으로 쭉 따라가기.

Step 3. IDE의 문법 강조 기능 활용

VSCode, PHPStorm, Sublime Text 등 현대적인 에디터는 문법 오류를 실시간으로 표시한다. 빨간 줄이나 경고 표시가 있는 부분을 먼저 확인하자. IDE가 설치되지 않았다면 온라인 PHP Linter(예: php.net의 온라인 에디터나 PasteCode)에 코드를 붙여넣고 검사해볼 수 있다.

Step 4. 따옴표 짝 맞추기 (가장 빨리 해결됨)

파일을 열어서 Ctrl+H(또는 Cmd+H)로 찾기/바꾸기 기능을 써서, 열린 따옴표(")의 개수가 닫히는 따옴표(")의 개수와 같은지 세어보자. 또는 에디터의 괄호 자동 완성 기능을 믿고, 열린 괄호마다 IDE가 자동으로 닫는 괄호를 생성하도록 설정하자.

Step 5. 주석처리로 범위 좁히기

에러 라인 주변 10~15줄을 /* */ 또는 // 로 주석처리하고 다시 실행해보자. 에러가 사라지면 그 범위 안에 문제가 있다는 뜻이다. 그다음 조금씩 주석을 풀어가며 정확한 위치를 찾자.

실전 예제: 흔한 Parse Error 3가지 해결

예제 1. 다중 따옴표 문제

✗ 잘못된 코드
<?php
$message = "He said 'Hello to me;  // 문자열 안에 따옴표 있음 + 닫히지 않음
echo $message;
?>

✓ 올바른 코드 (방법 1: 이스케이프)
<?php
$message = "He said 'Hello to me";  // 작은따옴표를  로 이스케이프
echo $message;
?>

출력: He said 'Hello to me

✓ 올바른 코드 (방법 2: 따옴표 타입 바꾸기)
<?php
$message = 'He said 'Hello to me';  // 작은따옴표로 감싸고 내부 따옴표 이스케이프
echo $message;
?>

또는

<?php
$message = "He said 'Hello to me";  // 큰따옴표로 감싸면 작은따옴표는 자동 해석
echo $message;
?>

출력: He said 'Hello to me

예제 2. 중괄호 누락으로 인한 블록 오류

✗ 잘못된 코드
<?php
for ($i = 0; $i < 3; $i++) {
    echo $i;
echo "Done";  // for 블록이 닫혀있지 않은 상태에서 새 문장
?>

이 경우 에러는 "Done" 라인에서 나타날 수 있다. IDE의 들여쓰기 강조 기능을 보면 "Done" 라인의 들여쓰기가 맞지 않음을 알 수 있다.

✓ 올바른 코드
<?php
for ($i = 0; $i < 3; $i++) {
    echo $i;
}  // for 블록 닫기
echo "Done";
?>

출력: 012Done

예제 3. 배열 선언 문법 오류

✗ 잘못된 코드
<?php
$users = array(
    'name' => 'John',
    'age' => 30,
    'city' => 'Seoul'  // 마지막 요소 뒤에 쉼표
);  // 이건 사실 문제 아님, 하지만 다음 줄에 문법 오류가 있으면 헷갈림

echo users['name'];  // $ 기호 빠짐
?>

✓ 올바른 코드
<?php
$users = array(
    'name' => 'John',
    'age' => 30,
    'city' => 'Seoul'
);

echo $users['name'];  // $ 기호 추가
?>

출력: John

주의사항: Parse Error vs Warning vs Notice

에러 타입	심각도	실행 여부	예시
Parse Error	치명적	코드 실행 안 됨	따옴표 미닫음, 괄호 미닫음
Fatal Error	치명적	그 지점부터 중단	존재하지 않는 함수 호출, 클래스 인스턴스화 실패
Warning	중간	계속 실행	undefined variable, undefined function
Notice	경미	계속 실행	배열 키 누락, 변수 초기화 안 됨

개발 환경 설정 팁: 에러 표시 활성화

개발 중에는 모든 에러를 화면에 표시하도록 php.ini를 설정하면 문제를 빨리 발견할 수 있다.

// php.ini
error_reporting = E_ALL;
display_errors = On;
display_startup_errors = On;

또는 PHP 파일 맨 처음에 다음을 추가:

<?php
error_reporting(E_ALL);
ini_set('display_errors', '1');
// 여기서부터 코드 작성
?>

하지만 운영 서버에서는 display_errors를 Off로 설정하고, 로그 파일에만 저장하는 것이 보안상 안전하다.

정리: Parse Error를 빠르게 해결하기

Parse Error는 PHP의 문법 규칙을 어겼을 때 발생하는 가장 기본적인 에러지만, 초보 개발자들에게는 가장 당황스러운 에러기도 하다. 에러 메시지의 라인 번호가 정확한 위치를 가리키지 않을 수 있다는 점, 그리고 실제 문제는 그 몇 줄 위에 있을 수 있다는 점을 꼭 기억하자. 따옴표, 괄호, 세미콜론 같은 작은 실수가 모여서 어렵게 보이는 디버깅 문제를 만든다는 점을 잊지 말자.

이 글의 '자주 만나는 5가지 원인'과 '효율적인 디버깅 방법' 섹션을 북마크하고, 다음번에 Parse Error를 만났을 때 체계적으로 접근하면, 수 초 내에 문제를 찾을 수 있을 것이다. 처음엔 낭비처럼 느껴져도, 반복하다 보면 문법 감각이 자동으로 생기고, 코드를 작성할 때부터 실수를 미리 방지하는 습관이 들 것이다.