PHPでカスタム例外メッセージを作成しエラーの詳細を提供する方法

try {
    // エラーが発生する可能性のあるコード
    throw new Exception("エラーメッセージ");
} catch (Exception $e) {
    // エラー発生時の処理
    echo "例外が発生しました: " . $e->getMessage();
}

class CustomException extends Exception {
    // カスタムプロパティ
    private $details;

    // コンストラクタ
    public function __construct($message, $code = 0, Exception $previous = null, $details = '') {
        // 親クラスのコンストラクタを呼び出す
        parent::__construct($message, $code, $previous);
        $this->details = $details;
    }

    // カスタムメソッド
    public function getDetails() {
        return $this->details;
    }
}

try {
    // カスタム例外をスロー
    throw new CustomException("カスタムエラーメッセージ", 1, null, "追加の詳細情報");
} catch (CustomException $e) {
    // カスタム例外の処理
    echo "エラー: " . $e->getMessage() . "\n";
    echo "詳細: " . $e->getDetails();
}

function divide($numerator, $denominator) {
    if ($denominator == 0) {
        throw new CustomException("ゼロでの除算は許可されていません。分子: $numerator, 分母: $denominator");
    }
    return $numerator / $denominator;
}

try {
    echo divide(10, 0);
} catch (CustomException $e) {
    echo "エラー発生: " . $e->getMessage();
}

class FormattedException extends Exception {
    public function __construct($errorCode, $details) {
        $message = "[エラーコード: $errorCode] 詳細: $details";
        parent::__construct($message);
    }
}

try {
    throw new FormattedException(404, "指定されたリソースが見つかりませんでした");
} catch (FormattedException $e) {
    echo "エラー発生: " . $e->getMessage();
}

try {
    throw new CustomException("エラーが発生しました", 0, null, "ファイル: " . __FILE__ . ", 行番号: " . __LINE__);
} catch (CustomException $e) {
    echo "エラーメッセージ: " . $e->getMessage() . "\n";
    echo "詳細: " . $e->getDetails();
}

class CustomException extends Exception {
    public function getFullMessage() {
        return "エラーメッセージ: " . $this->getMessage() . "\n" .
               "スタックトレース: \n" . $this->getTraceAsString();
    }
}

try {
    // 意図的にエラーを発生させる
    throw new CustomException("カスタムエラーが発生しました");
} catch (CustomException $e) {
    // カスタム例外の詳細メッセージとスタックトレースを表示
    echo $e->getFullMessage();
}

try {
    // エラーを発生させる例
    throw new CustomException("データベース接続エラー");
} catch (CustomException $e) {
    // エラーログにスタックトレースを記録
    error_log($e->getFullMessage(), 3, '/path/to/error.log');
    echo "エラーが発生しました。詳細はログを確認してください。";
}

class ValidationException extends Exception {
    private $fieldName;

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

    public function getFieldName() {
        return $this->fieldName;
    }
}

function validateUserInput($data) {
    if (empty($data['email'])) {
        throw new ValidationException("メールアドレスが入力されていません", "email");
    }
    if (!filter_var($data['email'], FILTER_VALIDATE_EMAIL)) {
        throw new ValidationException("無効なメールアドレス形式です", "email");
    }
    if (empty($data['password']) || strlen($data['password']) < 6) {
        throw new ValidationException("パスワードは6文字以上で入力してください", "password");
    }
    // その他の検証...
}

$userInput = [
    'email' => 'invalid-email',
    'password' => '123'
];

try {
    validateUserInput($userInput);
    echo "ユーザー入力が正常です。";
} catch (ValidationException $e) {
    echo "入力エラー: " . $e->getMessage() . "\n";
    echo "エラーの発生箇所: " . $e->getFieldName();
}

function validateUserInputWithMultipleErrors($data) {
    $errors = [];

    if (empty($data['email'])) {
        $errors[] = new ValidationException("メールアドレスが入力されていません", "email");
    } elseif (!filter_var($data['email'], FILTER_VALIDATE_EMAIL)) {
        $errors[] = new ValidationException("無効なメールアドレス形式です", "email");
    }

    if (empty($data['password']) || strlen($data['password']) < 6) {
        $errors[] = new ValidationException("パスワードは6文字以上で入力してください", "password");
    }

    // エラーがあればまとめて例外をスロー
    if (!empty($errors)) {
        throw new AggregateValidationException("複数の入力エラーが発生しました", $errors);
    }
}

