Blog

🚨 도입부

프로그래머라면 한 번쯤 ‘Warning: Division by zero’라는 에러 메시지에 직면한 적이 있을 것입니다. 이 에러는 특히 예상치 못한 순간에 나타나 우리의 코드를 중단시키고, 이를 해결하기 위해서는 원인을 정확히 파악해야만 합니다. 이 글에서는 PHP에서 흔히 발생하는 이 에러에 대해 자세히 알아보고, 실무에서 이를 해결하는 방법에 대해 단계별로 설명합니다.

많은 개발자들이 이 에러를 접하게 되는 시나리오로는, 사용자 입력을 처리할 때 0을 포함한 값을 나누는 경우, 외부 API 호출 결과가 0일 때, 혹은 데이터베이스에서 잘못된 데이터가 반환될 경우가 있습니다. 이러한 상황에서 코드가 제대로 작동하지 않으며, 심지어는 전체 애플리케이션의 성능에 악영향을 미칠 수도 있습니다.

이 글을 통해 얻을 수 있는 것은 이 에러의 원인 파악부터 해결책까지의 종합적인 이해입니다. 또한, 에러를 해결하는 데 걸리는 시간은 약 30분에서 1시간 정도로 예상됩니다. 난이도는 초급에서 중급 수준이며, PHP를 다루는 모든 개발자에게 유용할 것입니다.

🔍 에러 메시지 상세 분석

PHP에서 ‘Warning: Division by zero’라는 에러 메시지는 정확히 말하자면 나누려는 수식의 분모가 0일 때 발생합니다. 이 에러는 주로 수학적 연산을 수행하는 코드에서 발생하며, PHP가 이러한 잠재적 오류를 방지하기 위해 경고를 띄우는 것입니다.

다양한 상황에서 이 에러가 발생할 수 있습니다. 첫째, 사용자 입력을 직접적으로 수식에 넣는 경우입니다. 둘째, 외부 API에서 반환된 값이 0일 경우입니다. 셋째, 데이터베이스에서 잘못된 값이 반환될 때입니다. 넷째, 파일이나 네트워크 스트림에서 데이터를 읽어올 때 0이 포함된 경우입니다. 다섯째, 배열이나 객체의 속성에서 0을 가져오는 경우입니다.

에러 메시지는 그 자체로 꽤 직관적입니다. ‘Warning’이라는 단어는 PHP의 오류 수준에서 비교적 낮은 심각도를 나타냅니다. ‘Division by zero’는 바로 문제를 설명하는데, 이는 수학적으로도 정의되지 않는 연산입니다. 초보자라면 이 에러 메시지를 차분히 읽고, 코드에서 나누기 연산이 어디에 있는지, 그리고 그 연산의 분모가 어떤 값인지 확인하는 것이 첫 번째입니다.

비슷한 에러로는 ‘Warning: Invalid argument supplied for foreach()’나 ‘Notice: Undefined index’ 등이 있습니다. 이들은 모두 PHP에서 발생할 수 있는 경고이며, 코드의 논리적 오류를 나타낼 수 있습니다.

🧐 발생 원인 분석

이 에러의 주요 원인은 다음과 같습니다. 첫 번째로, 수식에서 나누는 값이 0이 되는 경우입니다. 이는 사용자 입력을 제대로 검증하지 않아서 발생할 수 있습니다. 예를 들어 사용자가 0을 입력해도 이를 걸러내지 않고, 계산에 바로 사용한다면 이 에러가 발생합니다.

$userInput = 0; // 사용자 입력으로 가정
$result = 10 / $userInput; // 에러 발생: Division by zero

두 번째로, 외부 API나 데이터 소스에서 0을 반환하는 경우입니다. 예를 들어, 어떤 API가 특정 조건에서 0을 반환할 수 있지만, 이 값에 대한 처리 없이 연산에 사용한다면 문제가 됩니다.

$apiResponseValue = 0; // 외부 API의 응답 값
$result = 100 / $apiResponseValue; // 에러 발생

세 번째는 데이터베이스에서 잘못된 데이터를 가져오는 경우입니다. 예를 들어, 특정 필드가 0으로 저장되어 있을 때 이를 나누기 연산에 사용하면 에러가 발생합니다.

$dbValue = 0; // 데이터베이스에서 가져온 값
$result = 50 / $dbValue; // 에러 발생

네 번째 원인은 수식에서 정수형이 아닌 변수를 사용하여 0이 되어버리는 경우입니다. 예를 들어, 문자열이나 불리언을 숫자로 변환할 때 0으로 변환될 수 있습니다.

$stringValue = ""; // 빈 문자열
$result = 20 / (int)$stringValue; // 에러 발생

다섯 번째로, 변수의 초기화 없이 사용하여 기본값이 0이 되는 경우입니다.

$uninitializedVar;
$result = 30 / $uninitializedVar; // 에러 발생

