Add php-cs-fixer with @PSR2 ruleset and additional rules for better readability along with automated file header copyright

.gitignore

@@ -6,4 +6,5 @@ composer.phar
 /phpunit.xml
 /build.properties
 /docs
-.phpunit.*.cache
+.phpunit.*.cache
+/.php-cs-fixer.cache

.php-cs-fixer.php

@@ -0,0 +1,88 @@
+<?php
+
+/**
+ * Hivelvet open source platform - https://riadvice.tn/
+ *
+ * Copyright (c) 2022 RIADVICE SUARL and by respective authors (see below).
+ *
+ * This program is free software; you can redistribute it and/or modify it under the
+ * terms of the GNU Lesser General Public License as published by the Free Software
+ * Foundation; either version 3.0 of the License, or (at your option) any later
+ * version.
+ *
+ * Hivelvet is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+ * PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License along
+ * with Hivelvet; if not, see <http://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+$header = <<<'EOF'
+Copyright (c) 2013-2024, OVH SAS.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+  * Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+  * Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+  * Neither the name of OVH SAS nor the
+    names of its contributors may be used to endorse or promote products
+    derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY OVH SAS AND CONTRIBUTORS ``AS IS'' AND ANY
+EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL OVH SAS AND CONTRIBUTORS BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+EOF;
+
+$finder = PhpCsFixer\Finder::create()
+    ->files()
+    ->name(['*.php'])
+    ->in(__DIR__ . '/src')
+    ->in(__DIR__ . '/tests');
+
+$config = new PhpCsFixer\Config();
+$config
+    ->setRiskyAllowed(true)
+    ->setRules([
+        '@PhpCsFixer' => true,
+        '@PSR2' => true,
+        'header_comment' => ['header' => $header],
+        'no_empty_comment' => true,
+        'no_trailing_whitespace_in_comment' => true,
+        'ordered_interfaces' => true,
+        'concat_space' => ['spacing' => 'one'],
+        'function_declaration' => ['closure_function_spacing' => 'none'],
+        'single_line_comment_style' => ['comment_types' => ['hash']],
+        'constant_case' => ['case' => 'lower'],
+        'single_quote' => true,
+        'array_syntax' => ['syntax' => 'short'],
+        'class_definition' => [
+            'single_line' => false,
+        ],
+        'braces' => [
+            'position_after_functions_and_oop_constructs' => 'next',
+            'position_after_control_structures' => 'same',
+            'position_after_anonymous_constructs' => 'same',
+        ],
+        'binary_operator_spaces' => ['operators' =>
+            ['=>' => 'align_single_space_minimal', '=' => 'align_single_space_minimal']
+        ],
+        'single_line_empty_body' => false,
+    ])
+    ->setFinder($finder);
+
+return $config;

composer.json

@@ -22,6 +22,7 @@
         "ext-json": "*"
     },
     "require-dev": {
+        "friendsofphp/php-cs-fixer": "^v3.54.0",
         "php-parallel-lint/php-parallel-lint": "^1.3.1",
         "phpdocumentor/shim": "^3",
         "phpunit/phpunit": "^9.5",
@@ -36,6 +37,7 @@
         }
     },
     "scripts": {
+        "cs-fix": "PHP_CS_FIXER_IGNORE_ENV=1 ./vendor/bin/php-cs-fixer fix",
         "phpdoc": "vendor/bin/phpdoc",
         "phpcs": "vendor/bin/phpcs -sp --colors",
         "phpcbf": "vendor/bin/phpcbf -sp",