{
    "en": {
        "email_required": "The email address is required.",
        "invalid_email": "The email address format is invalid.",
        "password_length": "The password must be at least 6 characters long."
    },
    "ja": {
        "email_required": "メールアドレスが入力されていません。",
        "invalid_email": "メールアドレスの形式が無効です。",
        "password_length": "パスワードは6文字以上で入力してください。"
    }
}

function getErrorMessage($key, $lang = 'en') {
    // メッセージファイルの読み込み
    $messages = json_decode(file_get_contents('messages.json'), true);

    // 指定した言語が存在しない場合、デフォルト（英語）にフォールバック
    if (!isset($messages[$lang])) {
        $lang = 'en';
    }

    // メッセージが存在すれば返し、なければキーをそのまま返す
    return $messages[$lang][$key] ?? $key;
}

class InternationalizedException extends Exception {
    public function __construct($messageKey, $lang = 'en', $code = 0, Exception $previous = null) {
        // 国際化対応したエラーメッセージを取得
        $message = getErrorMessage($messageKey, $lang);
        parent::__construct($message, $code, $previous);
    }
}

try {
    // 日本語でカスタム例外をスロー
    throw new InternationalizedException('email_required', 'ja');
} catch (InternationalizedException $e) {
    // エラーメッセージを表示
    echo "エラー: " . $e->getMessage();
}

try {
    validateUserInput($userInput); // 先に説明した検証関数を使用
} catch (ValidationException $e) {
    echo getErrorMessage($e->getMessage(), 'ja'); // 日本語でエラーメッセージを取得
}

class LoggingException extends Exception {
    public function logError() {
        // エラーメッセージとスタックトレースをログに記録
        $logMessage = "エラー: " . $this->getMessage() . "\n" .
                      "スタックトレース: " . $this->getTraceAsString();
        error_log($logMessage, 3, '/path/to/error.log'); // ログファイルに追記
    }
}

try {
    // 意図的にエラーを発生させる
    throw new LoggingException("データベース接続に失敗しました");
} catch (LoggingException $e) {
    // エラーログを記録し、ユーザーにフィードバックを提供
    $e->logError();
    echo "エラーが発生しました。詳細は管理者にお問い合わせください。";
}

class DetailedLoggingException extends Exception {
    public function logError($userId = null, $additionalInfo = []) {
        $dateTime = date('Y-m-d H:i:s');
        $logMessage = "[$dateTime] エラー: " . $this->getMessage() . "\n" .
                      "ユーザーID: " . ($userId ?? '不明') . "\n" .
                      "スタックトレース: " . $this->getTraceAsString() . "\n" .
                      "追加情報: " . json_encode($additionalInfo);
        error_log($logMessage, 3, '/path/to/error.log');
    }
}

try {
    // サンプルエラーを発生させる
    throw new DetailedLoggingException("無効な操作が試みられました");
} catch (DetailedLoggingException $e) {
    // エラーログを記録
    $e->logError(12345, ['操作' => 'データ更新', 'IPアドレス' => $_SERVER['REMOTE_ADDR']]);
    echo "問題が発生しました。サポートに連絡してください。";
}

use Monolog\Logger;
use Monolog\Handler\StreamHandler;

// Monologのインスタンスを作成
$log = new Logger('app');
$log->pushHandler(new StreamHandler('/path/to/monolog.log', Logger::ERROR));

try {
    throw new LoggingException("ファイル読み込みエラーが発生しました");
} catch (LoggingException $e) {
    // Monologでログを記録
    $log->error($e->getMessage(), ['stackTrace' => $e->getTraceAsString()]);
    echo "エラーが発生しました。ログが記録されました。";
}

use PHPUnit\Framework\TestCase;

class CustomExceptionTest extends TestCase {
    public function testExceptionIsThrown() {
        $this->expectException(CustomException::class);
        $this->expectExceptionMessage("カスタムエラーが発生しました");

        // 例外を発生させる
        throw new CustomException("カスタムエラーが発生しました");
    }
}

use PHPUnit\Framework\TestCase;