이러한 원인들은 주로 코드 설계와 데이터 처리에서 발생합니다. 사용자의 입력을 철저히 검증하지 않거나, 외부 데이터 소스를 신뢰하여 그대로 사용하는 경우에 발생할 수 있습니다. 이를 방지하기 위해서는 철저한 입력 검증과 예외 처리가 필요합니다.

✅ 해결 방법

즉시 해결 방법으로는 가장 먼저, 나누기 연산을 수행하기 전에 분모가 0이 아닌지 확인하는 것입니다. 간단한 조건문을 사용하여 이를 확인할 수 있습니다.

$divisor = 0;
if ($divisor != 0) {
    $result = 100 / $divisor;
} else {
    echo "Cannot divide by zero.";
}

두 번째로, 사용자 입력을 검증하여 0을 포함하지 않도록 필터링하는 것이 있습니다.

$userInput = filter_input(INPUT_GET, 'value', FILTER_VALIDATE_FLOAT);
if ($userInput !== false && $userInput != 0) {
    $result = 100 / $userInput;
} else {
    echo "Invalid input or division by zero.";
}

세 번째 방법은 외부 API 호출 결과를 검증하는 것입니다. API의 응답이 0일 때의 처리를 추가합니다.

$apiResponseValue = 0; // 외부 API의 응답 값
if ($apiResponseValue != 0) {
    $result = 100 / $apiResponseValue;
} else {
    echo "API returned zero, cannot divide.";
}

표준 해결 방법으로는 예외 처리를 추가하여 나누기 연산에 문제가 발생할 경우 적절한 예외를 던지고, 이를 처리하는 것입니다.

try {
    $result = divideNumbers(100, 0);
} catch (Exception $e) {
    echo "Caught exception: ",  $e->getMessage(), "\n";
}

function divideNumbers($numerator, $denominator) {
    if ($denominator == 0) {
        throw new Exception('Division by zero.');
    }
    return $numerator / $denominator;
}

고급 해결 방법으로는 연산이 필요한 경우에만 수행하도록 로직을 재설계하는 것입니다. 예를 들어, 데이터베이스에서 값을 가져와야만 한다면, 그 값을 검증한 후 사용하는 것입니다.

$dbValue = 0; // 데이터베이스에서 가져온 값
if ($dbValue != 0) {
    $result = 100 / $dbValue;
} else {
    echo "Database value is zero, cannot divide.";
}

이러한 방법들을 통해 에러를 해결한 후, 결과가 기대하는 대로 출력되는지 확인합니다. 예를 들어, ‘Cannot divide by zero.’ 메시지가 표시되지 않는지, 계산 결과가 정확한지 점검합니다.

🛡️ 예방법 및 베스트 프랙티스

이 에러의 재발을 방지하기 위해서는 몇 가지 베스트 프랙티스를 따르는 것이 중요합니다. 첫째, 모든 사용자 입력을 철저히 검증하고, 가능한 한 0을 포함하지 않도록 합니다. 둘째, 외부 API나 데이터베이스에서 값을 가져올 때는 항상 그 값을 검증하고, 필요한 경우 기본값을 설정합니다.

코딩 시 주의사항으로는 항상 변수를 초기화하고, 예상치 못한 값이 나올 수 있는 부분에서는 예외 처리를 추가하는 것입니다. 또한, PHPStan이나 Psalm과 같은 정적 분석 도구를 사용하여 코드에서 발생할 수 있는 잠재적 오류를 사전에 탐지하는 것도 좋은 방법입니다.

팀 개발 시에는 이러한 점들을 코드 리뷰 체크리스트에 포함하고, 코드 작성 시 늘 염두에 두어야 합니다. 또한, 코드를 문서화할 때는 각 함수가 어떤 입력을 기대하며, 어떤 경우에 예외를 던질 수 있는지를 명확히 기술합니다.

🎯 마무리 및 추가 팁

이 글에서 다룬 핵심 내용은 다음과 같습니다. 첫째, ‘Warning: Division by zero’ 에러는 나누기 연산의 분모가 0일 때 발생합니다. 둘째, 이를 방지하기 위해서는 분모가 0이 아닌지 확인하는 검증 절차가 필요합니다. 셋째, 고급 예외 처리와 코드 리팩토링을 통해 더욱 견고한 코드를 작성할 수 있습니다.

비슷한 에러에 대한 더 많은 정보를 얻고 싶다면 PHP 공식 문서나 관련 커뮤니티 포럼을 참조하세요. 또한, PHP의 예외 처리나 연산 관련 함수들에 대한 심화 학습을 통해 더 나은 코드를 작성할 수 있습니다.

마지막으로, 이 에러를 해결하는 데에 어려움이 있다면 포기하지 마세요. 모든 개발자는 같은 과정을 겪으며 성장합니다. 여러분도 충분히 해결할 수 있습니다!