코딩스쿨

PHP Exception

PHP 예외 참조: 예외 처리와 활용

*PHP 예외(Exception)**는 코드 실행 중 발생할 수 있는 예기치 않은 상황을 처리하는 강력한 메커니즘입니다. 예외를 적절히 관리하면 애플리케이션의 안정성과 유지보수성을 크게 향상시킬 수 있습니다. 이 가이드는 PHP에서 예외를 이해하고, 처리하며, 커스텀 예외를 생성하는 방법 등을 상세히 설명합니다.

PHP 예외의 기본 이해

예외란?

예외는 코드 실행 중 발생할 수 있는 비정상적인 상황을 나타냅니다. 예외는 일반적인 오류와 달리, 프로그램의 흐름을 제어하며, 예외가 발생한 지점에서 벗어나 적절한 예외 처리기로 이동합니다.

예외와 오류의 차이

오류(Error): 주로 PHP 엔진 자체에서 발생하며, 복구가 불가능한 심각한 문제를 나타냅니다. 예를 들어, 구문 오류나 메모리 부족 등이 있습니다.
예외(Exception): 개발자가 예상할 수 있는 비정상적인 상황을 처리하기 위해 사용됩니다. 예를 들어, 파일 열기 실패, 잘못된 사용자 입력 등이 있습니다.

1. 예외 처리 기본

PHP에서 예외를 처리하는 기본 구조는 try-catch 블록을 사용하는 것입니다.

예시: 기본적인 예외 처리

<?php
try {
    // 예외를 발생시킬 수 있는 코드
    if (!file_exists("example.txt")) {
        throw new Exception("파일이 존재하지 않습니다.");
    }

    // 파일을 열기
    $file = fopen("example.txt", "r");
    // 파일 작업 수행
    fclose($file);

} catch (Exception $e) {
    // 예외가 발생했을 때 실행되는 코드
    echo "예외 발생: " . $e->getMessage();
}
?>

설명:

try 블록 내에서 예외를 발생시킬 수 있는 코드를 작성합니다.
throw 키워드를 사용하여 예외를 던집니다.
catch 블록에서 예외를 잡아 처리합니다. $e는 발생한 예외 객체를 참조합니다.

2. 예외 클래스

PHP는 Exception 클래스를 기본으로 하며, 다양한 내장 예외 클래스와 사용자 정의 예외 클래스를 생성할 수 있습니다.

2.1 기본 예외 클래스

Exception: 모든 예외의 기본 클래스입니다.
ErrorException: PHP 오류를 예외로 변환할 때 사용됩니다.
RuntimeException, LogicException 등: 다양한 상황에 맞는 내장 예외 클래스가 제공됩니다.

2.2 사용자 정의 예외 클래스

사용자 정의 예외 클래스를 생성하여 보다 구체적인 예외 처리를 할 수 있습니다.

예시: 사용자 정의 예외 클래스 생성

<?php
class FileNotFoundException extends Exception {
    public function __construct($filename, $code = 0, Exception $previous = null) {
        $message = "파일을 찾을 수 없습니다: " . $filename;
        parent::__construct($message, $code, $previous);
    }
}
?>

사용 예시:

<?php
try {
    $filename = "nonexistentfile.txt";
    if (!file_exists($filename)) {
        throw new FileNotFoundException($filename);
    }

    $file = fopen($filename, "r");
    fclose($file);

} catch (FileNotFoundException $e) {
    echo "사용자 정의 예외 처리: " . $e->getMessage();
} catch (Exception $e) {
    echo "일반 예외 처리: " . $e->getMessage();
}
?>

설명:

FileNotFoundException 클래스는 Exception을 상속받아 특정 상황에 맞는 예외를 정의합니다.
try 블록에서 해당 예외를 던지고, catch 블록에서 이를 처리합니다.

3. 다중 예외 처리

PHP는 여러 catch 블록을 사용하여 다양한 예외를 개별적으로 처리할 수 있습니다.

예시: 다중 예외 처리

<?php
class FileNotFoundException extends Exception {}
class FileReadException extends Exception {}

try {
    $filename = "example.txt";

    if (!file_exists($filename)) {
        throw new FileNotFoundException($filename);
    }

    $file = fopen($filename, "r");
    if (!$file) {
        throw new FileReadException("파일을 여는 데 실패했습니다: " . $filename);
    }

    // 파일 작업 수행
    fclose($file);

} catch (FileNotFoundException $e) {
    echo "파일 없음 예외: " . $e->getMessage();
} catch (FileReadException $e) {
    echo "파일 읽기 예외: " . $e->getMessage();
} catch (Exception $e) {
    echo "일반 예외: " . $e->getMessage();
}
?>

