Add $delete to optionally keep the tmp file after destruction

Author: mikehaertl

README.md

@@ -13,7 +13,7 @@ A convenience class for temporary files.
 ## Features
 
  * Create temporary file with arbitrary content
- * Delete file after use
+ * Delete file after use (can be disabled)
  * Send file to client, either inline or with save dialog
  * Save file locally
 
@@ -36,3 +36,12 @@ echo $file->getFileName();
 echo $file->getTempDir();
 ```
 
+If you want to keep the temporary file, e.g. for debugging, you can set the `$delete` property to false:
+
+```php
+<?php
+use mikehaertl\tmp\File;
+
+$file = new File('some content', '.html');
+$file->delete = false;
+```

src/File.php

@@ -7,11 +7,17 @@
  * A convenience class for temporary files.
  *
  * @author Michael Härtl <haertl.mike@gmail.com>
- * @version 1.0.1-dev
+ * @version 1.1.0
  * @license http://www.opensource.org/licenses/MIT
  */
 class File
 {
+    /**
+     * @var bool whether to delete the tmp file when it's no longer referenced or when the request ends.
+     * Default is `true`.
+     */
+    public $delete = true;
+
     /**
      * @var string the name of this file
      */
@@ -45,11 +51,13 @@ public function __construct($content, $suffix = null, $prefix = null, $directory
     }
 
     /**
-     * Delete tmp file on shutdown
+     * Delete tmp file on shutdown if `$delete` is `true`
      */
     public function __destruct()
     {
-        unlink($this->_fileName);
+        if ($this->delete) {
+            unlink($this->_fileName);
+        }
     }
 
     /**

tests/FileTest.php

@@ -55,13 +55,32 @@ public function testCanSaveFileAs()
         $tmp = new File($content);
         $fileName = $tmp->getFileName();
 
+        $this->assertFileExists($fileName);
         $this->assertTrue($tmp->saveAs($out));
         $this->assertFileExists($out);
         $readContent = file_get_contents($out);
         $this->assertEquals($content, $readContent);
         unset($tmp);
         $this->assertFileNotExists($fileName);
         $this->assertFileExists($out);
+        unlink($out);
+    }
+
+    public function testCanKeepTempFile()
+    {
+        $out = __DIR__.'/test.txt';
+        $content = 'test content';
+        $tmp = new File($content);
+        $tmp->delete = false;
+        $fileName = $tmp->getFileName();
+
+        $this->assertFileExists($fileName);
+        $this->assertTrue($tmp->saveAs($out));
+        $this->assertFileExists($out);
+        unset($tmp);
+        $this->assertFileExists($fileName);
+        $this->assertFileExists($out);
+        unlink($out);
     }
 
     public function testCanCastToFileName()