added php-doc comments

Author: kostant85

.gitignore

@@ -31,4 +31,5 @@ tests/_support/_generated
 
 # any root PHP files
 /*.php
-/examples/attachments/
+/examples/attachments/*
+!examples/attachments/.gitkeep

examples/attachments/.gitkeep

@@ -25,7 +25,7 @@
         'file' => [
             'fields' => ['cv_file', 'image_file'],
             'allowType' => ['jpeg', 'jpg', 'pdf', 'png'],
-            'allowSize' => 10000
+            'allowSize' => 10000000 //10 MB
         ]
 	], // acoording to Valitron doc.
 	'labels' => [

examples/form.php

@@ -5,25 +5,50 @@
 
 class File extends DataObject
 {
+    /**
+     * @var string
+     */
     public $name;
 
+    /**
+     * @var string
+     */
     public $type;
 
+    /**
+     * @var string
+     */
     public $tmp_name;
 
+    /**
+     * @var int
+     */
     public $error;
 
+    /**
+     * @var int
+     */
     public $size;
 
+    /**
+     * @var string
+     */
     public $uniqName;
 
+    /**
+     * File constructor.
+     * @param array $config
+     */
     public function __construct(array $config)
     {
         parent::__construct($config);
 
         $this->uniqName = sha1(uniqid(mt_rand(), true)) . '.' . $this->getExtension();
     }
 
+    /**
+     * @return mixed
+     */
     public function getExtension()
     {
         return pathinfo($this->name, PATHINFO_EXTENSION);

src/DataObjects/File.php

@@ -4,7 +4,7 @@
 
 class MailMessage extends DataObject
 {
-    const ATTACHMENTS_SIZE_LIMIT = 10;
+    const ATTACHMENTS_SIZE_LIMIT = 8000000;
 
 	/**
 	 * @var EmailAddress
@@ -186,52 +186,83 @@ public function getAltBody()
 
 	public function setFiles()
     {
+        $uploadFolder = $this->getFullPathOfUploadFolder();
+
+        if (!file_exists($uploadFolder)) {
+            mkdir($uploadFolder, 0777, true);
+        }
+
         foreach ($this->attachments as $file)
         {
-            $path = $this->getFullPathOfUploadFolder() . DIRECTORY_SEPARATOR . $file->name;
             /** @var File $file */
+            $path = $this->getFullPathOfUploadFolder() . DIRECTORY_SEPARATOR . $file->uniqName;
+            @chmod($path, 0666 & ~umask());
+
             if (move_uploaded_file($file->tmp_name, $path)) {
 
                 if ($file->size > self::ATTACHMENTS_SIZE_LIMIT) {
-                    $domainPath = $_SERVER['HTTP_ORIGIN'] . $this->getWebUploadFolder() .DIRECTORY_SEPARATOR . $file->name;
+                    $domainPath = $_SERVER['HTTP_ORIGIN'] . $this->getWebUploadFolder() .DIRECTORY_SEPARATOR . $file->uniqName;
                     $this->addFileLink([$domainPath => $file->name]);
                 } else {
                     $this->addFile([$path => $file->name]);
                 }
             }
         }
+
+        return true;
     }
 
+    /**
+     * @return array
+     */
     public function getFiles()
     {
         return $this->files;
     }
 
+    /**
+     * @param $data
+     */
     protected function addFile($data)
     {
         $this->files[] = new EmailAttachment($data);
     }
 
+    /**
+     * @param $data
+     */
     protected function addFileLink($data)
     {
         $this->fileLinks[] = new EmailAttachment($data);
     }
 
+    /**
+     * @return array
+     */
     public function getFileLinks()
     {
         return $this->fileLinks;
     }
 
+    /**
+     * @return string
+     */
     protected function getFullPathOfUploadFolder()
     {
         return __DIR__ . $this->getUploadFolder();
     }
 
+    /**
+     * @return string
+     */
     protected function getUploadFolder()
     {
         return '/../../examples' . $this->getWebUploadFolder();
     }
 
+    /**
+     * @return string
+     */
     protected function getWebUploadFolder()
     {
         return '/attachments';