fix #2 (set creation time)

Author: ddrv

docs/en.md

@@ -150,12 +150,21 @@ Use Converter class for create database
     192,2,"some info 7","some info 8"
     34,"unused row","some info 9","some info 10"
     ```
-2. Initialization converter
+1. Initialization converter
     ```php
     $tmpDir = 'path/to/dir/for/temporary/files';
     $converter = new \Ddrv\Iptool\Converter($tmpDir);
     ```
-3. Set author information
+    
+1. Set creation time.
+    ```php
+    /**
+     * $time - time in unixstamp format.
+     */
+    $converter->setTime(1507638600); // 2017/10/10 15:30:00
+    ```
+
+1. Set author information
     ```php
     /**
      * $author can be a string no longer than 64 characters.
@@ -164,7 +173,7 @@ Use Converter class for create database
     $converter->setAuthor($author);
     ```
 
-4. Set license of database
+1. Set license of database
     ```php
     /**
      * $license may be the name of a public license or the text of a license. The length is unlimited.
@@ -173,7 +182,7 @@ Use Converter class for create database
     $converter->setLicense($license);
     ```
 
-5. Add prepared files. Use the addCSV() method with parameters:
+1. Add prepared files. Use the addCSV() method with parameters:
     * unique key for file. Required;
     * path to csv file. Required;
     * count ignored first row (default 0);
@@ -186,7 +195,7 @@ Use Converter class for create database
     $converter->addCSV('networksCSV','/path/to/cvs/networks.csv',1);
     ```
 
-6. Define format of registers
+1. Define format of registers
     ```php
     $info = array(
         'interval' => array(
@@ -222,15 +231,15 @@ Use Converter class for create database
         ),
     );
     ```
-7. Add definite registers. Use the addRegister() method with parameters:
+1. Add definite registers. Use the addRegister() method with parameters:
     * Register name. Required;
     * unique key of CSV file (from method addCSV). Required;
     * number of ID column. The account is from 0;
     * definite format of register.
     ```php
     $converter->addRegister('info','infoCSV',0, $info);
     ```
-8. Define format of intervals
+1. Define format of intervals
     ```php
     $networks = array(
         /**
@@ -241,7 +250,7 @@ Use Converter class for create database
     );
     ```
 
-9. Add definite intervals. Use the addNetworks() method with parameters:
+1. Add definite intervals. Use the addNetworks() method with parameters:
     * unique key of intervals CSV file (from method addCSV). Required;
     * format IP address in CSV file. May be:
         * ip (for example, 123.123.123.123);
@@ -253,7 +262,7 @@ Use Converter class for create database
     ```php
     $converter->addNetworks('networksCSV', 'ip', 0, 1, $networks);
     ```
-10. Run compile database
+1. Run compile database
     ```php
     $errors = $converter->getErrors();
     if (!$errors) {

docs/ru.md

@@ -152,21 +152,28 @@ Array
     192,2,"some info 7","some info 8"
     34,"unused row","some info 9","some info 10"
     ```
-2. Инициализируйте конвертер.
+1. Инициализируйте конвертер.
     ```php
     $tmpDir = 'path/to/dir/for/temporary/files';
     $converter = new \Ddrv\Iptool\Converter($tmpDir);
     ```
-3. Укажите информацию об авторе БД.
+1. Укажите информацию об авторе БД.
     ```php
     /**
      * $author - строка длиной не более 64 символов.
      */
     $author = 'Name Surname';
     $converter->setAuthor($author);
     ```
+1. Укажите время создания БД.
+    ```php
+    /**
+     * $time - время в формате unixstamp.
+     */
+    $converter->setTime(1507638600); // 2017/10/10 15:30:00
+    ```
 
-4. Укажите лицензию базы данных.
+1. Укажите лицензию базы данных.
     ```php
     /**
      * $license - может быть название публичной лицензии, ссылка на лицензионное соглашение или же непосредственно текст лицензии. Длина не лимитирована.
@@ -175,7 +182,7 @@ Array
     $converter->setLicense($license);
     ```
 
-5. Добавьте подготовленные файлы. Воспользуйтесь методом addCSV() с параметрами:
+1. Добавьте подготовленные файлы. Воспользуйтесь методом addCSV() с параметрами:
     * уникальный идентификатор для файла. Обязательный параметр;
     * путь к  CSV файлу. Обязательный параметр;
     * количество игнорируемых строк с начала файла (по умолчанию 0);
@@ -188,7 +195,7 @@ Array
     $converter->addCSV('networksCSV','/path/to/cvs/networks.csv',1);
     ```
 
-6. Опишите формат справочника.
+1. Опишите формат справочника.
     ```php
     $info = array(
         'interval' => array(
@@ -224,15 +231,15 @@ Array
         ),
     );
     ```
-7. Добавьте определённый справочник. Воспользуйтесь методом addRegister() с параметрами:
+1. Добавьте определённый справочник. Воспользуйтесь методом addRegister() с параметрами:
     * название регистра. Обязательный параметр;
     * уникальная строка, идентифицирующая CSV файл (вы её определили при использовании метода addCSV). Обязательный параметр;
     * номер колонки, содержащей идентификатор строки. Счёт колонок начинается с 0;
     * описанный формат справочника.
     ```php
     $converter->addRegister('info','infoCSV',0, $info);
     ```
-8. Определите формат интервалов адресов.
+1. Определите формат интервалов адресов.
     ```php
     $networks = array(
         /**
@@ -243,7 +250,7 @@ Array
     );
     ```
 
-9. Добавьте интервалы адресов. Вызовите метод addNetworks() с параметрами:
+1. Добавьте интервалы адресов. Вызовите метод addNetworks() с параметрами:
     * уникальная строка, идентифицирующая CSV файл (вы её определили при использовании метода addCSV). Обязательный параметр;
     * формат IP адреса в CSV файле. Может быть:
         * ip (если IP представлены в обычном формате. Например, 123.123.123.123);
@@ -255,7 +262,7 @@ Array
     ```php
     $converter->addNetworks('networksCSV', 'ip', 0, 1, $networks);
     ```
-10. Запустите компиляцию БД
+1. Запустите компиляцию БД
     ```php
     $errors = $converter->getErrors();
     if (!$errors) {

src/Converter.php

@@ -7,6 +7,7 @@
 /**
  * Class Converter
  *
+ * @property integer $time
  * @property string  $author
  * @property string  $license
  * @property string  $temporaryDir
@@ -30,6 +31,11 @@ class Converter
      */
     const VERSION = '1';
 
+    /**
+     * @var integer
+     */
+    protected $time = 0;
+
     /**
      * @var string
      */
@@ -226,6 +232,20 @@ public function setAuthor($author)
         $this->author = $author;
     }
 
+    /**
+     * Set creation time of database
+     *
+     * @param integer $time
+     */
+    public function setTime($time)
+    {
+        $time = (int)$time;
+        if ($time < 0) {
+            $time = 0;
+        }
+        $this->time = $time;
+    }
+
     /**
      * Set license of database
      *
@@ -456,8 +476,8 @@ public function create($file)
             /* Remove register temporary file */
             if (is_writable($register)) unlink($register);
         }
-
-        fwrite($database,pack('N1A128',time(),$this->author));
+        $time = empty($this->time)?time():$this->time;
+        fwrite($database,pack('N1A128',$time,$this->author));
         fwrite($database,pack('A*',$this->license));
         fclose($database);
         return;