설명:

특정 예외를 먼저 catch 블록에서 처리하고, 그 외의 예외는 일반 예외로 처리합니다.
예외의 구체성에 따라 catch 블록의 순서를 조정하는 것이 중요합니다.

4. 예외 전파

예외는 throw된 지점에서 가까운 catch 블록으로 전파됩니다. 예외를 잡지 않으면, 스크립트 실행이 중단됩니다.

예시: 예외 전파

<?php
function readFileContent($filename) {
    if (!file_exists($filename)) {
        throw new Exception("파일이 존재하지 않습니다: " . $filename);
    }

    $content = file_get_contents($filename);
    return $content;
}

try {
    echo readFileContent("missingfile.txt");
} catch (Exception $e) {
    echo "예외 처리: " . $e->getMessage();
}
?>

설명:

readFileContent 함수에서 예외를 던지고, 이를 호출한 곳에서 catch 블록으로 예외가 전파됩니다.

5. 예외의 메서드

Exception 클래스는 예외에 대한 상세 정보를 제공하는 다양한 메서드를 포함하고 있습니다.

getMessage(): 예외 메시지를 반환합니다.
getCode(): 예외 코드를 반환합니다.
getFile(): 예외가 발생한 파일명을 반환합니다.
getLine(): 예외가 발생한 라인 번호를 반환합니다.
getTrace(): 예외 발생 시의 스택 추적을 배열로 반환합니다.
getTraceAsString(): 예외 발생 시의 스택 추적을 문자열로 반환합니다.

예시: 예외 메서드 사용

<?php
try {
    throw new Exception("예외 메시지", 100);
} catch (Exception $e) {
    echo "메시지: " . $e->getMessage() . "<br>";
    echo "코드: " . $e->getCode() . "<br>";
    echo "파일: " . $e->getFile() . "<br>";
    echo "라인: " . $e->getLine() . "<br>";
    echo "스택 추적: " . $e->getTraceAsString() . "<br>";
}
?>

출력 예:

메시지: 예외 메시지
코드: 100
파일: /path/to/file.php
라인: 3
스택 추적: #0 /path/to/file.php(3): Exception->__construct('예외 메시지', 100)
#1 {main}

6. 커스텀 예외 클래스

커스텀 예외 클래스를 만들어 특정 상황에 맞는 예외를 정의할 수 있습니다. 이는 예외 처리의 유연성을 높이고, 코드의 가독성을 향상시킵니다.

6.1 커스텀 예외 클래스 생성

예시: 커스텀 예외 클래스

<?php
class DatabaseException extends Exception {
    private $query;

    public function __construct($message, $query, $code = 0, Exception $previous = null) {
        $this->query = $query;
        parent::__construct($message, $code, $previous);
    }

    public function getQuery() {
        return $this->query;
    }
}
?>

사용 예시:

<?php
class DatabaseException extends Exception {
    private $query;

    public function __construct($message, $query, $code = 0, Exception $previous = null) {
        $this->query = $query;
        parent::__construct($message, $code, $previous);
    }

    public function getQuery() {
        return $this->query;
    }
}

function executeQuery($query) {
    // 데이터베이스 연결 및 쿼리 실행 시도
    $success = false; // 예시를 위한 실패 시나리오

    if (!$success) {
        throw new DatabaseException("쿼리 실행 실패", $query);
    }

    return "쿼리 결과";
}

try {
    $result = executeQuery("SELECT * FROM users");
    echo $result;
} catch (DatabaseException $e) {
    echo "데이터베이스 예외: " . $e->getMessage() . "<br>";
    echo "실행된 쿼리: " . $e->getQuery();
} catch (Exception $e) {
    echo "일반 예외: " . $e->getMessage();
}
?>

설명:

DatabaseException 클래스는 Exception을 상속받아 추가적인 정보를 저장합니다.
예외 처리 시, 커스텀 예외의 추가 정보를 활용할 수 있습니다.

7. 예외와 오류 핸들링 통합

PHP에서는 오류를 예외로 변환하여 처리할 수 있습니다. 이는 오류와 예외를 일관되게 관리할 수 있게 해줍니다.

7.1 `ErrorException` 사용

ErrorException 클래스를 사용하여 PHP 오류를 예외로 변환할 수 있습니다.

예시: 오류를 예외로 변환

<?php
// 사용자 정의 오류 핸들러 설정
set_error_handler(function($severity, $message, $file, $line) {
    throw new ErrorException($message, 0, $severity, $file, $line);
});

