Merge branch 'QA'

Signed-off-by: William Desportes <williamdes@wdes.fr>

Author: williamdes

.travis.yml

@@ -34,10 +34,10 @@ matrix:
       before_install: phpenv config-rm xdebug.ini
       after_success: skip
       install:
-        - composer global require "sami/sami:^4.0"
+        - composer global require "code-lts/doctum:^5.0"
         - composer install --no-interaction
       script:
-        - $HOME/.composer/vendor/bin/sami.php --no-interaction update ./tools/sami-config.php
+        - $HOME/.composer/vendor/bin/doctum.php --no-interaction update ./tools/doctum-config.php
     - php: nightly
       install:
         - composer install --no-interaction --ignore-platform-reqs

phpcs.xml.dist

@@ -11,7 +11,7 @@
     <file>tests</file>
     <file>tools</file>
 
-    <exclude-pattern>tools/sami-config.php</exclude-pattern>
+    <exclude-pattern>tools/doctum-config.php</exclude-pattern>
 
     <rule ref="PhpMyAdmin">
         <exclude name="SlevomatCodingStandard.ControlStructures.EarlyExit.EarlyExitNotUsed"/>

phpstan.neon.dist

@@ -10,4 +10,4 @@ parameters:
     reportUnmatchedIgnoredErrors: true
     inferPrivatePropertyTypeFromConstructor: true
     excludes_analyse:
-        - tools/sami-config.php
+        - tools/doctum-config.php

tools/doctum-config.php

@@ -0,0 +1,23 @@
+<?php
+/**
+ * This file has been generated by phpmyadmin/scripts/develdocs/build.sh
+ * @see https://github.com/phpmyadmin/scripts/blob/master/develdocs/doctum.php
+ * @see https://github.com/phpmyadmin/scripts/blob/master/develdocs/build.sh
+ */
+use Doctum\Doctum;
+use Symfony\Component\Finder\Finder;
+use Doctum\RemoteRepository\GitHubRemoteRepository;
+
+$root = realpath(__DIR__ . '/../') . '/';
+
+$iterator = Finder::create()
+    ->files()
+    ->name('*.php')
+    ->in($root . 'src');
+
+return new Doctum($iterator, [
+    'title'                => json_decode(file_get_contents($root . 'composer.json'))->description,
+    'build_dir'            => $root . 'build/apidocs/',
+    'cache_dir'            => $root . 'tmp/',
+    'remote_repository'    => new GitHubRemoteRepository('phpmyadmin/sql-parser', $root),
+]);