Update PHP CS Fixer configuration, enhance type declarations, and improve documentation

Author: Vítězslav Dvořák

.php-cs-fixer.dist.php

@@ -15,7 +15,7 @@
 
 use Ergebnis\PhpCsFixer\Config\Factory;
 use Ergebnis\PhpCsFixer\Config\Rules;
-use Ergebnis\PhpCsFixer\Config\RuleSet\Php74;
+use Ergebnis\PhpCsFixer\Config\RuleSet\Php81;
 
 $header = <<<'HEADER'
 This file is part of the PohodaSQL package
@@ -28,7 +28,7 @@
 file that was distributed with this source code.
 HEADER;
 
-$ruleSet = Php74::create()->withHeader($header)->withRules(Rules::fromArray([
+$ruleSet = Php81::create()->withHeader($header)->withRules(Rules::fromArray([
     'blank_line_before_statement' => [
         'statements' => [
             'break',

composer.json

@@ -10,7 +10,7 @@
     ],
     "minimum-stability": "dev",
     "require": {
-        "vitexsoftware/ease-fluentpdo": "dev-main"
+        "vitexsoftware/ease-fluentpdo": "^1.4"
     },
     "autoload": {
         "psr-4": {
@@ -25,9 +25,9 @@
     "require-dev": {
         "phpunit/phpunit": "*",
         "phpstan/phpstan": "*",
-        "friendsofphp/php-cs-fixer": "^3.61",
-        "ergebnis/composer-normalize": "^2.43",
-        "ergebnis/php-cs-fixer-config": "^6.34"
+        "friendsofphp/php-cs-fixer": "^3.84",
+        "ergebnis/composer-normalize": "^2.47",
+        "ergebnis/php-cs-fixer-config": "^6.50"
     },
     "config": {
         "allow-plugins": {

debian/changelog

@@ -1,5 +1,12 @@
-php-spojenet-pohoda-sql (0.2.0) UNRELEASED; urgency=low
+php-spojenet-pohoda-sql (0.2.1) UNRELEASED; urgency=medium
 
+  * many changes
+
+ -- Vitex <[email protected]>  Fri, 25 Jul 2025 12:10:10 +0200
+
+php-spojenet-pohoda-sql (0.2.0) unstable; urgency=low
+
+  [ Vítězslav Dvořák ]
   * Initial release. Closes: #nnnn
 
- -- Vítězslav Dvořák <info@vitexsoftware.cz>  Fri, 08 Dec 2023 15:02:05 +0100
+ -- Vitex <vitezslav.dvorak@spojenet.cz>  Fri, 25 Jul 2025 12:09:56 +0200

src/SpojeNet/PohodaSQL/Adresar.php

@@ -32,7 +32,7 @@ class Adresar extends Agenda
      *
      * @const array
      */
-    public $struct = [
+    public array $struct = [
         'ID' => [
             'type' => 'int',
             'size' => '10',

src/SpojeNet/PohodaSQL/Agenda.php

@@ -118,7 +118,7 @@ class Agenda extends \Ease\SQL\Engine
      *
      * @const array
      */
-    public $struct = [];
+    public array $struct = [];
 
     /**
      * DatSave column name.
@@ -131,14 +131,15 @@ class Agenda extends \Ease\SQL\Engine
      * @param array $options Object Options (dbType,server,username,password,database,
      *                       port,connectionSettings,myTable,debug)
      */
-    public function setUp($options = []): bool
+    public function setUp(array $options = []): bool
     {
         $this->setKeyColumn(\array_key_exists('ID', $this->struct) ? 'ID' : null);
         $this->createColumn = \array_key_exists('DatCreate', $this->struct) ? 'DatCreate' : null;
         $this->lastModifiedColumn = \array_key_exists('DatSave', $this->struct) ? 'DatSave' : null;
         $this->nameColumn = \array_key_exists('IDS', $this->struct) ? 'IDS' : '';
         $setUp = parent::setUp($options);
         $this->setObjectName();
+
         return $setUp;
     }
 

src/SpojeNet/PohodaSQL/CiselnaRada.php

@@ -237,10 +237,8 @@ class CiselnaRada extends Agenda
 
     /**
      * Hodnota číselné řady.
-     *
-     * @var int|string
      */
-    public $value = 0;
+    public int|string $value = 0;
 
     /**
      * Přidružená agenda.
@@ -262,7 +260,7 @@ public function __construct($identifier = null, $options = [])
     {
         parent::__construct($identifier, $options);
 
-        if (\array_key_exists('IDS', $identifier) && \array_key_exists('RelCrAg', $identifier)) {
+        if (\is_array($identifier) && \array_key_exists('IDS', $identifier) && \array_key_exists('RelCrAg', $identifier)) {
             $this->init(
                 $identifier['IDS'],
                 $identifier['RelCrAg'],

src/SpojeNet/PohodaSQL/DOC.php

@@ -33,7 +33,7 @@ class DOC extends Agenda
      *
      * @const array
      */
-    public $struct = [
+    public array $struct = [
         'ID' => [
             'type' => 'int',
             'size' => '10',

src/SpojeNet/PohodaSQL/Faktura.php

@@ -32,7 +32,7 @@ class Faktura extends Agenda
      *
      * @const array
      */
-    public $struct = [
+    public array $struct = [
         'ID' => [
             'type' => 'int',
             'size' => '10',
@@ -766,7 +766,7 @@ class Faktura extends Agenda
      * @param mixed $identifier Initial content/identifier
      * @param array $options    Object options
      */
-    public function __construct($identifier = null, $options = [])
+    public function __construct($identifier = null, array $options = [])
     {
         parent::__construct($identifier, $options);
     }

src/SpojeNet/PohodaSQL/FakturaPolozka.php

@@ -32,7 +32,7 @@ class FakturaPolozka extends Agenda
      *
      * @const array
      */
-    public $struct = [
+    public array $struct = [
         'ID' => [
             'type' => 'int',
             'size' => '10',

src/SpojeNet/PohodaSQL/Majetek.php

@@ -32,7 +32,7 @@ class Majetek extends Agenda
      *
      * @const array
      */
-    public $struct = [
+    public array $struct = [
         'ID' => [
             'type' => 'int',
             'size' => '10',