PHP Call to undefined function 에러 원인과 해결 방법 총정리

✅ PHP에서 "Call to undefined function" 에러가 발생하는 이유와 해결 방법

PHP 코드를 실행했는데 아래와 같은 에러가 뜨신 적 있나요?

Fatal error: Uncaught Error: Call to undefined function 함수이름() in /경로/파일.php:라인

이 에러는 PHP에서 굉장히 흔하게 발생하는 에러입니다.
이 글에서는 이 에러가 왜 발생하는지, 그리고 어떻게 해결할 수 있는지 알아보겠습니다!

---

🧨 에러의 원인

Call to undefined function 에러는 말 그대로
"지금 이 함수는 정의되지 않았는데 호출했어요!" 라는 뜻입니다.

즉, PHP가 해당 함수의 존재를 알지 못한 상태에서 호출하려고 하면 이 에러가 납니다.

---

❗ 자주 발생하는 상황 예시

1. 오타가 있는 경우

<?php
  echp("Hello World!"); // echo가 아니라 echp! → 오타

2. PHP 확장 함수가 설치되지 않은 경우

<?php
  echo mb_strlen("문자열"); // mbstring 확장 모듈이 없으면 에러 발생

3. 사용자 정의 함수가 선언되지 않은 경우

<?php
  greet(); // 함수 정의 없이 바로 호출

  function greet() {
    echo "안녕하세요!";
  }

4. include 파일이 불리지 않은 경우

<?php
  include 'functions.php'; // 경로 오류 등으로 파일 누락
  myCustomFunction(); // 정의되지 않은 함수로 인식됨

---

🛠 해결 방법

상황	해결책
함수 오타	함수명을 정확히 입력했는지 확인
PHP 내장 함수 미동작	해당 확장 모듈 설치 여부 확인 (예: mbstring, curl)
사용자 함수 선언 누락	함수가 선언된 이후에 호출되도록 순서 조정
외부 파일 누락	include/require 경로와 파일 존재 여부 확인

---

🔍 확장 모듈 확인 및 설치 방법

PHP에서 설치 확인

<?php
  phpinfo(); // 확장 모듈 목록 확인 가능

Ubuntu에서 설치 (예시)

sudo apt install php-mbstring
sudo apt install php-curl

※ 설치 후 Apache 또는 PHP-FPM 재시작 필요할 수 있음

---

✏️ 정리

• Call to undefined function 에러는 함수가 존재하지 않을 때 발생
• 오타, 선언 순서, 모듈 미설치, 파일 누락 등 원인은 다양
• 차근차근 체크리스트로 확인하면 쉽게 해결 가능!

---

📚 관련 글

• session_start() 에러 - headers already sent 해결법
• include 경로 문제로 인한 Failed opening required 에러

🧩 PHP 에러 트러블슈팅 시리즈 전체 보기

---

태그: #PHP, #PHP에러, #CallToUndefinedFunction, #PHP오류해결, #백엔드개발, #php에러디버깅, #실무팁, #PHP개발자, #개발자블로그, #웹개발