PHP 개발하다 보면 갑자기 "Warning: Call to undefined function" 에러가 튀어나온다. 분명히 함수를 만들었는데 왜 못 찾을까? 아니면 라이브러리를 설치했는데 함수가 없다고 할까? 대부분의 개발자들은 이 에러 메시지를 보고 당황해서 함수명을 다시 확인하거나 무작정 구글링만 한다. 하지만 정확한 원인을 모르면 계속 같은 실수를 반복한다.

이번에는 "Call to undefined function" 에러가 정확히 뭔지, 왜 발생하는지, 어떻게 해결하는지 실전 사례와 함께 완벽하게 정리해주겠다.

PHP에서 "Call to undefined function" 에러는 호출하려는 함수가 존재하지 않거나, 접근 불가능한 스코프에 있다는 뜻이다. 크게 네 가지 원인으로 나뉜다:

가장 흔한 원인이다. 함수를 다른 파일에서 정의했는데, 현재 파일에서 그 파일을 로드하지 않으면 에러가 난다.

✗ 잘못된 코드

<?php
// index.php
echo get_user_name(1); // 에러: Call to undefined function get_user_name()
?>

✓ 올바른 코드

<?php
// index.php
require_once 'functions/user.php'; // 함수 파일 먼저 로드
echo get_user_name(1); // 정상 동작
?>

결과: 함수가 정의된 파일을 먼저 로드해야 호출 가능하다. 특히 프로젝트 초기에 autoloader나 config 파일에서 필요한 함수 파일들을 모두 로드해두면 나중에 일일이 include할 필요가 없다.

코드를 입력할 때 함수명을 잘못 치는 경우다. PHP는 대소문자 구분이 없지만, 변수명은 구분한다.

✗ 잘못된 코드

<?php
// 함수 정의
function formatDate($date) {
    return date('Y-m-d', strtotime($date));
}

// 잘못된 호출 - 함수명 오타
echo format_date('2024-01-15'); // Call to undefined function format_date()
?>

✓ 올바른 코드

<?php
// 함수 정의
function formatDate($date) {
    return date('Y-m-d', strtotime($date));
}

// 정확한 함수명으로 호출
echo formatDate('2024-01-15'); // "2024-01-15"
?>

결과: PHP IDE/에디터에서 자동완성을 활용하거나, 함수 정의 부분과 호출 부분의 함수명을 정확히 대조하자.

현대적인 PHP 프로젝트는 네임스페이스를 사용한다. 다른 네임스페이스의 함수를 호출하려면 use 문으로 import하거나 전체 경로를 지정해야 한다.

✗ 잘못된 코드

<?php
// app/Helpers/DateHelper.php
namespace AppHelpers;

function formatDate($date) {
    return date('Y-m-d', strtotime($date));
}

// index.php (네임스페이스 없음)
echo formatDate('2024-01-15'); // Call to undefined function formatDate()
?>

✓ 올바른 코드 - 방법 1: use로 import

<?php
// index.php
use AppHelpersformatDate; // 또는 use function AppHelpersformatDate;

echo formatDate('2024-01-15'); // "2024-01-15"
?>

✓ 올바른 코드 - 방법 2: 전체 경로(FQDN) 사용

<?php
// index.php
echo AppHelpersformatDate('2024-01-15'); // "2024-01-15"
?>

결과: 네임스페이스를 사용하는 프로젝트에서는 반드시 use 문으로 import하거나 \ (백슬래시) 전체 경로를 붙여야 한다. Composer의 autoloader를 쓰면 자동으로 네임스페이스를 해석해준다.

if/else 블록 안에서만 함수를 정의하면, 그 조건을 만족하지 않을 때 함수를 호출할 수 없다.

✗ 잘못된 코드

<?php
$debug = false;

// 조건부로만 함수 정의
if ($debug) {
    function debugLog($msg) {
        echo "[DEBUG] " . $msg;
    }
}

// $debug가 false이므로 함수가 정의되지 않음
debugLog('This is a test'); // Call to undefined function debugLog()
?>

