Fix: api docs (#50)

* Fix: api docs

* Fix: docs composer script

* Remove: phpdoc config file

apigen.yml

@@ -0,0 +1,5 @@
+parameters:
+    visibilityLevels: [public, protected]
+    annotationGroups: [todo, deprecated, note]
+    title: "Unit Converter API"
+    overwrite: true

composer.json

@@ -11,15 +11,16 @@
     }
   ],
   "scripts": {
-    "docs": "./dev/docs.sh && phpdoc --config=./phpdoc.xml",
+    "docs": "./dev/docs.sh",
     "test": "phpunit --configuration=./phpunit.xml --testsuite=fullspec --color=always",
     "unit": "phpunit --configuration=./phpunit.xml --testsuite=unit --color=always",
     "integration": "phpunit --configuration=./phpunit.xml --testsuite=integration --color=always"
   },
   "require": {},
   "require-dev": {
-    "phpdocumentor/phpdocumentor": "^2.9",
+    "apigen/apigen": "dev-master",
     "phpunit/phpunit": "^6.3",
+    "roave/better-reflection": "dev-master#c87d856",
     "symfony/var-dumper": "^3.3"
   },
   "autoload": {

dev/docs.sh

@@ -8,19 +8,16 @@
 #
 # $ chmod u+x ./dev/docs.sh
 
-DIRECTORY=./docs
+SOURCE=./src
+DESTINATION=./docs
 
-if [ -d $DIRECTORY ];
+if [ -d $DESTINATION ];
 then
   printf "Deleting old generated documentation .. "
-
-  rm -r $DIRECTORY/*
-
+  rm -r $DESTINATION/*
   echo "OK"
-
-  exit
 fi
 
 echo "No stale documentation to remove"
-
+php -d memory_limit=-1 -f ./vendor/bin/apigen generate $SOURCE --destination $DESTINATION
 exit

docs/.htaccess

@@ -0,0 +1,5 @@
+# Fixes a vulnerability in CentOS: http://stackoverflow.com/questions/20533279/prevent-php-from-parsing-non-php-files-such-as-somefile-php-txt
+<FilesMatch \.php\.txt$>
+    RemoveHandler .php
+    ForceType text/plain
+</FilesMatch>