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

https://github.com/sikessem/debugger

πŸ› Debug a PHP script easily by following its backtrace.
https://github.com/sikessem/debugger

backtrace debug php tracer

Last synced: 3 months ago
JSON representation

πŸ› Debug a PHP script easily by following its backtrace.

Awesome Lists containing this project

README

          

[![sikessem-logo]][sikessem-link]


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

[sikessem-logo]: https://github.com/sikessem/art/blob/HEAD/images/sikessem.svg
[sikessem-link]: https://github.com/sikessem "Sikessem"

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

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

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

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

[pr-icon]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg?color=brightgreen
[pr-link]: https://github.com/sikessem/.github/blob/HEAD/CONTRIBUTING.md "PRs welcome!"

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

[license-icon]: https://img.shields.io/badge/license-MIT-blue.svg
[license-link]: https://github.com/sikessem/debugger/blob/HEAD/LICENSE "Debugger License"
[conduct-link]: https://github.com/sikessem/debugger/blob/HEAD/CODE_OF_CONDUCT.md
[discuss-link]: https://github.com/orgs/sikessem/discussions
[docs-link]: https://github.com/sikessem/debugger#readme "Debugger Documentation"

***

# πŸ› Sikessem Debugger

Debug a PHP script easily by following its backtrace.

## πŸ”– Contents

- [πŸ› Sikessem Debugger](#-sikessem-debugger)
- [πŸ”– Contents](#-contents)
- [πŸ“‹ Requirements](#-requirements)
- [πŸŽ‰ Getting Started](#-getting-started)
- [⚑️ Installation](#️-installation)
- [πŸ§‘β€πŸ’» Usage](#-usage)
- [πŸ“– Documentation](#-documentation)
- [πŸ‘ Contribution](#-contribution)
- [πŸ‘· Code of Conduct](#-code-of-conduct)
- [πŸ‘₯ Contributing Guide](#-contributing-guide)
- [πŸ”’οΈ Good First Issues](#️-good-first-issues)
- [πŸ’¬ Discussions](#-discussions)
- [πŸ” Security Reports](#-security-reports)
- [πŸ“„ License](#-license)

## πŸ“‹ Requirements

> - **Requires [PHP 8.1+](https://php.net/releases/)** (at least 8.1.19 recommended to avoid potential bugs).
> - **Requires [Composer v2+](https://getcomposer.org/)** to manage PHP dependencies.

## πŸŽ‰ Getting Started

### ⚑️ Installation

Install [Debugger](https://packagist.org/packages/sikessem/debugger) using [Composer](https://getcomposer.org/):

- By adding the `sikessem/debugger` dependency to your `composer.json` file:

```json
{
"require" : {
"sikessem/debugger": "self.version"
}
}
```

- Or by including the dependency:

```bash
composer require sikessem/debugger --no-dev
```

### πŸ§‘β€πŸ’» Usage

```php
getStack(); // Returns the trace stack

$trace->getDirectory(); // Returns the trace directory

$trace->getFile(); // Returns the trace file

$trace->getLine(); // Returns the trace line

$trace->getClass(); // Returns the trace class

$trace->getObject(); // Returns the trace object

$trace->getFunction(); // Returns the trace function

$trace->getType(); // Returns the trace type

$trace->getArgs(); // Returns the trace args

var_dump($trace); // Dumps the trace stack
```

## πŸ“– Documentation

The full documentation for the Sikessem Debugger can be found on [this address][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 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/debugger/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 [Sikessem][sikessem-link], please email [SIGUI KessΓ© Emmanuel](https://sigui.ci) at [contact@sigui.ci](mailto:contact@sigui.ci). All security vulnerabilities will be promptly addressed.

## πŸ“„ License

The Sikessem Debugger 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.