Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:41855
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: error (pb1.pair.com: domain grudl.com from 80.79.20.227 cause and error)
Message-ID: <4919AFE5.5000203@grudl.com>
Date: Tue, 11 Nov 2008 17:16:37 +0100
User-Agent: Thunderbird 2.0.0.17 (Windows/20080914)
MIME-Version: 1.0
To: PHP internals <internals@lists.php.net>, 
 marcus.boerger@post.rwth-aachen.de
Content-Type: text/plain; charset=ISO-8859-2; format=flowed
Content-Transfer-Encoding: 7bit
Subject: New SPL exceptions proposal
From: david@grudl.com (David Grudl)

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
{}

/**
 * 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
{}


David Grudl