New SPL exceptions proposal

Hello David,

Hello internals and Marcus!

What do you think about possibility to implement to PHP 5.3 several useful
default exceptions?

(note that InvalidArgumentException, RuntimeException and LogicException
exists since PHP 5.1)

/**

• The exception that is thrown when the value of an argument is
• outside the allowable range of values as defined by the invoked method.
  */
  class ArgumentOutOfRangeException extends InvalidArgumentException
  {}

Looks a bit redundant with OutOfRangeException

/**

• The exception that is thrown when a method call is invalid for the
  object's
• current state, method has been invoked at an illegal or inappropriate
  time.
  */
  class InvalidStateException extends RuntimeException
  {}

/**

• The exception that is thrown when a requested method or operation is not
  implemented.
  */
  class NotImplementedException extends LogicException
  {}

/**

• The exception that is thrown when a requested method or operation is
  deprecated.
  */
  class DeprecatedException extends LogicException
  {}

/**

• The exception that is thrown when an invoked method is not supported. For
  scenarios where
• it is sometimes possible to perform the requested operation, see
  InvalidStateException.
  */
  class NotSupportedException extends LogicException
  {}

/**

• The exception that is thrown when an I/O error occurs.
  */
  class IOException extends RuntimeException
  {}

/**

• The exception that is thrown when accessing a file that does not exist on
  disk.
  */
  class FileNotFoundException extends IOException
  {}

/**

• The exception that is thrown when part of a file or directory cannot be
  found.
  */
  class DirectoryNotFoundException extends IOException
  {}

And the last one (this is something like BadMethodException, but for
properties)

/**

• The exception that is thrown when accessing a class member (property or
  method) fails.
  */
  class MemberAccessException extends LogicException
  {}

The main problem about adding such classes is that it may/will break
BC, so for one they will have to be renamed Spl*Exception.
Additionally, there is little point in defining these exceptions if we
don't use them internally, and afaik SPL wouldn't need all of them.
On the other hand, we still have lot or generic RuntimeExceptions [1],
we might want to use more specific classes for them but I believe the
currently available exceptions will suffice in most cases.

Regards

1:
colder@larry ~/cvs/php-src $ fgrep -r "zend_throw_exception"
ext/spl/*.c | php -R 'preg_match("/spl_ce_(\w+)/", $argn, $match);
echo $match[1]."\n";' | sort | uniq -c
12 BadMethodCallException
1 DomainException
17 InvalidArgumentException
12 LogicException
3 OutOfBoundsException
10 OutOfRangeException
40 RuntimeException
7 UnexpectedValueException

David Grudl

--

--
Etienne Kneuss
http://www.colder.ch

Men never do evil so completely and cheerfully as
when they do it from a religious conviction.
-- Pascal