class ValidationExceptionTest extends TestCase {
    public function testCustomProperty() {
        try {
            // 例外をスロー
            throw new ValidationException("無効な入力です", "email");
        } catch (ValidationException $e) {
            // プロパティが正しいかどうかを確認
            $this->assertEquals("無効な入力です", $e->getMessage());
            $this->assertEquals("email", $e->getFieldName());
        }
    }
}

use PHPUnit\Framework\TestCase;

class InputValidationTest extends TestCase {
    public function testEmailValidation() {
        $this->expectException(ValidationException::class);
        $this->expectExceptionMessage("メールアドレスが入力されていません");

        validateUserInput(['email' => '', 'password' => 'password123']);
    }

    public function testPasswordValidation() {
        $this->expectException(ValidationException::class);
        $this->expectExceptionMessage("パスワードは6文字以上で入力してください");

        validateUserInput(['email' => 'test@example.com', 'password' => '123']);
    }
}

use PHPUnit\Framework\TestCase;

class LoggingExceptionTest extends TestCase {
    public function testLoggingFunctionality() {
        $logFile = '/path/to/test_error.log';
        // ログファイルが既に存在する場合は削除
        if (file_exists($logFile)) {
            unlink($logFile);
        }

        try {
            // ログを伴う例外をスロー
            $exception = new LoggingException("テスト用のエラー");
            $exception->logError();

            // ログファイルの内容を検証
            $this->assertFileExists($logFile);
            $logContents = file_get_contents($logFile);
            $this->assertStringContainsString("テスト用のエラー", $logContents);
        } finally {
            // テスト終了後にログファイルを削除
            if (file_exists($logFile)) {
                unlink($logFile);
            }
        }
    }
}

class ApiException extends Exception {
    protected $statusCode;

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

    public function getStatusCode() {
        return $this->statusCode;
    }
}

function handleApiRequest($data) {
    if (empty($data['user_id'])) {
        throw new ApiException("ユーザーIDが指定されていません", 400);
    }
    // その他のAPI処理...
    return ["message" => "リクエストが成功しました"];
}

try {
    $response = handleApiRequest($_POST);
    header('Content-Type: application/json');
    echo json_encode($response);
} catch (ApiException $e) {
    // エラーレスポンスを返す
    http_response_code($e->getStatusCode());
    header('Content-Type: application/json');
    echo json_encode(["error" => $e->getMessage()]);
}

class AuthenticationException extends ApiException {
    public function __construct($message = "認証に失敗しました") {
        parent::__construct($message, 401);
    }
}

class DatabaseException extends ApiException {
    public function __construct($message = "データベースエラーが発生しました") {
        parent::__construct($message, 500);
    }
}

function authenticateUser($token) {
    if ($token !== 'valid-token') {
        throw new AuthenticationException();
    }
}

function getUserData($userId) {
    // データベース接続エラーをシミュレート
    throw new DatabaseException("ユーザーデータの取得中にエラーが発生しました");
}

function errorHandler($exception) {
    if ($exception instanceof ApiException) {
        http_response_code($exception->getStatusCode());
        $response = ["error" => $exception->getMessage()];
    } else {
        http_response_code(500);
        $response = ["error" => "内部サーバーエラーが発生しました"];
    }

    header('Content-Type: application/json');
    echo json_encode($response);
}

// すべての例外をキャッチしてカスタムエラーハンドラーに渡す
set_exception_handler('errorHandler');

{
    "error": {
        "code": 400,
        "message": "ユーザーIDが指定されていません",
        "details": [
            {
                "field": "user_id",
                "issue": "必須項目です"
            }
        ]
    }
}

class RetryableException extends ApiException {
    protected $retryAfter;

    public function __construct($message, $retryAfter = 60) {
        parent::__construct($message, 503);
        $this->retryAfter = $retryAfter;
    }

    public function getRetryAfter() {
        return $this->retryAfter;
    }
}

try {
    throw new RetryableException("サーバーが一時的に利用不可です。後で再試行してください。", 120);
} catch (RetryableException $e) {
    http_response_code($e->getStatusCode());
    header('Retry-After: ' . $e->getRetryAfter());
    echo json_encode(["error" => $e->getMessage(), "retry_after" => $e->getRetryAfter()]);
}