README

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, enabling precise and expressive debugging in modern PHP.

Read the documentation to learn more.

📖 Documentation

The full documentation for the Sikessem Tracer can be found here.

👏 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

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

👥 Contributing Guide

Read our Contributing Guide 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 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.

💬 Discussions

Larger discussions and proposals are discussed in Sikessem's GitHub discussions.

🔐 Security Reports

If you discover a security vulnerability within any of Sikessem's projects, please email SIGUI Kessé Emmanuel at siguici@proton.me. All security vulnerabilities will be promptly addressed.

📄 License

The Sikessem Tracer is open-sourced software licensed under the MIT License - see the LICENSE file for details.