Try, Catch, Finally

Parte da seção Programação Orientada a Objetos do Journey de PHP da Coddy. Lição 68 de 91.

Agora que você sabe como criar e lançar exceções, precisa aprender a capturá-las. A estrutura try-catch-finally permite lidar com exceções de maneira adequada, em vez de deixá-las fazer sua aplicação falhar.

Envolva o código que pode lançar uma exceção em um bloco try e, em seguida, trate a exceção em um bloco catch:

<?php
class Calculator {
    public function divide(int $a, int $b): float {
        if ($b === 0) {
            throw new InvalidArgumentException("Cannot divide by zero");
        }
        return $a / $b;
    }
}

$calc = new Calculator();

try {
    echo $calc->divide(10, 0);
} catch (InvalidArgumentException $e) {
    echo "Error: " . $e->getMessage();
}

Saída:

Error: Cannot divide by zero

Você pode capturar diferentes tipos de exceção com vários blocos catch. O PHP verifica-os na ordem, portanto coloque primeiro as exceções mais específicas:

<?php
try {
    // código arriscado
} catch (InvalidArgumentException $e) {
    echo "Bad input: " . $e->getMessage();
} catch (Exception $e) {
    echo "Something went wrong: " . $e->getMessage();
}

O bloco finally é executado independentemente de uma exceção ter sido lançada ou capturada. Ele é perfeito para tarefas de limpeza, como fechar conexões:

<?php
try {
    echo "Attempting operation\n";
    throw new Exception("Failed");
} catch (Exception $e) {
    echo "Caught: " . $e->getMessage() . "\n";
} finally {
    echo "Cleanup complete";
}

Saída:

Attempting operation
Caught: Failed
Cleanup complete

O bloco finally é executado mesmo que você retorne de dentro dos blocos try ou catch, tornando-o confiável para operações essenciais de limpeza.

Desafio

Fácil

Vamos criar um sistema de processamento de arquivos que demonstra como try-catch-finally funciona em conjunto para tratar erros de forma adequada, garantindo que a limpeza sempre aconteça.

Você organizará seu código em três arquivos:

FileException.php: crie uma classe personalizada FileException que estenda Exception. Ela representará erros relacionados a arquivos no seu sistema.
FileProcessor.php: crie uma classe FileProcessor que simule operações com arquivos. Inclua o arquivo FileException. Sua classe deve ter:
- Uma propriedade booleana privada $isOpen inicializada com false
- Um método open(string $filename): void que defina $isOpen como true e imprima "Opening: [filename]". Se o nome do arquivo for "invalid.txt", lance uma FileException com a mensagem "Cannot open file"
- Um método process(): void que imprima "Processing file...". Se $isOpen for false, lance uma RuntimeException com a mensagem "File not open"
- Um método close(): void que defina $isOpen como false e imprima "File closed"
- Um método isOpen(): bool que retorne o estado atual
main.php: inclua o arquivo FileProcessor. Você receberá uma entrada: um nome de arquivo.
Crie um FileProcessor e use uma estrutura try-catch-finally para:
- No bloco try: chame open() com o nome do arquivo e, em seguida, chame process()
- Capture FileException primeiro e imprima "File error: [message]"
- Capture RuntimeException e imprima "Runtime error: [message]"
- No bloco finally: verifique se o arquivo está aberto usando isOpen() e, se estiver, chame close(). Em seguida, imprima "Cleanup complete"

O bloco finally garante que a limpeza aconteça independentemente de as operações serem bem-sucedidas ou falharem. Esse padrão é essencial para gerenciar recursos como arquivos, conexões de banco de dados ou sockets de rede, nos quais a limpeza deve ocorrer independentemente do que aconteça durante o processamento.

Experimente você mesmo

<?php
require_once 'FileProcessor.php';

// Ler entrada
$filename = trim(fgets(STDIN));

// TODO: Criar uma instância de FileProcessor

// TODO: Usar a estrutura try-catch-finally:
// - No bloco try: chamar open() com o filename, depois chamar process()
// - Capturar FileException primeiro e imprimir "File error: [message]"
// - Capturar RuntimeException e imprimir "Runtime error: [message]"
// - No bloco finally: verificar se o arquivo está aberto usando isOpen(), se estiver chamar close()
//   Then print "Cleanup complete"

?>