tissue

Create Github issues from your catch {} blocks. I was heavily inspired by ohCrash., _(*2)

When you call Tissue::create, a Github issue is created in the repo of your choice and a "bug" label is automatically applied. Duplicates are detected, to a certain extent., _(*3)

The name comes from "Throw ISSUE" — genius, I know., _(*4)

Install

``` bash $ composer require bouiboui/tissue, _(*5)


Create a local ``config/config.yaml`` file from the template in [``config/config.yaml.dist``](https://github.com/bouiboui/tissue/blob/master/config/config.yaml.dist)

## Usage

**The easy way: `bindUncaughtExceptionHandler`**
``` php
// Not shown: include composer's autoload.php
use bouiboui\Tissue\Tissue;

// All uncaught exceptions will trigger the creation of a Github issue
Tissue::bindUncaughtExceptionHandler();

The catch-block-specific way: createFromException ``` php // Not shown: include composer's autoload.php use bouiboui\Tissue\Tissue;, _(*6)

try {, _(*7)

throw new ErrorException('This is your issue title and message.');

} catch (\ErrorException $e) {, _(*8)

// Only exceptions caught by this block will create Github issues
$result = Tissue::createFromException($e);

}, _(*9)


**The "customized output" way: `create`**
``` php
// Not shown: include composer's autoload.php
use bouiboui\Tissue\Tissue;

try {

    throw new ErrorException('This is your issue title and message.');

} catch (\ErrorException $e) {

    // Set any parameter to null if you don't want to display it in the issue
    $result = Tissue::create(
        $e->getMessage(),
        $e->getCode(),
        $e->getSeverity(),
        $e->getFile(),
        $e->getLine(),
        $e->getTraceAsString()
    );

    var_dump($result);

}

Creates the following issue:, _(*10)

Something like this , _(*11)

And outputs the following:, _(*12)

php array(3) { ["duplicate"]=> bool(false) ["number"]=> int(35) ["url"]=> string(50) "https://api.github.com/repos/author/name/issues/35" }, _(*13)

For security purposes, if your Github repository is public you should at the very least disable the trace parameter, unless you want strangers on the Internet to know the full path to the files on your server. You may also want to read this., _(*14)