Yii 프레임워크 공식 가이드 시리즈 46 - 특별 주제: 오류 처리

Yii는 PHP5 예외 처리를 기반으로 하는 완전한 오류 처리 메커니즘을 제공합니다. 애플리케이션이 실행을 시작하고 사용자 요청을 처리할 때, PHP 경고 및 알림 정보를 처리하기 위해 handlerError 메소드가 등록되며, 포착되지 않은 PHP 예외를 처리하기 위해 handlerException 메소드도 등록됩니다. 따라서 애플리케이션이 실행되는 동안 PHP 경고/알림 또는 포착되지 않은 PHP 예외가 발생하면 오류 핸들러가 제어권을 넘겨받아 필요한 처리 메커니즘을 실행합니다.

팁: 오류 처리기는 PHP 함수 set_Exception_handler 및 set_error_handler를 사용하여 애플리케이션의 생성자 메서드에 등록됩니다. Yii가 오류 및 예외를 처리하는 것을 원하지 않으면 항목 파일에서 YII_ENABLE_ERROR_HANDLER 및 YII_ENABLE_EXCEPTION_HANDLER를 false로 정의할 수 있습니다.

기본적으로 onError 이벤트(또는 onException 이벤트) 가 트리거되면 errorHandler(또는 예외 핸들러)가 트리거됩니다. 어떤 이벤트에서도 오류나 예외가 처리되지 않으면 errorHandler 구성 요소를 실행하여 이를 처리해야 합니다.

1. 예외 발생

Yii에서 예외 발생은 일반 PHP 파일과 동일합니다. 다음 코드를 사용하여 예외를 발생시킬 수 있습니다:

throw new ExceptionClass('错误信息');

Yii는 CException 및 CHttpException이라는 두 가지 예외 클래스를 정의합니다. 전자는 일반 예외 클래스이고 후자는 최종 사용자에게 예외 정보를 표시하는 데 사용됩니다. 동시에 후자에는 HTTP 상태 코드를 나타내는 statusCode 속성이 있습니다. 예외 유형에 따라 표시 효과가 결정되며 이에 대해서는 아래에서 자세히 설명합니다.

팁: 사용자에게 특정 작업이 잘못되었음을 알리고 싶다면 CHttpException을 발생시키는 것이 가장 쉬운 방법입니다. 예를 들어, 사용자가 URL에 잘못된 ID 값을 제공하면 404 오류가 표시될 수 있습니다.

// 如果提交的ID是无效的
throw new CHttpException(404,'此页面不存在');

2. 오류 표시

오류가 CErrorHandler 구성 요소로 전달되면 해당 보기를 선택하여 오류를 표시합니다. 오류가 최종 사용자에게 표시되는 경우(예: CHttpException) errorXXX라는 뷰가 오류를 표시하는 데 사용됩니다. 이 XXX는 HTTP 오류 코드(예: 400, 404, 500 등)를 나타냅니다. 개발자에게만 표시되어야 하는 내부 오류인 경우 사용되는 뷰 이름은 exception입니다. 후자의 경우 전체 호출 스택 정보와 오류 줄 정보가 표시됩니다.

정보: 애플리케이션이 프로덕션 모드에서 실행 중일 때 내부 오류를 포함한 모든 오류는 errorXXX 보기를 사용합니다. 이는 호출 스택 정보와 오류 줄 정보에 민감한 정보가 포함될 수 있기 때문입니다. 이 경우 개발자는 오류 로그를 참조하여 오류의 원인을 파악해야 합니다.

CErrorHandler는 오류 메시지를 표시하기 위해 적절한 보기를 검색합니다. 검색 순서는 다음과 같습니다.

1. WebRoot/themes/ThemeName/views/system: system 디렉토리의 현재 테마 보기.

2. WebRoot/protected/views/system: 앱 기본 보기의 system 디렉터리에 있습니다.

3. yii/framework/views: Yii에서 제공하는 표준 보기 디렉터리에 있습니다.

따라서 오류 표시를 사용자 지정하려면 system 보기 디렉터리나 테마의 system 보기 디렉터리에 직접 보기 파일을 생성하면 됩니다. 각 보기 파일은 많은 HTML 코드를 포함하는 일반 PHP 파일입니다. 자세한 내용은 프레임워크의 view 디렉터리에 있는 파일을 참조하세요.

3. 액션을 사용하여 오류 처리

Yii는 컨트롤러 액션을 사용하여 오류 표시를 처리할 수도 있습니다. 이는 애플리케이션의 구성 파일에 오류 처리기를 구성하여 수행됩니다.

return array(
    ......
    'components'=>array(
        'errorHandler'=>array(
            'errorAction'=>'site/error',
        ),
    ),
);

위 코드에서는 CErrorHandler::errorAction 속성을 구성했으며 속성 값은 경로입니다site/error . 이 경로는 SiteController 내의 error을 가리킵니다. 물론 다른 경로를 이용해도 됩니다.

error 액션을 다음과 같이 작성할 수 있습니다:

public function actionError()
{
    if($error=Yii::app()->errorHandler->error)
        $this->render('error', $error);
}

이 액션에서는 먼저 CErrorHandler::error에서 자세한 오류 정보를 가져옵니다. 얻은 정보가 비어 있지 않으면 CErrorHandler::error가 반환한 정보를 사용하여 error 뷰를 렌더링합니다. CErrorHandler::error에서 반환된 정보는 다음 구조의 배열입니다.

• code: HTTP 상태 코드(예: 403, 500); 🎜>

: 오류 유형(예: CHttpException,
• )

  typePHP Error

: 오류 메시지; 🎜>
• : 오류가 발생한 PHP 파일의 이름

  message

• : 오류가 발생한 줄; 🎜>

  : 잘못된 호출 스택 정보 file

• : 오류가 발생한 코드의 컨텍스트입니다. line

팁: CErrorHandler::error가 비어 있는지 확인하는 이유는 사용자가 error 액션에 액세스할 수 있기 때문입니다. 지금은 오류가 있으면 안 됩니다. $error 배열을 뷰에 전달하면 자동으로 독립 변수로 해제됩니다. 따라서 뷰에서 $code, $type을 사용하여 이 정보에 액세스할 수 있습니다.

4. 메시지 기록

오류 발생 시 error급 오류 메시지가 기록됩니다. PHP 경고 또는 알림으로 인해 오류가 발생한 경우 메시지는 php 범주에 기록됩니다. 오류 메시지가 포착되지 않은 예외로 인해 발생한 경우 범주는 exception.ExceptionClassName입니다(예를 들어 CHttpException의 경우 statusCode). 카테고리 이름에도 추가됩니다.) 개발자는 이 기록을 활용하여 애플리케이션 실행 중 오류 메시지를 모니터링할 수 있습니다.

위 내용은 Yii Framework 공식 가이드 시리즈 46 - 특별 주제: 오류 처리입니다. 자세한 내용은 PHP 중국어 웹사이트(www. php.cn)!