7

No PHP, temos vários tipos de exceções que podem ser lançadas. Dentre elas:

BadFunctionCallException

BadMethodCallException

DomainException

InvalidArgumentException

LengthException

LogicException

OutOfBoundsException

OutOfRangeException

OverflowException

RangeException

RuntimeException

UnderflowException

UnexpectedValueException

A única que eu sei realmente ser diferente é a ErrorException, que permite lançar a exceção de acordo com os dados capturados por set_error_handler.

Porém, quanto as outras, as vezes me sinto um pouco confuso sobre qual usar.

Por exemplo:

function teste($int, array $array){

   if (! is_int($int)) {
     // lanço minha exceção aqui por que o número não é do tipo INT
   }

   array_push($array, $int);
   return $array;

}
  • Eu deveria lançar qual exceção? InvalidArgumentException, UnexpectedValueException ou BadFunctionCallException ?

  • Existe algum padrão definido (um PSR ou algo do tipo) onde explica quando devo usar cada uma delas?

Referência Manual do PHP: Exceptions

8
  • não entendi o -1 :( Commented 9/02/2015 às 18:33
  • 2
    Se o PHP permitisse type hinting com tipos primitivos, você nem precisaria se preocupar com isso </rant>. Mas dado o seu exemplo, acho que caberia usar InvalidArgumentException .
    – bfavaretto
    Commented 9/02/2015 às 18:37
  • 3
    É importante lembrar que as exceções seguem uma hierarquia: php.net/manual/pt_BR/spl.exceptions.php#spl.exceptions.tree
    – gmsantos
    Commented 9/02/2015 às 18:43
  • 1
    Mas, como você sempre diz, a documentação é um lixo! Commented 9/02/2015 às 18:43
  • 4
    Ser um lixo não significa que ela deva ser ignorada.
    – Maniero
    Commented 9/02/2015 às 18:49

2 Respostas 2

5

Neste exemplo me parece claro que a exceção correta é InvalidArgumentException. A intenção desta exceção é justamente indicar que um argumento do tipo errado foi passado para o parâmetro. A documentação existente no link fornecido na pergunta mostra isto.

A UnexpectedValueException é usado quando o mesmo problema ocorre no retorno de um tipo quando se chama uma função.

A BadFunctionCallException é usada para indicar que a função que o código está chamando não está disponível naquele momento. Como PHP é interpretado e totalmente dinâmico isto é possível.

É importante usar as exceções certas para documentar precisamente o que está acontecendo. Um programador que entende todas as nuances se beneficiará disto. Claro que para muitos programadores não faz muita diferença, ele não entende o erro mesmo que ele esteja claro e vai postar sua dúvida em algum site para alguém resolver para ele. Neste caso é ainda mais importante ter uma informação precisa para ajudar melhor quem nem conhece o sistema que ele está tentando resolver o problema.

Todas estas exceções possuem documentação e uma leitura cuidadosa indica onde cada uma deve ser usada.

Em alguns casos a exceção correta é aquela que você cria. Nem sempre deve-se usar uma exceção genérica da linguagem. Nem deve também criar exceções novas se uma existente cabe bem.

Não é fácil dizer objetivamente quando cabe cada uma, é uma questão de analisar a situação e usar o bom senso, a experiência, interpretar a documentação corretamente.

Existem poucas PSRs e até onde eu sei ainda não existe nenhuma. Não sei nem o quanto isto é efetivamente respeitado pela comunidade como algo relevante.

Exceção é um assunto que me atrai muito porque quase todo mundo abusa delas. Eu já escrevi quando criar e usar exceções em C#. Eu sei que a cultura do PHP é diferente e algumas coisas ali não cabem para outras linguagens, mas acho que ajuda um pouco.

4
  • muito bom. Só gostaria de entender essa questão do "...A função não está disponível naquele momento... O PHP é interpretado e totalmente dinâmico...". A função sempre não fica disponível independente do local onde ela é declarado (antes ou depois do chamamento da mesma, eu digo)? Commented 9/02/2015 às 18:54
  • 1
    Não, em uma linguagem como o PHP tem várias situações em que isto não é verdade. Ou porque falta algum arquivo do projeto ou porque um módulo do próprio PHP não está carregado. Não conheço todos os detalhes porque eu sou do tempo que PHP não tinha exceção :)
    – Maniero
    Commented 9/02/2015 às 18:56
  • Acabei de fazer um teste. Se você definir uma função que está dentro de um arquivo incluído com include e chamar essa função antes desse include, ela será tida como não existente! Commented 9/02/2015 às 19:12
  • 1
    Sim, esta é uma situação bastante plausível, o interpretador ainda não a conhece.
    – Maniero
    Commented 9/02/2015 às 19:13
1

Conforme esta explicação, as exceptions derivadas de LogicException devem ser utilizados para notificar aos desenvolvedores sobre problemas de lógica na aplicação (por e-mail ou log).

As exceptions derivadas de RuntimeException devem ser capturadas para mostrar alguma mensagem apropriada para o usuário ou tentar contornar o problema de alguma forma.

Você deve fazer log-in para responder a esta pergunta.

Esta não é a resposta que você está procurando? Pesquise outras perguntas com a tag .