Coverage Report

Created: 2026-06-02 06:40

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/php-src/Zend/zend_exceptions.h
Line
Count
Source
1
/*
2
   +----------------------------------------------------------------------+
3
   | Zend Engine                                                          |
4
   +----------------------------------------------------------------------+
5
   | Copyright © Zend Technologies Ltd., a subsidiary company of          |
6
   |     Perforce Software, Inc., and Contributors.                       |
7
   +----------------------------------------------------------------------+
8
   | This source file is subject to the Modified BSD License that is      |
9
   | bundled with this package in the file LICENSE, and is available      |
10
   | through the World Wide Web at <https://www.php.net/license/>.        |
11
   |                                                                      |
12
   | SPDX-License-Identifier: BSD-3-Clause                                |
13
   +----------------------------------------------------------------------+
14
   | Authors: Andi Gutmans <andi@php.net>                                 |
15
   |          Marcus Boerger <helly@php.net>                              |
16
   |          Sterling Hughes <sterling@php.net>                          |
17
   |          Zeev Suraski <zeev@php.net>                                 |
18
   +----------------------------------------------------------------------+
19
*/
20
21
#ifndef ZEND_EXCEPTIONS_H
22
#define ZEND_EXCEPTIONS_H
23
24
#include "zend_types.h"
25
26
BEGIN_EXTERN_C()
27
28
extern ZEND_API zend_class_entry *zend_ce_throwable;
29
extern ZEND_API zend_class_entry *zend_ce_exception;
30
extern ZEND_API zend_class_entry *zend_ce_error_exception;
31
extern ZEND_API zend_class_entry *zend_ce_error;
32
extern ZEND_API zend_class_entry *zend_ce_compile_error;
33
extern ZEND_API zend_class_entry *zend_ce_parse_error;
34
extern ZEND_API zend_class_entry *zend_ce_type_error;
35
extern ZEND_API zend_class_entry *zend_ce_argument_count_error;
36
extern ZEND_API zend_class_entry *zend_ce_value_error;
37
extern ZEND_API zend_class_entry *zend_ce_arithmetic_error;
38
extern ZEND_API zend_class_entry *zend_ce_division_by_zero_error;
39
extern ZEND_API zend_class_entry *zend_ce_unhandled_match_error;
40
extern ZEND_API zend_class_entry *zend_ce_request_parse_body_exception;
41
42
ZEND_API void zend_exception_set_previous(zend_object *exception, zend_object *add_previous);
43
44
ZEND_API ZEND_COLD void zend_throw_exception_internal(zend_object *exception);
45
46
void zend_register_default_exception(void);
47
48
ZEND_API zend_class_entry *zend_get_exception_base(const zend_object *object);
49
50
ZEND_API void zend_register_default_classes(void);
51
52
/* exception_ce   NULL, zend_ce_exception, zend_ce_error, or a derived class
53
 * message        NULL or the message of the exception */
