mirrors/php-src
0
0
Fork 0
mirror of https://github.com/php/php-src.git synced 2024-12-16 05:15:03 +08:00
Code Issues Packages Projects Releases Wiki Activity
d86314939c
php-src/Zend/zend_exceptions.h

94 lines
4.4 KiB
C
Raw Normal View History

add a standard Exception class.
2003-03-23 12:32:24 +08:00
/*
+----------------------------------------------------------------------+
| Zend Engine |
+----------------------------------------------------------------------+
Adios, yearly copyright ranges
2019-01-30 17:23:29 +08:00
| Copyright (c) Zend Technologies Ltd. (http://www.zend.com) |
add a standard Exception class.
2003-03-23 12:32:24 +08:00
+----------------------------------------------------------------------+
| This source file is subject to version 2.00 of the Zend license, |
trailing whitespace removal
2015-01-03 17:22:58 +08:00
| that is bundled with this package in the file LICENSE, and is |
updating license information in the headers.
2003-06-11 04:04:29 +08:00
| available through the world-wide-web at the following url: |
add a standard Exception class.
2003-03-23 12:32:24 +08:00
| http://www.zend.com/license/2_00.txt. |
| If you did not receive a copy of the Zend license and are unable to |
| obtain it through the world-wide-web, please send a note to |
| license@zend.com so we can mail you a copy immediately. |
+----------------------------------------------------------------------+
Update email addresses. We're still @Zend, but future proofing it...
2018-11-01 23:20:07 +08:00
| Authors: Andi Gutmans <andi@php.net> |
Allow to throw instances of classes derived from exception
2003-08-24 23:07:00 +08:00
| Marcus Boerger <helly@php.net> |
Centralize exceptions code in zend_exceptions.[ch]. Remove zend_default_classes.h (use zend_exceptions.h instead) NOTE: This currently breaks the build, fixes to php-src and pecl coming soon
2004-02-12 18:38:14 +08:00
| Sterling Hughes <sterling@php.net> |
Update email addresses. We're still @Zend, but future proofing it...
2018-11-01 23:20:07 +08:00
| Zeev Suraski <zeev@php.net> |
add a standard Exception class.
2003-03-23 12:32:24 +08:00
+----------------------------------------------------------------------+
*/
Centralize exceptions code in zend_exceptions.[ch]. Remove zend_default_classes.h (use zend_exceptions.h instead) NOTE: This currently breaks the build, fixes to php-src and pecl coming soon
2004-02-12 18:38:14 +08:00
#ifndef ZEND_EXCEPTIONS_H
#define ZEND_EXCEPTIONS_H
add a standard Exception class.
2003-03-23 12:32:24 +08:00
BEGIN_EXTERN_C()
Move definition of Throwable to zend_exceptions.h/c Also moved REGISTER_ITERATOR_INTERFACE macro to zend_interfaces.h and renamed it to REGISTER_INTERFACE.
2015-06-16 07:07:27 +08:00
extern ZEND_API zend_class_entry *zend_ce_throwable;
Switch position of ce in exception ce variable names
2015-07-03 22:45:03 +08:00
extern ZEND_API zend_class_entry *zend_ce_exception;
extern ZEND_API zend_class_entry *zend_ce_error_exception;
extern ZEND_API zend_class_entry *zend_ce_error;
Fixed bug #75218 I've introduced a new CompileError type, from which ParseError inherits. These errors are not parse errors in the narrow sense of the term, even though they happen to be generated during parsing in our implementation. Additionally reusing the ParseError class for this purpose would change existing error messages (if the exception is not caught) from a "Fatal error:" to a "Parse error:" prefix, and also the error kind from E_COMPILE_ERROR to E_PARSE.
2017-09-24 21:24:51 +08:00
extern ZEND_API zend_class_entry *zend_ce_compile_error;
Switch position of ce in exception ce variable names
2015-07-03 22:45:03 +08:00
extern ZEND_API zend_class_entry *zend_ce_parse_error;
extern ZEND_API zend_class_entry *zend_ce_type_error;
Implement \ArgumentCountError exception
2016-08-31 03:09:26 +08:00
extern ZEND_API zend_class_entry *zend_ce_argument_count_error;
add ValueError ValueError is intended to be thrown when a function or method receives an argument that has the right type (incorrect type should throw a TypeError) but an inappropriate value.
2019-09-05 04:39:02 +08:00
extern ZEND_API zend_class_entry *zend_ce_value_error;
Introduce ArithmeticError
2015-07-03 02:47:44 +08:00
extern ZEND_API zend_class_entry *zend_ce_arithmetic_error;
Use DivisionByZeroError instead of exception for %/intdiv()
2015-07-02 07:54:08 +08:00
extern ZEND_API zend_class_entry *zend_ce_division_by_zero_error;
Implement match expression RFC: https://wiki.php.net/rfc/match_expression_v2 Closes GH-5371.
2020-04-10 04:36:37 +08:00
extern ZEND_API zend_class_entry *zend_ce_unhandled_match_error;
Move definition of Throwable to zend_exceptions.h/c Also moved REGISTER_ITERATOR_INTERFACE macro to zend_interfaces.h and renamed it to REGISTER_INTERFACE.
2015-06-16 07:07:27 +08:00
first shot remove TSRMLS_* things
2014-12-14 06:06:14 +08:00
ZEND_API void zend_exception_set_previous(zend_object *exception, zend_object *add_previous);
ZEND_API void zend_exception_save(void);
ZEND_API void zend_exception_restore(void);
- MFH Exception handling [DOC] - Exceptions can be thrown while exceptions are pending, they are linked - Exceptions can be handled in __destruct - Add optional Exception $previous parameter to . Exception::__construct . ErrorException::__construct
2008-07-14 05:42:49 +08:00
Add more argument types to stubs Closes GH-5943
2020-08-06 00:45:07 +08:00
ZEND_API ZEND_COLD void zend_throw_exception_internal(zend_object *exception);
Centralize exceptions code in zend_exceptions.[ch]. Remove zend_default_classes.h (use zend_exceptions.h instead) NOTE: This currently breaks the build, fixes to php-src and pecl coming soon
2004-02-12 18:38:14 +08:00
first shot remove TSRMLS_* things
2014-12-14 06:06:14 +08:00
void zend_register_default_exception(void);
Centralize exceptions code in zend_exceptions.[ch]. Remove zend_default_classes.h (use zend_exceptions.h instead) NOTE: This currently breaks the build, fixes to php-src and pecl coming soon
2004-02-12 18:38:14 +08:00
Accept zend_object* in zend_get_exception_base
2020-08-07 21:15:50 +08:00
ZEND_API zend_class_entry *zend_get_exception_base(zend_object *object);
Cleanup exception ce API Removed recently added functions to get Error ce's and marked the old functions fetching default_exception_ce and error_exception_ce as deprecated.
2015-07-03 09:57:53 +08:00
Switch position of ce in exception ce variable names
2015-07-03 22:45:03 +08:00
/* Deprecated - Use zend_ce_exception directly instead */
first shot remove TSRMLS_* things
2014-12-14 06:06:14 +08:00
ZEND_API zend_class_entry *zend_exception_get_default(void);
Cleanup exception ce API Removed recently added functions to get Error ce's and marked the old functions fetching default_exception_ce and error_exception_ce as deprecated.
2015-07-03 09:57:53 +08:00
Switch position of ce in exception ce variable names
2015-07-03 22:45:03 +08:00
/* Deprecated - Use zend_ce_error_exception directly instead */
first shot remove TSRMLS_* things
2014-12-14 06:06:14 +08:00
ZEND_API zend_class_entry *zend_get_error_exception(void);
Cleanup exception ce API Removed recently added functions to get Error ce's and marked the old functions fetching default_exception_ce and error_exception_ce as deprecated.
2015-07-03 09:57:53 +08:00
first shot remove TSRMLS_* things
2014-12-14 06:06:14 +08:00
ZEND_API void zend_register_default_classes(void);
Allow to throw instances of classes derived from exception
2003-08-24 23:07:00 +08:00
Switch position of ce in exception ce variable names
2015-07-03 22:45:03 +08:00
/* exception_ce NULL, zend_ce_exception, zend_ce_error, or a derived class
Allow to throw instances of classes derived from exception
2003-08-24 23:07:00 +08:00
* message NULL or the message of the exception */
Mark error and exception functions as "cold" (Matt's idea)
2015-08-19 19:40:56 +08:00
ZEND_API ZEND_COLD zend_object *zend_throw_exception(zend_class_entry *exception_ce, const char *message, zend_long code);
Added ZEND_ATTRIBUTE_FORMAT to some middind functions. "%p" replaced by ZEND_LONG_FMT to avoid compilation warnings. Fixed most incorrect use cases of format specifiers.
2016-06-21 21:00:37 +08:00
ZEND_API ZEND_COLD zend_object *zend_throw_exception_ex(zend_class_entry *exception_ce, zend_long code, const char *format, ...) ZEND_ATTRIBUTE_FORMAT(printf, 3, 4);
Mark error and exception functions as "cold" (Matt's idea)
2015-08-19 19:40:56 +08:00
ZEND_API ZEND_COLD void zend_throw_exception_object(zval *exception);
first shot remove TSRMLS_* things
2014-12-14 06:06:14 +08:00
ZEND_API void zend_clear_exception(void);
Allow to throw instances of classes derived from exception
2003-08-24 23:07:00 +08:00
Pass zend_string message to zend_error_cb This makes the zend_error_cb API simpler, and avoid formatting the same message in multiple places. It should be noted that the passed zend_string is always non-persistent, so if you want to store it persistently somewhere, you may still need to duplicate it. The last_error_message is cleared a bit more aggressive, to make sure it doesn't hang around across allocator life-cycles. Closes GH-5639.
2020-05-29 16:33:22 +08:00
ZEND_API zend_object *zend_throw_error_exception(zend_class_entry *exception_ce, zend_string *message, zend_long code, int severity);
- Add new class ErrorException to encapsulate errors in exceptions
2004-07-16 06:21:36 +08:00
Add more argument types to stubs Closes GH-5943
2020-08-06 00:45:07 +08:00
extern ZEND_API void (*zend_throw_exception_hook)(zend_object *ex);
- Add hook for exception handler (Derick)
2004-04-13 23:19:21 +08:00
- MFH Catch exceptions in cli -a
2009-01-02 21:14:49 +08:00
/* show an exception using zend_error(severity,...), severity should be E_ERROR */
Improve type declarations for Zend APIs Voidification of Zend API which always succeeded Use bool argument types instead of int for boolean arguments Use bool return type for functions which return true/false (1/0) Use zend_result return type for functions which return SUCCESS/FAILURE as they don't follow normal boolean semantics Closes GH-6002
2020-08-28 21:41:27 +08:00
ZEND_API ZEND_COLD zend_result zend_exception_error(zend_object *exception, int severity);
Convert exception during inheritance to fatal error Now that inheritance can throw deprecations again, these may be converted to exception by a custom error handler. In this case we need to convert the exception to a fatal error, as inheritance cannot safely throw in the general case.
2021-05-28 16:19:23 +08:00
ZEND_NORETURN void zend_exception_uncaught_error(const char *prefix, ...) ZEND_ATTRIBUTE_FORMAT(printf, 1, 2);
Use common formatting for backtraces (#6977) This makes debug_print_backtrace() use the same formatting as exception backtraces. The only difference is that the final #{main} is omitted, because it wouldn't make sense for limited backtraces, and wasn't there previously either.
2021-05-18 17:43:37 +08:00
ZEND_API zend_string *zend_trace_to_string(HashTable *trace, bool include_main);
Make exit() unwind properly exit() is now internally implemented by throwing an exception, performing a normal stack unwind and a clean shutdown. This ensures that no persistent resource leaks occur. The exception is internal, cannot be caught and does not result in the execution of finally blocks. This may be relaxed in the future. Closes GH-5768.
2020-03-06 21:57:55 +08:00
Allow creating Graceful/UnwindExit and use when destroying a fiber (#7174) Direct creation of GracefulExit allows the the special exception object to be transfered and thrown into a destroyed fiber using the same path as any other exception thrown into a fiber instead of needing to check for a flag.
2021-06-29 04:23:34 +08:00
ZEND_API ZEND_COLD zend_object *zend_create_unwind_exit(void);
ZEND_API ZEND_COLD zend_object *zend_create_graceful_exit(void);
Make exit() unwind properly exit() is now internally implemented by throwing an exception, performing a normal stack unwind and a clean shutdown. This ensures that no persistent resource leaks occur. The exception is internal, cannot be caught and does not result in the execution of finally blocks. This may be relaxed in the future. Closes GH-5768.
2020-03-06 21:57:55 +08:00
ZEND_API ZEND_COLD void zend_throw_unwind_exit(void);
Implement Fibers RFC: https://wiki.php.net/rfc/fibers Closes GH-6875.
2021-04-27 00:07:06 +08:00
ZEND_API ZEND_COLD void zend_throw_graceful_exit(void);
ZEND_API bool zend_is_unwind_exit(const zend_object *ex);
ZEND_API bool zend_is_graceful_exit(const zend_object *ex);
Allow to throw instances of classes derived from exception
2003-08-24 23:07:00 +08:00
Fixed compilation error
2016-12-12 16:19:04 +08:00
#include "zend_globals.h"
Improved VM stack unwinding on exception. Now zend_throw_exception_hook() is going to be called only when exception is actually thrown and not going to be recalled for each unwinded finction.
2016-12-12 15:55:32 +08:00
static zend_always_inline void zend_rethrow_exception(zend_execute_data *execute_data)
{
if (EX(opline)->opcode != ZEND_HANDLE_EXCEPTION) {
EG(opline_before_exception) = EX(opline);
EX(opline) = EG(exception_op);
}
}
add a standard Exception class.
2003-03-23 12:32:24 +08:00
END_EXTERN_C()
#endif
Reference in New Issue Copy Permalink