Error Handling

\Exception (base)
├── danog\MadelineProto\Exception
│   ├── danog\MadelineProto\SecurityException
│   ├── danog\MadelineProto\NothingInTheSocketException
│   ├── danog\MadelineProto\PeerNotInDbException
│   ├── danog\MadelineProto\PTSException
│   └── danog\MadelineProto\SecretPeerNotInDbException
├── danog\MadelineProto\RPCErrorException
│   ├── danog\MadelineProto\RPCError\FloodWaitError
│   ├── danog\MadelineProto\RPCError\FloodPremiumWaitError
│   └── [Many specific RPC errors...]
└── danog\MadelineProto\TL\Exception (TL deserialization)

use danog\MadelineProto\Exception;

try {
    $MadelineProto->someMethod();
} catch (Exception $e) {
    echo "MadelineProto error: " . $e->getMessage();
    echo "\nFile: " . $e->getFile() . ":" . $e->getLine();
    echo "\nTL Trace: " . $e->getTLTrace();
}

use danog\MadelineProto\SecurityException;

try {
    // Operations that involve cryptography or authentication
    $MadelineProto->importAuthorization($auth);
} catch (SecurityException $e) {
    echo "Security error: " . $e->getMessage();
    // Handle security violations
}

use danog\MadelineProto\PeerNotInDbException;

try {
    $info = $MadelineProto->getInfo($peerId);
} catch (PeerNotInDbException $e) {
    echo "Peer not found in database\n";
    
    // Try to fetch from Telegram
    try {
        $MadelineProto->messages->getChats(['id' => [$peerId]]);
        $info = $MadelineProto->getInfo($peerId); // Retry
    } catch (\Exception $e) {
        echo "Peer does not exist: " . $e->getMessage();
    }
}

use danog\MadelineProto\RPCErrorException;

try {
    $MadelineProto->messages->sendMessage([
        'peer' => $peer,
        'message' => $text,
    ]);
} catch (RPCErrorException $e) {
    echo "RPC Error: " . $e->getMessage();
    echo "\nCode: " . $e->getCode();
    echo "\nDescription: " . $e->getDescription();
    echo "\nMethod: " . $e->rpc;
}

use danog\MadelineProto\RPCError\ChannelPrivateError;
use danog\MadelineProto\RPCError\ChannelInvalidError;
use danog\MadelineProto\RPCError\ChatAdminRequiredError;

try {
    $MadelineProto->channels->getFullChannel(['channel' => $channelId]);
} catch (ChannelPrivateError $e) {
    echo "You haven't joined this channel";
} catch (ChannelInvalidError $e) {
    echo "Invalid channel ID";
} catch (ChatAdminRequiredError $e) {
    echo "Admin privileges required";
}

use danog\MadelineProto\RPCError\InputUserDeactivatedError;

try {
    $MadelineProto->messages->sendMessage([
        'peer' => $userId,
        'message' => 'Hello',
    ]);
} catch (InputUserDeactivatedError $e) {
    echo "User account is deactivated/deleted";
}

use danog\MadelineProto\RPCError\FileReferenceExpiredError;

try {
    $MadelineProto->messages->sendMedia([
        'peer' => $peer,
        'media' => $media,
    ]);
} catch (FileReferenceExpiredError $e) {
    echo "File reference expired, need to re-fetch media";
    // Refresh the file reference and retry
}

use danog\MadelineProto\RPCError\FloodWaitError;

try {
    $MadelineProto->messages->sendMessage([...]);
} catch (FloodWaitError $e) {
    $seconds = $e->getWaitTime();
    echo "Rate limited. Wait $seconds seconds\n";
    
    // Option 1: Wait automatically
    $e->wait();
    
    // Option 2: Handle manually
    sleep($seconds);
}

use danog\MadelineProto\TL\Exception as TLException;

try {
    $MadelineProto->methodCall($method, $params);
} catch (TLException $e) {
    echo "TL Error: " . $e->getMessage();
    echo "\nTL Trace: " . $e->getTLTrace();
}

use danog\MadelineProto\RPCError\FloodWaitError;
use danog\MadelineProto\RPCError\UserPrivacyRestrictedError;
use danog\MadelineProto\RPCErrorException;
use danog\MadelineProto\Exception;

try {
    $result = $MadelineProto->messages->sendMessage([
        'peer' => $peer,
        'message' => $message,
    ]);
} catch (FloodWaitError $e) {
    // Handle rate limiting
    $e->wait();
} catch (UserPrivacyRestrictedError $e) {
    // User's privacy settings don't allow this
    echo "Cannot send message due to privacy settings";
} catch (RPCErrorException $e) {
    // Handle other RPC errors
    echo "Telegram error: " . $e->getDescription();
} catch (Exception $e) {
    // Handle MadelineProto errors
    echo "Client error: " . $e->getMessage();
}

$cleanup = false;
try {
    $file = $MadelineProto->upload('file.jpg');
    $cleanup = true;
    
    $MadelineProto->messages->sendMedia([
        'peer' => $peer,
        'media' => $file,
    ]);
} catch (\Exception $e) {
    echo "Error: " . $e->getMessage();
} finally {
    if ($cleanup) {
        // Clean up temporary files
        unlink('file.jpg');
    }
}

use danog\MadelineProto\Logger;

try {
    $MadelineProto->someMethod();
} catch (\Exception $e) {
    // MadelineProto automatically logs fatal errors
    Logger::log($e->getMessage(), Logger::ERROR);
    Logger::log($e->getTraceAsString(), Logger::ERROR);
    
    // Rethrow if needed
    throw $e;
}

// Errors are automatically reported to:
// https://report-rpc-error.madelineproto.xyz/

// You can set an auth token for reporting:
putenv('TELERPC_AUTH_TOKEN=your_token_here');

try {
    $MadelineProto->methodCall($method, $params);
} catch (\Exception $e) {
    if (method_exists($e, 'getTLTrace')) {
        echo "TL Trace:\n" . $e->getTLTrace();
    }
}

// Example TL trace output:
// While serializing:  messages.sendMessage['message']
// PeerHandler.php(432):  getInfo([...])
// MTProto.php(156):       methodCall(...)