54
ZEND_API ZEND_COLD zend_object *zend_throw_exception(zend_class_entry *exception_ce, const char *message, zend_long code);
55
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);
56
ZEND_API ZEND_COLD void zend_throw_exception_object(zval *exception);
57
ZEND_API void zend_clear_exception(void);
58
59
ZEND_API zend_object *zend_throw_error_exception(zend_class_entry *exception_ce, zend_string *message, zend_long code, int severity);
60
61
extern ZEND_API void (*zend_throw_exception_hook)(zend_object *ex);
62
63
ZEND_API zend_result zend_update_exception_properties(zend_execute_data *execute_data, zval *return_value, zend_string *message, zend_long code, zval *previous);
64
65
/* show an exception using zend_error(severity,...), severity should be E_ERROR */
66
ZEND_API ZEND_COLD zend_result zend_exception_error(zend_object *exception, int severity);
67
ZEND_NORETURN void zend_exception_uncaught_error(const char *prefix, ...) ZEND_ATTRIBUTE_FORMAT(printf, 1, 2);
68
ZEND_API zend_string *zend_trace_function_args_to_string(const HashTable *frame);
69
ZEND_API zend_string *zend_trace_current_function_args_string(void);
70
ZEND_API zend_string *zend_trace_to_string(const HashTable *trace, bool include_main);
71
72
ZEND_API ZEND_COLD zend_object *zend_create_unwind_exit(void);
73
ZEND_API ZEND_COLD zend_object *zend_create_graceful_exit(void);
74
ZEND_API ZEND_COLD void zend_throw_unwind_exit(void);
75
ZEND_API ZEND_COLD void zend_throw_graceful_exit(void);
76
ZEND_API bool zend_is_unwind_exit(const zend_object *ex);
77
ZEND_API bool zend_is_graceful_exit(const zend_object *ex);
78
79
#include "zend_globals.h"
80
81
static zend_always_inline void zend_rethrow_exception(zend_execute_data *execute_data)
82
155k
{
83
155k
  if (EX(opline)->opcode != ZEND_HANDLE_EXCEPTION) {
84
155k
    EG(opline_before_exception) = EX(opline);
85
155k
    EX(opline) = EG(exception_op);
86
155k
  }
87
155k
}
Unexecuted instantiation: php_date.c:zend_rethrow_exception
Unexecuted instantiation: hash.c:zend_rethrow_exception
Unexecuted instantiation: json_encoder.c:zend_rethrow_exception
Unexecuted instantiation: json.c:zend_rethrow_exception
Unexecuted instantiation: ZendAccelerator.c:zend_rethrow_exception
Unexecuted instantiation: zend_jit_vm_helpers.c:zend_rethrow_exception
Unexecuted instantiation: zend_jit.c:zend_rethrow_exception
Unexecuted instantiation: csprng.c:zend_rethrow_exception
Unexecuted instantiation: engine_mt19937.c:zend_rethrow_exception
Unexecuted instantiation: engine_pcgoneseq128xslrr64.c:zend_rethrow_exception
Unexecuted instantiation: engine_secure.c:zend_rethrow_exception
Unexecuted instantiation: engine_xoshiro256starstar.c:zend_rethrow_exception
Unexecuted instantiation: random.c:zend_rethrow_exception
Unexecuted instantiation: randomizer.c:zend_rethrow_exception
Unexecuted instantiation: php_reflection.c:zend_rethrow_exception
Unexecuted instantiation: php_spl.c:zend_rethrow_exception
Unexecuted instantiation: spl_array.c:zend_rethrow_exception
Unexecuted instantiation: spl_directory.c:zend_rethrow_exception
Unexecuted instantiation: spl_dllist.c:zend_rethrow_exception
Unexecuted instantiation: spl_exceptions.c:zend_rethrow_exception
Unexecuted instantiation: spl_fixedarray.c:zend_rethrow_exception
Unexecuted instantiation: spl_heap.c:zend_rethrow_exception
Unexecuted instantiation: spl_iterators.c:zend_rethrow_exception
Unexecuted instantiation: spl_observer.c:zend_rethrow_exception
Unexecuted instantiation: array.c:zend_rethrow_exception
Unexecuted instantiation: assert.c:zend_rethrow_exception
Unexecuted instantiation: basic_functions.c:zend_rethrow_exception
Unexecuted instantiation: ftp_fopen_wrapper.c:zend_rethrow_exception
Unexecuted instantiation: http_fopen_wrapper.c:zend_rethrow_exception
Unexecuted instantiation: http.c:zend_rethrow_exception
Unexecuted instantiation: math.c:zend_rethrow_exception
Unexecuted instantiation: string.c:zend_rethrow_exception
Unexecuted instantiation: var_unserializer.c:zend_rethrow_exception
Unexecuted instantiation: var.c:zend_rethrow_exception
Unexecuted instantiation: php_uri.c:zend_rethrow_exception
Unexecuted instantiation: php_uri_common.c:zend_rethrow_exception
Unexecuted instantiation: uri_parser_rfc3986.c:zend_rethrow_exception
Unexecuted instantiation: uri_parser_whatwg.c:zend_rethrow_exception
Unexecuted instantiation: uri_parser_php_parse_url.c:zend_rethrow_exception
Unexecuted instantiation: main.c:zend_rethrow_exception
Unexecuted instantiation: php_variables.c:zend_rethrow_exception
Unexecuted instantiation: rfc1867.c:zend_rethrow_exception
Unexecuted instantiation: stream_errors.c:zend_rethrow_exception
Unexecuted instantiation: sccp.c:zend_rethrow_exception
Unexecuted instantiation: zend_API.c:zend_rethrow_exception
Unexecuted instantiation: zend_ast.c:zend_rethrow_exception
Unexecuted instantiation: zend_attributes.c:zend_rethrow_exception
Unexecuted instantiation: zend_autoload.c:zend_rethrow_exception
Unexecuted instantiation: zend_builtin_functions.c:zend_rethrow_exception
Unexecuted instantiation: zend_closures.c:zend_rethrow_exception
Unexecuted instantiation: zend_compile.c:zend_rethrow_exception
Unexecuted instantiation: zend_constants.c:zend_rethrow_exception
Unexecuted instantiation: zend_default_classes.c:zend_rethrow_exception
Unexecuted instantiation: zend_exceptions.c:zend_rethrow_exception
zend_execute_API.c:zend_rethrow_exception
Line
Count
Source
82
786
{
83
786
  if (EX(opline)->opcode != ZEND_HANDLE_EXCEPTION) {
84
782
    EG(opline_before_exception) = EX(opline);
85
782
    EX(opline) = EG(exception_op);
86
782
  }
87
786
}
zend_execute.c:zend_rethrow_exception
Line
Count
Source
82
149k
{
83
149k
  if (EX(opline)->opcode != ZEND_HANDLE_EXCEPTION) {
84
149k
    EG(opline_before_exception) = EX(opline);
85
149k
    EX(opline) = EG(exception_op);
86
149k
  }
87
149k
}
zend_fibers.c:zend_rethrow_exception
Line
Count
Source
82
2
{
83
2
  if (EX(opline)->opcode != ZEND_HANDLE_EXCEPTION) {
84
2
    EG(opline_before_exception) = EX(opline);
85
2
    EX(opline) = EG(exception_op);
86
2
  }
87
2
}
Unexecuted instantiation: zend_gc.c:zend_rethrow_exception
zend_generators.c:zend_rethrow_exception
Line
Count
Source
82
116
{
83
116
  if (EX(opline)->opcode != ZEND_HANDLE_EXCEPTION) {
84
114
    EG(opline_before_exception) = EX(opline);
85
114
    EX(opline) = EG(exception_op);
86
114
  }
87
116
}
Unexecuted instantiation: zend_highlight.c:zend_rethrow_exception
Unexecuted instantiation: zend_inheritance.c:zend_rethrow_exception
Unexecuted instantiation: zend_interfaces.c:zend_rethrow_exception
Unexecuted instantiation: zend_language_parser.c:zend_rethrow_exception
Unexecuted instantiation: zend_language_scanner.c:zend_rethrow_exception
Unexecuted instantiation: zend_object_handlers.c:zend_rethrow_exception
zend_objects.c:zend_rethrow_exception
Line
Count
Source
82
4.70k
{
83
4.70k
  if (EX(opline)->opcode != ZEND_HANDLE_EXCEPTION) {
84
4.42k
    EG(opline_before_exception) = EX(opline);
85
4.42k
    EX(opline) = EG(exception_op);
86
4.42k
  }
87
4.70k
}
Unexecuted instantiation: zend_operators.c:zend_rethrow_exception
Unexecuted instantiation: zend.c:zend_rethrow_exception
Unexecuted instantiation: fuzzer-function-jit.c:zend_rethrow_exception
Unexecuted instantiation: fuzzer-sapi.c:zend_rethrow_exception
88
89
END_EXTERN_C()
90
91
#endif