✓ 올바른 코드 - 방법 1: 항상 정의하고 내부에서 조건 체크

<?php
$debug = false;

// 함수는 항상 정의
function debugLog($msg) {
    global $debug;
    if ($debug) {
        echo "[DEBUG] " . $msg;
    }
}

debugLog('This is a test'); // 함수는 존재하지만 조건에 따라 출력됨
?>

✓ 올바른 코드 - 방법 2: 함수_exists() 체크 후 호출

<?php
$debug = false;

if ($debug) {
    function debugLog($msg) {
        echo "[DEBUG] " . $msg;
    }
}

// 함수 존재 여부 확인 후 호출
if (function_exists('debugLog')) {
    debugLog('This is a test');
} else {
    echo 'Function not available';
}
?>

결과: 함수는 가능하면 항상 정의하고, 조건에 따른 동작은 함수 내부에서 처리하는 것이 안전하다.

많은 개발자가 Composer로 라이브러리를 설치했는데도 함수를 못 찾는 경우가 있다. 이는 autoloader를 로드하지 않았거나 네임스페이스 경로가 잘못된 것이다.

✗ 잘못된 코드

<?php
// autoloader 로드 안 함
// require 'vendor/autoload.php'; (주석처리됨)

use CarbonCarbon; // Carbon 라이브러리
echo Carbon::now(); // Call to undefined class CarbonCarbon
?>

✓ 올바른 코드

<?php
// 먼저 Composer autoloader 로드 (필수!)
require 'vendor/autoload.php';

use CarbonCarbon;
echo Carbon::now(); // 정상 동작
?>

변수에 함수명을 저장해서 동적으로 호출할 때, 함수 이름을 잘못 입력하거나 존재하지 않는 함수를 호출하는 경우가 있다.

✗ 잘못된 코드

<?php
$functionName = 'getUserData'; // 실제 함수명은 get_user_data

$functionName(123); // Call to undefined function getUserData()
?>

✓ 올바른 코드

<?php
// 방법 1: 함수 존재 여부 먼저 확인
$functionName = 'get_user_data';

if (function_exists($functionName)) {
    $functionName(123);
} else {
    echo "Function $functionName does not exist";
}

// 방법 2: call_user_func 사용 (더 안전)
$result = call_user_func('get_user_data', 123);
?>

✗ 흔한 실수

• include_once와 require_once를 혼동 - 한 번만 로드하는지 확인
• 상대 경로와 절대 경로 혼동 - __DIR__ 상수로 항상 절대 경로 사용
• 네임스페이스 선언 후 use 문을 안 씀 - PSR-4 규칙 준수
• 함수와 메소드 혼동 - 클래스 메소드는 $obj->method() 또는 ClassName::method() 형태

✓ 디버깅 팁

<?php
// 1. 함수 존재 여부 확인
if (!function_exists('my_function')) {
    die('my_function does not exist');
}

// 2. 로드된 파일 목록 확인
echo '<pre>';
print_r(get_included_files());
echo '</pre>';

// 3. 정의된 모든 함수 목록 출력
echo '<pre>';
print_r(get_defined_functions());
echo '</pre>';

// 4. 함수가 정의된 파일 확인
$reflection = new ReflectionFunction('my_function');
echo $reflection->getFileName(); // 함수 정의 파일 경로
?>

"Call to undefined function" 에러는 단순한 에러처럼 보이지만, 실은 파일 로드 순서, 네임스페이스 이해, 함수명 정확성 세 가지를 한번에 점검해야 한다. 특히 팀 프로젝트나 레거시 코드를 다룰 때 이 에러를 자주 마주친다.

작은 함수 하나를 추가할 때마다 "이 함수를 어디에 정의할까?", "네임스페이스는 뭘로 할까?", "이 함수를 쓸 파일에서 import했나?" 세 가지만 확인하는 습관이 모여서 버그 없는 코드를 만든다. 이 글의 원인별 해결책을 참고해 자신의 프로젝트에 맞는 패턴을 정하고, 그 규칙을 일관되게 따르면 "Call to undefined function" 에러는 더 이상 마주치지 않을 것이다.