[php] PHP 라이브러리 S3 오류 처리 방법

22 Dec 2023

Amazon S3(Simple Storage Service)은 파일 저장 및 관리를 위한 웹 서비스이다. PHP에서 S3 라이브러리를 사용하여 파일을 업로드 및 다운로드할 때 발생할 수 있는 오류를 처리하는 방법을 살펴보자.

1. 오류 핸들링

S3 라이브러리를 사용하여 파일을 업로드하거나 다운로드할 때 발생하는 오류는 여러 가지가 있다. 이러한 오류를 처리하기 위해 PHP에서는 try-catch 구문을 사용하여 예외를 처리한다.

아래 예제는 S3 라이브러리를 사용하여 파일을 업로드하고, 그 과정에서 발생하는 오류를 try-catch 구문으로 처리하는 방법을 보여준다.

use Aws\S3\S3Client;
use Aws\S3\Exception\S3Exception;

try {
    // S3 클라이언트 생성
    $s3 = new S3Client([
        'version' => 'latest',
        'region'  => 'us-west-2'
    ]);

    // 파일 업로드
    $result = $s3->putObject([
        'Bucket' => 'my-bucket',
        'Key'    => 'my-object',
        'Body'   => 'Hello, world!',
    ]);

    echo "파일이 성공적으로 업로드되었습니다.";

} catch (S3Exception $e) {
    echo "파일 업로드 중 오류가 발생했습니다: " . $e->getMessage();
}

2. 오류 유형에 따른 처리

S3 라이브러리는 다양한 오류 유형을 반환한다. 이 중 몇 가지 주요 오류 유형을 살펴보고, 각 오류에 대한 처리 방법을 예제를 통해 살펴보자.

2.1. 권한 오류 처리

S3 파일 업로드 시 권한 관련 오류가 발생할 수 있다. 이때는 해당 오류에 따라 적절한 권한 설정 또는 오류 메시지를 출력할 수 있다.

use Aws\S3\Exception\AccessDeniedException;

try {
    // 파일 업로드
    $result = $s3->putObject([
        'Bucket' => 'my-bucket',
        'Key'    => 'my-object',
        'Body'   => 'Hello, world!',
    ]);

    echo "파일이 성공적으로 업로드되었습니다.";

} catch (AccessDeniedException $e) {
    echo "파일 업로드 중 권한 오류가 발생했습니다: " . $e->getMessage();
}

2.2. 네트워크 오류 처리

네트워크 문제로 인한 오류는 예상치 못한 상황이다. 이때는 네트워크 오류에 대한 적절한 메시지를 출력하거나 재시도 등의 조치를 취할 수 있다.

use Aws\S3\Exception\NetworkException;

try {
    // 파일 업로드
    $result = $s3->putObject([
        'Bucket' => 'my-bucket',
        'Key'    => 'my-object',
        'Body'   => 'Hello, world!',
    ]);

    echo "파일이 성공적으로 업로드되었습니다.";

} catch (NetworkException $e) {
    echo "파일 업로드 중 네트워크 오류가 발생했습니다: " . $e->getMessage();
}

결론

S3 라이브러리를 사용하여 파일을 업로드하거나 다운로드할 때 발생할 수 있는 다양한 오류를 효과적으로 처리하는 것은 안정적이고 신뢰할 수 있는 웹 애플리케이션을 개발하는 데 중요하다.

이상으로 S3 라이브러리를 사용하여 오류를 처리하는 방법에 대해 알아보았다. S3 라이브러리와 관련된 더 많은 정보는 AWS 공식 문서를 참고하면 된다.

참고 문헌:

AWS SDK for PHP 공식 문서