Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gajus/bugger
Bugger is a collection of functions for debugging PHP code.
https://github.com/gajus/bugger
Last synced: about 1 month ago
JSON representation
Bugger is a collection of functions for debugging PHP code.
- Host: GitHub
- URL: https://github.com/gajus/bugger
- Owner: gajus
- License: other
- Created: 2014-01-12T15:55:45.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2014-06-14T17:45:14.000Z (over 10 years ago)
- Last Synced: 2024-10-19T00:18:37.398Z (about 2 months ago)
- Language: CSS
- Homepage:
- Size: 1.26 MB
- Stars: 77
- Watchers: 7
- Forks: 7
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- License: LICENSE
Awesome Lists containing this project
- awesome-security-collection - **78**星
README
# Bugger
[](https://travis-ci.org/gajus/bugger)
[](https://coveralls.io/r/gajus/bugger?branch=master)
[](https://packagist.org/packages/gajus/bugger)
[](https://packagist.org/packages/gajus/bugger)
Bugger is a collection of functions for debugging PHP code. Use it to:
* Dump information about a variable
* Set breakpoints in loops
Bugger is designed to be used when remote debugger is not available. It allows to dump information about a variable together with the debug backtrace (`trace` method), it allows to collect information about multiple variables during the script execution and dump them at the end of the script execution (`stack` method), as well as trap iterations (`tick` method).
## API
Bugger API is exposed to the global namespace via three functions:
### Trace
```php
/**
* Terminates the script, discards the output buffer, dumps information about the expression including backtrace up to the `trace` call.
*
* @param mixed $expression The variable you want to dump.
* @return null
*/
trace ( mixed $expression );
````
Trace is used to dump information about the expression including the backtrace information. Trace will attempt to discard existing output buffer. If output buffer cannot be discaded because it has been already sent to the browser, then Bugger will attempt to clear the previous output using client-side script.
### Stack
```php
/**
* Stacks information about the expression and dumps the stack at the end of the script execution.
*
* @param mixed $expression The variable you want to dump.
* @return null
*/
stack ( mixed $expression );
```
Stack is identical to `trace` except that calling `stack` will not terminate the script at the time of the call. If `stack` is called at least once during the script execution, then at the end of the script execution output buffer will be discarded and replaced with the collected `stack` dump, e.g.
```php
echo 'foo';
stack('a');
echo 'bar';
stack('b');
echo 'baz';
stack('c');
echo 'qux';
```
In the above example, 'foo', 'bar', 'baz' and 'qux' will be discarded.
### Tick
```php
/**
* Tracks the number of times tick function itself has been called and returns true
* when the desired number within the namespace is reached.
*
* @param int $true_after Number of the itteration after which response is true.
* @param string $namespace Itteration namespace.
* @return boolean
*/
tick ( int $true_after [, string $namespace = 'default' ] )
```
`tick` is used to catch script execution in loop or recursive calls. `tick` returns `true` when it has been executed a predefined number of times or more, e.g.
```php
while (true) {
if (tick(10)) {
// Tick will return true after 10 itterations.
break;
}
}
tick(4, 'test'); // false
tick(4, 'test'); // false
tick(4, 'test'); // false
tick(4, 'test'); // true
tick(4, 'test'); // true
tick(4, 'test'); // true
```
`tick` can be used together with `stack` or `trace` to capture the state of a particular itteration or multiple itterations.
## Installation
The recommended way to use Bugger is through Composer.
```json
{
"require": {
"gajus/bugger": "0.2.*"
}
}
```
If you want to use Bugger across the server, then use [auto_prepend_file](http://uk1.php.net/manual/en/ini.core.php#ini.auto-prepend-file) setting to load `./src/autoload.php`.
## Roadmap
* Support CLI.