Zend Code Tracing

The Zend Code Tracing produces a full trace of all function calls during the request. This allows for detailed investigation of events and very accurate profiling.

PHP API

Function: int zend_codetracing_options(string options)
Sets and retrieves the tracing options.

Parameters:
string options - Optional: set tracing options.

Returns: Old value of the options
Available since: 4.0


Function: zend_codetracing_dump(boolean dump)
Enables or disables producing trace dump.

Parameters:
boolean dump - Optional: enable or disable trace dump. Default is enable.

Returns:
Available since: 4.0


Function: array zend_codetracing_event()
Creates a record of event in the trace log.

Returns: Array containing trace dump ID number and event number inside the dump
Available since: 4.0


Function: array zend_codetracing_dump_name(string name)
Sets/retrieves current dump name

Parameters:
string name - Optional: new dump name suffix.

Returns: Current dump name (full path).
Available since: 4.0


Function: array zend_codetracing_dump_base()
Retrieves current dump base - prefix from which dump names are created

Returns: Current dump base (full path).
Available since: 4.0

INI Directives:

zend_codetracing.enable
Is tracing functionality enabled?

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.buffer_size
The size of the trace memory buffer

Default value(s):
1M:
Type: string
Measurement units: Bytes
Available since: 4.0

zend_codetracing.dump_format
The type of dump produced

Default value(s):
2:
Type: int
Measurement units:
Available since: 4.0

zend_codetracing.max_string
The maximal length of the string before it is cut

Default value(s):
48:
Type: int
Measurement units: Bytes
Available since: 4.0

zend_codetracing.max_depth
The maximal depth of the array preserved

Default value(s):
2:
Type: int
Measurement units:
Available since: 4.0

zend_codetracing.max_elements
The maximal number of the array elements preserved

Default value(s):
10:
Type: int
Measurement units:
Available since: 4.0

zend_codetracing.dump_file
The prefix for the dump file names, relative to zend.data_dir.

Default value(s):
codetracing/dump:
Type: string
Measurement units:
Available since: 4.0

zend_codetracing.trace_enable
Tracing data collection is enabled

Default value(s):
0:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_time
Timestamp collection is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_source_lines
Source file information collection is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_internal_functions
Internal functions call collection is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_user_functions
User functions call collection is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_includes
Include/require data collection is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_arguments
Function call argument collection is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_return_values
Function return value collection is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_exceptions
PHP exception data collection is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_arrays
Array contents recording is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_write
Output data (writing) collection is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_headers
Output headers collection is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_memory_usage
Memory usage data collection is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_errors
PHP error collection is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.trace_events
Zend Monitor event recording is enabled

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.always_dump
Trace data is always persisted

Default value(s):
0:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.dump_on_segv
Trace data is persisted if fatal signal (like Segmentation Fault) happens

Default value(s):
1:
Type: boolean
Measurement units:
Available since: 4.0

zend_codetracing.max_freq
Minimum amount of seconds between successive dumps.

Default value(s):
1:
Type: int
Measurement units:
Available since: 4.0

zend_codetracing.log_file
Log file for the Code Tracing module (relative to the log dir).

Default value(s):
code_tracing.log:
Type: string
Measurement units:
Available since: 4.0

zend_codetracing.log_verbosity
Logging verbosity level.

Default value(s):
0:
Type: int
Measurement units:
Available since: 4.0

zend_codetracing.override_functions
List of overriding functions.
List of overriding functions. Can contain function names, wildcards (prefix_*) and references to files (@filename). Entries are separated by comma. File contains one entry per line, which can be function name or wildcard.
Default value(s):
@ZEND_PREFIX/etc/functions.txt:
Type: string
Measurement units:
Available since: 4.0