try {
    // 경고를 발생시키는 코드
    echo $undefinedVariable; // Notice: Undefined variable
} catch (ErrorException $e) {
    echo "에러 예외 처리: " . $e->getMessage();
}
?>

설명:

set_error_handler를 사용하여 PHP 오류를 예외로 던지도록 설정합니다.
이렇게 하면 모든 PHP 오류를 try-catch 블록으로 처리할 수 있습니다.

8. 예외 처리 Best Practices

효과적인 예외 처리를 위해 다음과 같은 최선의 실천 방법을 따르는 것이 좋습니다.

8.1 구체적인 예외 클래스 사용

가능한 한 구체적인 예외 클래스를 사용하여 예외를 구분하고, 적절한 처리를 할 수 있도록 합니다.

<?php
try {
    // 코드
} catch (FileNotFoundException $e) {
    // 파일 없음 예외 처리
} catch (DatabaseException $e) {
    // 데이터베이스 예외 처리
} catch (Exception $e) {
    // 일반 예외 처리
}
?>

8.2 예외를 너무 자주 던지지 않기

예외는 비정상적인 상황에서만 사용하고, 정상적인 흐름 제어에는 사용하지 않습니다. 과도한 예외 사용은 성능 저하와 코드 복잡성을 유발할 수 있습니다.

8.3 예외 메시지에 민감한 정보 포함 금지

예외 메시지에 데이터베이스 쿼리, 파일 경로 등 민감한 정보를 포함하지 않도록 주의합니다. 이는 보안 취약점으로 이어질 수 있습니다.

<?php
try {
    // 민감한 정보 포함 예외
    throw new Exception("데이터베이스 연결 오류: " . $dbConnectionDetails);
} catch (Exception $e) {
    // 사용자에게는 일반적인 메시지만 표시
    echo "서버 오류가 발생했습니다.";
    // 상세 정보는 로그에 기록
    error_log($e->getMessage());
}
?>

8.4 예외를 로깅하고 모니터링하기

예외 발생 시, 상세 정보를 로그에 기록하고, 이를 모니터링하여 신속하게 문제를 파악하고 해결할 수 있도록 합니다.

<?php
try {
    // 코드
} catch (Exception $e) {
    // 로그에 예외 정보 기록
    error_log("예외 발생: " . $e->getMessage() . " 파일: " . $e->getFile() . " 라인: " . $e->getLine());
    // 사용자에게는 일반적인 메시지 표시
    echo "서버 오류가 발생했습니다.";
}
?>

9. 실용적인 예제

9.1 사용자 인증 예외 처리

사용자 인증 과정에서 발생할 수 있는 예외를 처리하는 예제입니다.

예시: 사용자 인증

<?php
class AuthenticationException extends Exception {}

function authenticate($username, $password) {
    // 예시를 위한 하드코딩된 사용자 데이터
    $validUsers = [
        'user1' => 'password1',
        'user2' => 'password2'
    ];

    if (!array_key_exists($username, $validUsers)) {
        throw new AuthenticationException("사용자를 찾을 수 없습니다.");
    }

    if ($validUsers[$username] !== $password) {
        throw new AuthenticationException("잘못된 비밀번호입니다.");
    }

    return "인증 성공!";
}

try {
    $username = $_POST['username'];
    $password = $_POST['password'];

    $result = authenticate($username, $password);
    echo $result;

} catch (AuthenticationException $e) {
    echo "인증 오류: " . $e->getMessage();
} catch (Exception $e) {
    echo "일반 오류: " . $e->getMessage();
}
?>

설명:

AuthenticationException을 사용하여 인증 관련 예외를 처리합니다.
사용자가 존재하지 않거나 비밀번호가 틀린 경우, 구체적인 예외 메시지를 제공합니다.

9.2 파일 처리 예외

파일을 열고 읽는 과정에서 발생할 수 있는 예외를 처리하는 예제입니다.

예시: 파일 읽기

<?php
class FileReadException extends Exception {}

function readFileContents($filename) {
    if (!file_exists($filename)) {
        throw new FileReadException("파일이 존재하지 않습니다: " . $filename);
    }

    $content = file_get_contents($filename);
    if ($content === false) {
        throw new FileReadException("파일을 읽는 데 실패했습니다: " . $filename);
    }

    return $content;
}

try {
    $filename = "data.txt";
    $data = readFileContents($filename);
    echo "파일 내용:<br>" . nl2br(htmlspecialchars($data));

} catch (FileReadException $e) {
    echo "파일 읽기 오류: " . $e->getMessage();
} catch (Exception $e) {
    echo "일반 오류: " . $e->getMessage();
}
?>

