Issue #13 FoxPro memo field bugfix (#14)

* #13 - fix fox pro memo loading

* #13 add throw annotations, doc etc

* #13 foxpro write

* #13 fix

* #13 fix travis

* #13 fix

* #13 fix

* #13 fix

* #13 disable travis php 7.3

Author: majkel89

.gitignore

@@ -3,3 +3,4 @@
 *.tar
 *.copy*
 /composer.lock
+/tests/fixtures/materie-2.*

.travis.yml

@@ -1,11 +1,12 @@
 language: php
 php:
-    - 5.6
-    - 5.5
     - 5.4
+    - 5.5
+    - 5.6
     - 7.0
     - 7.1
     - 7.2
+#    - 7.3
     - hhvm
     - nightly
 

DEVELOP.md

@@ -41,3 +41,5 @@ http://www.clicketyclick.dk/databases/xbase/format/dbf.html#DBF_STRUCT
 http://www.dbase.com/Knowledgebase/INT/db7_file_fmt.htm
 
 http://www.digitalpreservation.gov/formats/fdd/fdd000325.shtml
+
+http://web.tiscali.it/SilvioPitti/

src/Builder.php

@@ -83,6 +83,7 @@ public static function fromTable(Table $table) {
     /**
      * @param string $filePath
      * @return \org\majkel\dbase\Builder
+     * @throws Exception
      */
     public static function fromFile($filePath) {
         return self::fromTable(Table::fromFile($filePath, Table::MODE_READ));
@@ -120,6 +121,7 @@ public function setMemoType($memoType) {
     /**
      * @param string $filePath
      * @return Table
+     * @throws Exception
      */
     public function build($filePath) {
         $header = $this->getHeader();

src/File.php

@@ -34,6 +34,7 @@ public function getSize() {
      * @param string $mode
      * @param string $class
      * @return \SplFileObject
+     * @throws \ReflectionException
      */
     public static function getObject($path, $mode, $class = '\org\majkel\dbase\File') {
         $reflection = new ReflectionClass($class);

src/Format.php

@@ -37,7 +37,7 @@ abstract class Format {
 
     /** @var \SplFileObject File handle */
     protected $file;
-    /** @var \SplFileObject File handle */
+    /** @var \org\majkel\dbase\memo\MemoInterface File handle */
     protected $memoFile;
     /** @var \org\majkel\dbase\Header */
     protected $header;
@@ -53,6 +53,7 @@ abstract class Format {
     /**
      * @param string $filePath
      * @param string $mode
+     * @throws \ReflectionException
      */
     public function __construct($filePath, $mode) {
         $this->mode = $mode;
@@ -61,6 +62,7 @@ public function __construct($filePath, $mode) {
 
     /**
      * @return \org\majkel\dbase\Header
+     * @throws Exception
      */
     public function getHeader() {
         if (is_null($this->header)) {
@@ -71,6 +73,7 @@ public function getHeader() {
 
     /**
      * @return boolean
+     * @throws Exception
      */
     public function isValid() {
         return $this->getHeader()->isValid();
@@ -85,6 +88,7 @@ public function getFileInfo() {
 
     /**
      * @return \SplFileInfo
+     * @throws Exception
      */
     public function getMemoFileInfo() {
         return $this->getMemo()->getFileInfo();
@@ -100,6 +104,7 @@ public function getName() {
     /**
      * @param integer $index
      * @return Record
+     * @throws Exception
      */
     public function getRecord($index) {
         $records = $this->getRecords($index, 1);
@@ -117,13 +122,18 @@ public function getRecords($index, $length) {
         list($start, $stop) = $this->getReadBoundaries($index, $length);
         $file = $this->getFile();
         $rSz = $this->getHeader()->getRecordSize();
-        $file->fseek($this->getHeader()->getHeaderSize() + $start * $rSz);
+        $offset = $this->getHeader()->getHeaderSize() + $start * $rSz;
+        $file->fseek($offset);
         $format = $this->getRecordFormat();
         $allData = $file->fread($rSz * $length);
         $records = array();
         for ($i = 0; $start < $stop; ++$start, ++$i) {
-            $data = unpack($format, strlen($allData) === $rSz
-                ? $allData : substr($allData, $i * $rSz, $rSz));
+            if (strlen($allData) === $rSz) {
+                $recordData = $allData;
+            } else {
+                $recordData = substr($allData, $i * $rSz, $rSz);
+            }
+            $data = unpack($format, $recordData);
             $records[$start] = $this->createRecord($data);
         }
         return $records;
@@ -227,8 +237,8 @@ public function isTransaction() {
     }
 
     /**
-     * @return HeaderInterface
      * @return boolean
+     * @throws Exception
      */
     protected function checkIfTransaction() {
         $currentHeader = $this->readHeader();
@@ -241,6 +251,7 @@ protected function checkIfTransaction() {
 
     /**
      * @param boolean $enabled
+     * @throws Exception
      */
     protected function setTransactionStatus($enabled) {
         $enabled = (boolean) $enabled;
@@ -312,6 +323,7 @@ public function markDeleted($index, $deleted) {
 
     /**
      * @return string
+     * @throws Exception
      */
     protected function getWriteRecordFormat() {
         if (is_null($this->writeRecordFormat)) {
@@ -351,6 +363,7 @@ protected function serializeRecord(Record $record) {
     /**
      * @param integer $index
      * @return integer
+     * @throws Exception
      */
     private function getRecordOffset($index) {
         return $index * $this->getHeader()->getRecordSize() + $this->getHeader()->getHeaderSize();
@@ -359,6 +372,7 @@ private function getRecordOffset($index) {
     /**
      * @param \org\majkel\dbase\Record $data
      * @return integer
+     * @throws Exception
      */
     public function insert(Record $data) {
         $header = $this->getHeader();
@@ -378,9 +392,10 @@ public function insert(Record $data) {
     }
 
     /**
-     * @param integer $index
+     * @param integer                  $index
      * @param \org\majkel\dbase\Record $data
      * @return void
+     * @throws Exception
      */
     public function update($index, Record $data) {
         list($offset) = $this->getReadBoundaries($index, 0);
@@ -405,6 +420,7 @@ protected function getWriteHeaderFormat() {
 
     /**
      * @return void
+     * @throws Exception
      */
     protected function writeHeader() {
         $file = $this->getFile();
@@ -427,6 +443,7 @@ protected function writeHeader() {
 
     /**
      * @return Header
+     * @throws Exception
      */
     protected function readHeader() {
         $file = $this->getFile();
@@ -497,6 +514,7 @@ protected function createField($data) {
 
     /**
      * @return string
+     * @throws Exception
      */
     protected function getRecordFormat() {
         if (is_null($this->recordFormat)) {
@@ -512,6 +530,7 @@ protected function getRecordFormat() {
     /**
      * @param integer $index
      * @return string
+     * @throws Exception
      */
     protected function readMemoEntry($index) {
         return $this->getMemo()->getEntry($index);
@@ -520,6 +539,7 @@ protected function readMemoEntry($index) {
     /**
      * @param array $data
      * @return \org\majkel\dbase\Record
+     * @throws Exception
      */
     protected function createRecord($data) {
         $record = new Record;
@@ -553,6 +573,7 @@ abstract public function getType();
     /**
      * @param \org\majkel\dbase\Header $header
      * @return $this
+     * @throws Exception
      */
     public function create(Header $header) {
         $this->getFile()->ftruncate(0);
@@ -575,6 +596,7 @@ public function create(Header $header) {
 
     /**
      * @return integer
+     * @throws Exception
      */
     protected function calculateRecordSize() {
         $result = 1;
@@ -586,6 +608,7 @@ protected function calculateRecordSize() {
 
     /**
      * @return integer
+     * @throws Exception
      */
     protected function calculateHeaderSize() {
         $result = self::HEADER_SIZE + $this->getHeader()->getFieldsCount() * self::FIELD_SIZE + 2;
@@ -601,6 +624,7 @@ protected function getWriteFieldFormat() {
 
     /**
      * @return void
+     * @throws Exception
      */
     protected function writeRecords() {
         $file = $this->getFile();

src/Header.php

@@ -297,13 +297,15 @@ public function offsetSet($offset, $value) {
 
     /**
      * @param integer $offset
+     * @throws Exception
      */
     public function offsetUnset($offset) {
         $this->removeField($offset);
     }
 
     /**
      * {@inheritdoc}
+     * @throws Exception
      */
     public function getField($name) {
         if ($this->offsetExists($name)) {