[NEW] Introduced CopyFileException.

Author: Roman Syroeshko

CHANGELOG.md

@@ -44,7 +44,7 @@ This release added form fields (textinput, checkbox, and dropdown), drawing shap
 - PclZip: Remove temporary file after used - @andrew-kzoo GH-265
 - Autoloader: Add the ability to set the autoloader options - @bskrtich GH-267
 - Element: Refactor elements to move set relation Id from container to element - @ivanlanin
-- Introduced CreateTemporaryFileException - @RomanSyroeshko
+- Introduced CreateTemporaryFileException, CopyFileException - @RomanSyroeshko
 
 ## 0.11.1 - 2 June 2014
 

src/PhpWord/Exception/CopyFileException.php

@@ -0,0 +1,39 @@
+<?php
+/**
+ * This file is part of PHPWord - A pure PHP library for reading and writing
+ * word processing documents.
+ *
+ * PHPWord is free software distributed under the terms of the GNU Lesser
+ * General Public License version 3 as published by the Free Software Foundation.
+ *
+ * For the full copyright and license information, please read the LICENSE
+ * file that was distributed with this source code. For the full list of
+ * contributors, visit https://github.com/PHPOffice/PHPWord/contributors.
+ *
+ * @link        https://github.com/PHPOffice/PHPWord
+ * @copyright   2010-2014 PHPWord contributors
+ * @license     http://www.gnu.org/licenses/lgpl.txt LGPL version 3
+ */
+
+namespace PhpOffice\PhpWord\Exception;
+
+/**
+ * @since 0.12.0
+ */
+final class CopyFileException extends Exception
+{
+    /**
+     * @param string $source The fully qualified source file name.
+     * @param string $destination The fully qualified destination file name.
+     * @param integer $code The user defined exception code.
+     * @param \Exception $previous The previous exception used for the exception chaining.
+     */
+    final public function __construct($source, $destination, $code = 0, \Exception $previous = null)
+    {
+        parent::__construct(
+            sprintf('Could not copy \'%s\' file to \'%s\'.', $source, $destination),
+            $code,
+            $previous
+        );
+    }
+}

src/PhpWord/Template.php

@@ -17,6 +17,7 @@
 
 namespace PhpOffice\PhpWord;
 
+use PhpOffice\PhpWord\Exception\CopyFileException;
 use PhpOffice\PhpWord\Exception\CreateTemporaryFileException;
 use PhpOffice\PhpWord\Exception\Exception;
 use PhpOffice\PhpWord\Shared\String;
@@ -58,11 +59,11 @@ class Template
     /**
      * Create a new Template Object
      *
-     * @since 0.12.0 Throws CreateTemporaryFileException instead of Exception.
+     * @since 0.12.0 Throws CreateTemporaryFileException and CopyFileException instead of Exception.
      *
      * @param string $strFilename
      * @throws \PhpOffice\PhpWord\Exception\CreateTemporaryFileException
-     * @throws \PhpOffice\PhpWord\Exception\Exception
+     * @throws \PhpOffice\PhpWord\Exception\CopyFileException
      */
     public function __construct($strFilename)
     {
@@ -72,8 +73,8 @@ public function __construct($strFilename)
         }
 
         // Copy the source File to the temp File
-        if (!copy($strFilename, $this->tempFileName)) {
-            throw new Exception("Could not copy the template from {$strFilename} to {$this->tempFileName}.");
+        if (false === copy($strFilename, $this->tempFileName)) {
+            throw new CopyFileException($strFilename, $this->tempFileName);
         }
 
         $this->zipClass = new ZipArchive();

src/PhpWord/Writer/AbstractWriter.php

@@ -17,6 +17,7 @@
 
 namespace PhpOffice\PhpWord\Writer;
 
+use PhpOffice\PhpWord\Exception\CopyFileException;
 use PhpOffice\PhpWord\Exception\Exception;
 use PhpOffice\PhpWord\PhpWord;
 use PhpOffice\PhpWord\Shared\ZipArchive;
@@ -233,14 +234,16 @@ protected function getTempFile($filename)
 
     /**
      * Cleanup temporary file
+     *
+     * @throws \PhpOffice\PhpWord\Exception\CopyFileException
      */
     protected function cleanupTempFile()
     {
         if ($this->originalFilename != $this->tempFilename) {
             // @codeCoverageIgnoreStart
             // Can't find any test case. Uncomment when found.
-            if (copy($this->tempFilename, $this->originalFilename) === false) {
-                throw new Exception("Could not copy temporary zip file.");
+            if (false === copy($this->tempFilename, $this->originalFilename)) {
+                throw new CopyFileException($this->tempFilename, $this->originalFilename);
             }
             // @codeCoverageIgnoreEnd
             @unlink($this->tempFilename);

tests/PhpWord/Tests/Exception/CopyFileExceptionTest.php

@@ -0,0 +1,39 @@
+<?php
+/**
+ * This file is part of PHPWord - A pure PHP library for reading and writing
+ * word processing documents.
+ *
+ * PHPWord is free software distributed under the terms of the GNU Lesser
+ * General Public License version 3 as published by the Free Software Foundation.
+ *
+ * For the full copyright and license information, please read the LICENSE
+ * file that was distributed with this source code. For the full list of
+ * contributors, visit https://github.com/PHPOffice/PHPWord/contributors.
+ *
+ * @link        https://github.com/PHPOffice/PHPWord
+ * @copyright   2010-2014 PHPWord contributors
+ * @license     http://www.gnu.org/licenses/lgpl.txt LGPL version 3
+ */
+
+namespace PhpOffice\PhpWord\Tests\Exception;
+
+use PhpOffice\PhpWord\Exception\CopyFileException;
+
+/**
+ * @covers \PhpOffice\PhpWord\Exception\CopyFileException
+ * @coversDefaultClass \PhpOffice\PhpWord\Exception\CopyFileException
+ */
+class CopyFileExceptionTest extends \PHPUnit_Framework_TestCase
+{
+    /**
+     * CopyFileException can be thrown.
+     *
+     * @covers            ::__construct()
+     * @expectedException \PhpOffice\PhpWord\Exception\CopyFileException
+     * @test
+     */
+    public function testCopyFileExceptionCanBeThrown()
+    {
+        throw new CopyFileException('C:\source\dummy.txt', 'C:\destination\dummy.txt');
+    }
+}