설명:

FileReadException을 사용하여 파일 관련 예외를 처리합니다.
파일이 존재하지 않거나 읽기 실패 시, 적절한 예외를 던집니다.

9.3 데이터베이스 연결 예외

데이터베이스 연결 과정에서 발생할 수 있는 예외를 처리하는 예제입니다.

예시: 데이터베이스 연결

<?php
class DatabaseConnectionException extends Exception {}

function connectToDatabase($host, $username, $password, $dbname) {
    $conn = mysqli_connect($host, $username, $password, $dbname);

    if (!$conn) {
        throw new DatabaseConnectionException("데이터베이스 연결 실패: " . mysqli_connect_error());
    }

    return $conn;
}

try {
    $host = "localhost";
    $username = "dbuser";
    $password = "dbpass";
    $dbname = "mydatabase";

    $connection = connectToDatabase($host, $username, $password, $dbname);
    echo "데이터베이스에 성공적으로 연결되었습니다.";

    // 데이터베이스 작업 수행
    mysqli_close($connection);

} catch (DatabaseConnectionException $e) {
    echo "데이터베이스 오류: " . $e->getMessage();
} catch (Exception $e) {
    echo "일반 오류: " . $e->getMessage();
}
?>

설명:

DatabaseConnectionException을 사용하여 데이터베이스 연결 관련 예외를 처리합니다.
연결 실패 시, 구체적인 예외 메시지를 제공합니다.

10. 참조 자료

요약

PHP 예외 참조는 웹 애플리케이션 개발에서 발생할 수 있는 다양한 예외 상황을 효과적으로 관리하고 처리하는 방법을 제공합니다. try-catch 블록을 사용하여 예외를 잡고, 사용자 정의 예외 클래스를 통해 구체적인 예외 처리를 구현할 수 있습니다. 또한, 예외 전파와 예외 핸들러 설정을 통해 코드의 유연성과 안정성을 높일 수 있습니다.

주요 포인트 요약:

예외의 이해: 예외와 오류의 차이를 명확히 이해하고, 적절한 상황에서 예외를 사용합니다.
예외 처리 구조: try-catch 블록을 활용하여 예외를 효과적으로 처리합니다.
커스텀 예외: 사용자 정의 예외 클래스를 생성하여 특정 상황에 맞는 예외를 관리합니다.
예외 메서드 활용: 예외 객체의 메서드를 사용하여 상세 정보를 얻고, 로깅 및 디버깅에 활용합니다.
Best Practices: 구체적인 예외 클래스 사용, 예외 메시지 보안, 예외 로깅 등을 통해 안전하고 효율적인 예외 처리를 구현합니다.
실용적인 예제: 다양한 상황에서 예외를 처리하는 실제 예제를 통해 이해를 심화합니다.

PHP의 예외 처리 기능을 마스터하면, 더 안정적이고 유지보수하기 쉬운 웹 애플리케이션을 개발할 수 있습니다. 다양한 예제를 통해 실습하고, 공식 문서를 참고하여 깊이 있는 이해를 쌓는 것이 중요합니다.

팁: PHP의 예외 처리 기능을 효과적으로 활용하려면, 다양한 예외 상황을 직접 경험해 보고, 커스텀 예외 클래스를 만들어보는 것이 좋습니다. 이를 통해 복잡한 오류 상황에서도 유연하게 대처할 수 있는 능력을 키울 수 있습니다.

코딩 스쿨 PHP

PHP Exception

PHP 예외 참조: 예외 처리와 활용

PHP 예외의 기본 이해

예외란?

예외와 오류의 차이

1. 예외 처리 기본

예시: 기본적인 예외 처리

2. 예외 클래스

2.1 기본 예외 클래스

2.2 사용자 정의 예외 클래스

3. 다중 예외 처리

4. 예외 전파

예시: 예외 전파

5. 예외의 메서드

예시: 예외 메서드 사용

6. 커스텀 예외 클래스

6.1 커스텀 예외 클래스 생성

7. 예외와 오류 핸들링 통합

7.1 ErrorException 사용

8. 예외 처리 Best Practices

8.1 구체적인 예외 클래스 사용

8.2 예외를 너무 자주 던지지 않기

8.3 예외 메시지에 민감한 정보 포함 금지

8.4 예외를 로깅하고 모니터링하기

9. 실용적인 예제

9.1 사용자 인증 예외 처리

9.2 파일 처리 예외

9.3 데이터베이스 연결 예외

10. 참조 자료

요약

7.1 `ErrorException` 사용