Setting to delete when an object is destroyed

[cosmastech]

I know that there was a similar PR for for this a few years ago, but I figured I'd take a run at it.

This is not a breaking change. This adds a simple property so that the directory is deleted when __destruct() is called (which of course happens when the object is out of scope, the application ends, or the user calls unset() on a TemporaryDirectory instance).

function copyFiles(string $directoryName) {
    $temporaryDirectory = (new TemporaryDirectory('/tmp/'))
        ->name($directoryName)
        ->deleteWhenDestroyed()
        ->create();

    // ... do cool stuff with that temporary directory
}

copyFiles('this-will-be-gone');

file_exists('/tmp/this-will-be-gone'); // false

[openjck]

Wow, what good timing. Our team has a need for this, and I was just about to open an issue about it. I'll do a quick review. I can't merge this because I'm not associated with the author.

[openjck]

This looks good to me. The only thing missing might be an update to the documentation which provides an example.

[openjck]

That's interesting. I didn't know PHP could assign while passing an argument. I have to admit it confused me at first, though, and I'll leave it to @spatie to decide if it's a desirable practice.

[freekmurze]

@cosmastech could you also PR a simple example on how to use the new method to the readme? Thanks!

[cosmastech]

could you also PR a simple example on how to use the new method to the readme? Thanks!

#74 Done. @freekmurze