PHP에서 날짜를 다룰 때 strtotime() 함수는 거의 필수다. 그런데 코드를 돌리다 보면 갑자기 경고 메시지가 떨어진다. "Warning: strtotime(): Empty string is not a valid time string". 대부분의 개발자들은 이 경고를 무시하거나 @strtotime()으로 조용히 억눌러버린다. 하지만 왜 이런 경고가 나는지, 어디서 비어있는 문자열이 들어오는지 정확히 파악하지 못하면 나중에 심각한 버그로 발전한다.

 

strtotime()이 거부하는 빈 문자열의 정체

strtotime()은 PHP 5.1.0부터 엄격해졌다. 빈 문자열('')을 받으면 false를 반환하면서 경고를 출력한다. PHP 8.0 이상에서는 더욱 엄격해져서 TypeError가 발생하기도 한다. 문제는 개발자가 입력값의 유무를 제대로 검사하지 않는다는 것이다.

예를 들어 사용자가 선택 입력 폼(optional field)을 비워두거나, API에서 null 값이 오거나, 데이터베이스 컬럼이 NULL인 경우에 발생한다. 이런 상황에서 strtotime()을 바로 호출하면 경고가 터진다.

 

실제 오류 상황과 해결책
상황 1: 사용자 입력 필드가 비어있을 때

✗ 잘못된 코드

<?php
$user_date = $_POST['event_date'] ?? ''; // 사용자가 입력 안 함
$timestamp = strtotime($user_date); // Warning 발생!
echo date('Y-m-d', $timestamp);
?>

사용자가 폼을 비워두면 $user_date는 빈 문자열이 되고, strtotime('')을 호출하면서 경고가 발생한다.

✓ 올바른 코드

<?php
$user_date = $_POST['event_date'] ?? '';

// 방법 1: 빈 문자열 체크
if (!empty($user_date)) {
    $timestamp = strtotime($user_date);
    echo date('Y-m-d', $timestamp);
} else {
    echo '날짜를 입력해주세요';
}
?>

또는 더 명시적으로:

<?php
$user_date = $_POST['event_date'] ?? '';

// 방법 2: trim() 으로 공백도 제거
if (trim($user_date) !== '') {
    $timestamp = strtotime($user_date);
    if ($timestamp === false) {
        echo '유효하지 않은 날짜 형식입니다';
    } else {
        echo date('Y-m-d', $timestamp);
    }
} else {
    echo '날짜를 입력해주세요';
}
?>
상황 2: 데이터베이스에서 NULL 값이 올 때

✗ 잘못된 코드

<?php
$stmt = $pdo->prepare('SELECT event_date FROM events WHERE id = ?');
$stmt->execute([$id]);
$row = $stmt->fetch(PDO::FETCH_ASSOC);

$timestamp = strtotime($row['event_date']); // NULL이면 Warning!
echo date('Y-m-d', $timestamp);
?>

데이터베이스의 event_date가 NULL이면 $row['event_date']는 null이 되고, strtotime(null)은 경고를 낸다. PHP 8.0 이상에서는 TypeError 발생.

✓ 올바른 코드

<?php
$stmt = $pdo->prepare('SELECT event_date FROM events WHERE id = ?');
$stmt->execute([$id]);
$row = $stmt->fetch(PDO::FETCH_ASSOC);

// NULL 체크와 타입 변환
if ($row['event_date'] !== null) {
    $timestamp = strtotime($row['event_date']);
    echo date('Y-m-d', $timestamp);
} else {
    echo '예정된 날짜가 없습니다';
}
?>
상황 3: 여러 소스에서 오는 값을 통합 처리

✗ 잘못된 코드

<?php
function format_date($date_input) {
    // 사용자 입력, API 응답, DB 값 등이 섞여서 옴
    return date('Y-m-d', strtotime($date_input)); // 경고 위험!
}

echo format_date(''); // Warning!
echo format_date(null); // Warning!
?>

✓ 올바른 코드

<?php
function format_date($date_input, $default = null) {
    // 타입 강제 변환
    $date_input = (string) $date_input;
    
    // 빈 문자열 체크
    if (empty(trim($date_input))) {
        return $default ?? '미정';
    }
    
    // strtotime() 결과 검증
    $timestamp = strtotime($date_input);
    if ($timestamp === false) {
        return '유효하지 않은 날짜';
    }
    
    return date('Y-m-d', $timestamp);
}

echo format_date('');
// 결과: 미정

echo format_date(null);
// 결과: 미정

