Merge pull request #177 from mikehaertl/150-tmp-directory-option

Issue #150 Add tempDir option

Author: mikehaertl

README.md

@@ -31,7 +31,7 @@ A PDF conversion and form utility based on pdftk.
 
 > **Note** If you're on Ubuntu you may want to install the version from `ppa:malteworld/ppa`.
 > The default packages seems to use snap an there have been reports about file permission
-> issues with this version.
+> issues with this version. See below for a workaround.
 
 ## Installation
 
@@ -321,6 +321,16 @@ $pdf->fillForm(['name' => 'My Name'])
 $content = file_get_contents( (string) $pdf->getTmpFile() );
 ```
 
+If you have permission issues you may have to set a directory where your
+`pdftk` command can write to:
+
+```php
+use mikehaertl\pdftk\Pdf;
+
+$pdf = new Pdf('/path/my.pdf');
+$pdf->tempDir = '/home/john/temp';
+```
+
 ## API
 
 Please consult the source files for a full documentation of each method.

src/Pdf.php

@@ -26,6 +26,12 @@ class Pdf
      */
     public $ignoreWarnings = false;
 
+    /**
+     * @var null|string an optional directory where temporary files should be
+     * created. If left empty the directory is autodetected.
+     */
+    public $tempDir;
+
     /**
      * @var File the temporary output file
      */
@@ -252,7 +258,7 @@ public function fillForm($data, $encoding = 'UTF-8', $dropXfa = true, $format =
         $this->constrainSingleFile();
         if (is_array($data)) {
             $className = '\mikehaertl\pdftk\\' . ($format === 'xfdf' ? 'XfdfFile' : 'FdfFile');
-            $data = new $className($data, null, null, null, $encoding);
+            $data = new $className($data, null, null, $this->tempDir, $encoding);
         }
         $this->getCommand()
             ->setOperation('fill_form')
@@ -276,7 +282,7 @@ public function updateInfo($data, $encoding = 'UTF-8')
     {
         $this->constrainSingleFile();
         if (is_array($data)) {
-            $data = new InfoFile($data, null, null, null, $encoding);
+            $data = new InfoFile($data, null, null, $this->tempDir, $encoding);
         }
         $this->getCommand()
             ->setOperation($encoding == 'UTF-8' ? 'update_info_utf8' : 'update_info')
@@ -608,7 +614,7 @@ public function getCommand()
     public function getTmpFile()
     {
         if ($this->_tmpFile === null) {
-            $this->_tmpFile = new File('', '.pdf', self::TMP_PREFIX);
+            $this->_tmpFile = new File('', '.pdf', self::TMP_PREFIX, $this->tempDir);
         }
         return $this->_tmpFile;
     }

tests/PdfTest.php

@@ -583,6 +583,20 @@ public function testCanGetPdfContentAsString()
         $this->assertEquals(file_get_contents($file), $pdf->toString());
     }
 
+    public function testCanSetTemporaryDirectory()
+    {
+        $document = $this->getDocument1();
+        $file = $this->getOutFile();
+        $dir = dirname($file);
+
+        $pdf = new Pdf($document);
+        $pdf->tempDir = $dir;
+        $this->assertTrue($pdf->saveAs($file));
+
+        $tmpFile = (string) $pdf->getTmpFile();
+        $this->assertStringStartsWith($dir, $tmpFile);
+    }
+
     protected function getDocument1()
     {
         return __DIR__ . '/files/document1.pdf';