An open API service indexing awesome lists of open source software.

https://github.com/sikessem/tracer

Easily backtrace PHP functions and methods 🧐
https://github.com/sikessem/tracer

backtrace php sikessem tracer

Last synced: 10 days ago
JSON representation

Easily backtrace PHP functions and methods 🧐

Awesome Lists containing this project

README

          

# [Sikessem][sikessem-link] Tracer 🧐

Tracer is a modern, minimalistic PHP package for capturing, filtering,
and navigating execution traces (debug_backtrace) with clarity and precision.
It provides a clean, fluent, and iterable API that allows you to:

- Dynamically filter files, classes, methods, functions, lines, and more
- Ignore helper functions or internal frames to focus on relevant code
- Navigate through the trace stack with methods like peek(), each(), first(), etc.
- Determine whether a function, method, or class appears in the call stack
- Create clean, readable backtraces with zero dependencies

Tracer is ideal as a standalone utility or as a foundational component
for more complex tools like [Exceptor](https://github.com/Sikessem/Exceptor),
enabling precise and expressive debugging in modern PHP.

[![php-icon]][php-link]
[![packagist-version-icon]][packagist-version-link]
[![packagist-download-icon]][packagist-download-link]
[![license-icon]][license-link]
[![actions-icon]][actions-link]
[![twitter-icon]][twitter-link]

[Read the documentation to learn more][docs-link].

***

## πŸ“– Documentation

The full documentation for the Sikessem Tracer can be found [here][docs-link].

## πŸ‘ Contribution

The main purpose of this repository is to continue evolving Sikessem.
We want to make contributing to this project as easy and transparent as possible,
and we are grateful to the community for contributing bug fixes and improvements.
Read below to learn how you can take part in improving Sikessem.

### [πŸ‘· Code of Conduct][conduct-link]

[Sikessem][sikessem-link] has adopted a Code of Conduct that we expect project participants to adhere to.
Please read the [full text][conduct-link] so that you can understand what actions will and will not be tolerated.

### πŸ‘₯ [Contributing Guide][pr-link]

Read our [**Contributing Guide**][pr-link] to learn about our development process,
how to propose bugfixes and improvements,
and how to build and test your changes to Sikessem.

### πŸ”’οΈ Good First Issues

We have a list of [good first issues][gfi] that contain bugs which have a relatively limited scope. This is a great place to get started, gain experience, and get familiar with our contribution process.

[gfi]: https://github.com/sikessem/tracer/labels/good%20first%20issue

### πŸ’¬ Discussions

Larger discussions and proposals are discussed in [**Sikessem's GitHub discussions**][discuss-link].

## πŸ” Security Reports

If you discover a security vulnerability within [any of Sikessem's projects][sikessem-link], please email [SIGUI KessΓ© Emmanuel](https://siguici.deno.dev) at [siguici@proton.me](mailto:siguici@proton.me). All security vulnerabilities will be promptly addressed.

## πŸ“„ License

The Sikessem Tracer is open-sourced software licensed under the [MIT License](https://opensource.org/licenses/MIT) - see the [LICENSE][license-link] file for details.

***

Made with ❀︎ by @siguici.

[sikessem-link]: https://github.com/sikessem "Sikessem"

[php-icon]: https://img.shields.io/badge/PHP-8.2-ccc.svg?style=flat&logo=php
[php-link]: https://github.com/sikessem/tracer/search?l=php "PHP code"

[packagist-version-icon]: https://img.shields.io/packagist/v/sikessem/tracer
[packagist-version-link]: https://packagist.org/packages/sikessem/tracer "Tracer Releases"

[packagist-download-icon]: https://img.shields.io/packagist/dt/sikessem/tracer
[packagist-download-link]: https://packagist.org/packages/sikessem/tracer "Tracer Downloads"

[actions-icon]: https://github.com/sikessem/tracer/workflows/CI/badge.svg
[actions-link]: https://github.com/sikessem/tracer/actions "Tracer status"

[twitter-icon]: https://img.shields.io/twitter/follow/sikessem.svg?label=@SikessemHQ
[twitter-link]: https://twitter.com/intent/follow?screen_name=SikessemHQ "Ping Sikessem"

[license-icon]: https://img.shields.io/badge/license-MIT-blue.svg
[license-link]: https://github.com/sikessem/tracer/blob/HEAD/LICENSE "Tracer License"

[pr-link]: https://sikessem.github.io/contributions "PRs welcome!"
[conduct-link]: https://sikessem.github.io/code-of-conduct "Sikessem's Code of Conduct"
[discuss-link]: https://github.com/orgs/sikessem/discussions "Sikessem's GitHub discussions"
[docs-link]: https://sikessem.github.io/packages/tracer "Tracer Documentation"