echo format_date('2024-12-25');
// 결과: 2024-12-25

echo format_date('invalid-date');
// 결과: 유효하지 않은 날짜
?>
상황 4: API 응답이 예상과 다를 때

✗ 잘못된 코드

<?php
$response = json_decode($api_response, true);
$created_at = $response['created_at'] ?? ''; // 키 없으면 빈 문자열

$timestamp = strtotime($created_at); // Warning 가능!
echo date('Y-m-d H:i:s', $timestamp);
?>

✓ 올바른 코드

<?php
$response = json_decode($api_response, true);

// null 체크로 시작
if (!empty($response['created_at'])) {
    $timestamp = strtotime($response['created_at']);
    if ($timestamp !== false) {
        echo date('Y-m-d H:i:s', $timestamp);
    } else {
        echo '날짜 형식이 잘못되었습니다';
        // 로그 추가
        error_log('Invalid date from API: ' . $response['created_at']);
    }
} else {
    // API에서 expected 필드가 없는 경우 처리
    echo 'API 응답에 created_at이 없습니다';
    error_log('Missing created_at in API response: ' . json_encode($response));
}
?>

 

주의사항과 흔한 실수

@ 연산자로 경고 무시하면 안 되는 이유

많은 개발자들이 @strtotime($date)로 경고를 억눌러버린다. 하지만 이렇게 하면 오류 추적이 어려워진다. strtotime()이 false를 반환했을 때 명시적으로 처리해야 버그를 빨리 찾을 수 있다.

PHP 버전에 따른 동작 차이

PHP 7.1 이전: strtotime('')은 경고만 내고 false 반환
PHP 7.1~7.4: 경고 + false 반환
PHP 8.0+: TypeError 발생 가능

PHP 8.0 이상을 사용한다면 아예 TypeError가 나므로, empty() 체크가 더욱 필수다.

trim()을 꼭 써야 하는 이유

사용자가 스페이스만 입력하면 empty()는 true를 반환하지만, 경우에 따라 공백도 strtotime()에 넘어갈 수 있다. trim()으로 양쪽 공백을 제거한 후 체크하는 것이 안전하다.

strtotime() 반환값 검증 필수

<?php
// strtotime()은 false를 반환할 수 있음
$timestamp = strtotime('2024-13-45'); // 잘못된 날짜
if ($timestamp === false) {
    echo '잘못된 날짜';
} else {
    echo date('Y-m-d', $timestamp);
}
?>

 

실무 패턴: 헬퍼 함수 만들기

프로젝트 전체에서 반복되는 날짜 파싱을 위해 헬퍼 함수를 만들어두는 것이 좋다.

<?php
/**
 * 안전한 날짜 파싱 헬퍼
 * @param mixed $date 파싱할 날짜 (string, null, 기타)
 * @param string|null $default 파싱 실패 시 기본값
 * @return int|string 타임스탐프 또는 기본값
 */
function safe_strtotime($date, $default = null) {
    // null, 빈 문자열, 공백 체크
    if ($date === null || $date === '' || (is_string($date) && trim($date) === '')) {
        return $default;
    }
    
    // 문자열로 강제 변환
    $date = (string) $date;
    
    // strtotime 실행
    $timestamp = strtotime($date);
    
    // false면 기본값 반환
    return $timestamp !== false ? $timestamp : $default;
}

// 사용 예시
echo date('Y-m-d', safe_strtotime('2024-12-25')); // 2024-12-25
echo safe_strtotime(''); // null
echo safe_strtotime(null, 'N/A'); // N/A
echo safe_strtotime('invalid', 0); // 0
?>

 

정리: 세 가지 필수 체크

strtotime() 경고를 완벽하게 제거하려면 항상 세 가지를 순서대로 확인해야 한다.

단계 체크 항목 코드 예시
1단계 null 또는 빈 문자열 확인 if (!empty(trim($date)))
2단계 strtotime() 호출 후 false 체크 if ($timestamp !== false)
3단계 date() 함수로 변환 date('Y-m-d', $timestamp)

strtotime()은 PHP에서 날짜를 다루는 가장 편리한 함수지만, 입력값이 보장되지 않으면 경고와 버그의 원인이 된다. 작은 주의가 모여서 튼튼한 코드를 만든다는 점을 기억하자. 이 글의 safe_strtotime() 헬퍼 함수를 프로젝트에 복사해 넣고, 모든 strtotime() 호출을 이 함수로 감싸면 경고와 오류로부터 완전히 벗어날 수 있을 것이다.