Update PHP minimum version to 8.0 and dependencies to latest compatible version

Author: nguereza-tony

.github/workflows/ci.yml

@@ -13,7 +13,7 @@ jobs:
       fail-fast: false
       matrix:
         operating-system: [ubuntu-latest, windows-latest, macOS-latest]
-        php-versions: ['7.4', '8.0', '8.1', '8.2', '8.3']
+        php-versions: ['8.0', '8.1', '8.2', '8.3', '8.4']
     name: PHP ${{ matrix.php-versions }} Test on ${{ matrix.operating-system }}
     steps:
     - name: Checkout
@@ -28,7 +28,7 @@ jobs:
       run: php -v
     - name: Cache Composer packages
       id: composer-cache
-      uses: actions/cache@v3
+      uses: actions/cache@v4
       with:
         path: vendor
         key: ${{ runner.os }}-php-${{ hashFiles('**/composer.lock') }}

.scrutinizer.yml

@@ -11,7 +11,7 @@ build:
                         command: phpcs-run
                         use_website_config: false
     environment:
-        php: 7.4.0
+        php: 8.0
 filter:
     excluded_paths:
         - 'tests/*'

README.MD

@@ -12,7 +12,7 @@
 [![Codacy Badge](https://app.codacy.com/project/badge/Coverage/1a791203238c45539178f1992285933c)](https://app.codacy.com/gh/platine-php/filesystem/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_coverage)
 
 ### Requirements 
-- **PHP >= 7.4**, **PHP 8** 
+- **PHP >= 8.0** 
 
 ### Installation
 #### Using composer (recommended)

composer.json

@@ -19,16 +19,16 @@
     },
 
     "require": {
-        "php": "^7.4 || ^8",
+        "php": "^8",
         "platine-php/stdlib": "^1.0"
     },
 
     "require-dev": {
         "mikey179/vfsstream": "~1.6",
         "phpmd/phpmd": "@stable",
-        "phpstan/phpstan": "^1.8",
-        "phpunit/phpunit": "^9.5",
-        "platine-php/dev": "^1.0",
+        "phpstan/phpstan": "^2.0",
+        "phpunit/phpunit": "^9.6",
+        "platine-php/dev": "^2.0",
         "squizlabs/php_codesniffer": "3.*"
     },
 

src/Adapter/AdapterInterface.php

@@ -51,7 +51,7 @@
 use Platine\Filesystem\FileInterface;
 
 /**
- * Class AdapterInterface
+ * @class AdapterInterface
  * @package Platine\Filesystem\Adapter
  */
 interface AdapterInterface
@@ -61,7 +61,7 @@ interface AdapterInterface
      * @param string $path
      * @return FileInterface|DirectoryInterface|null
      */
-    public function get(string $path);
+    public function get(string $path): FileInterface|DirectoryInterface|null;
 
     /**
      * Return the instance of file

src/Adapter/Local/AbstractLocal.php

@@ -49,12 +49,14 @@
 
 use Platine\Filesystem\Adapter\AdapterInterface;
 use Platine\Filesystem\Adapter\Local\Exception\FilesystemException;
+use Platine\Filesystem\DirectoryInterface;
+use Platine\Filesystem\FileInterface;
 use Platine\Filesystem\FilesystemInterface;
 use Platine\Stdlib\Helper\Path;
 
 
 /**
- * Class AbstractLocal
+ * @class AbstractLocal
  * @package Platine\Filesystem\Adapter\Local
  */
 abstract class AbstractLocal implements FilesystemInterface
@@ -133,7 +135,7 @@ public function getOriginalPath(): string
     /**
     * {@inheritdoc}
     */
-    public function moveTo($directory)
+    public function moveTo(string|DirectoryInterface $directory): FileInterface|DirectoryInterface
     {
         $dest = $this->copyTo($directory);
         $dest->touch($this->getMtime());
@@ -145,7 +147,7 @@ public function moveTo($directory)
     /**
     * {@inheritdoc}
     */
-    public function chmod(int $mode)
+    public function chmod(int $mode): self
     {
         chmod($this->path, $mode);
 
@@ -244,7 +246,7 @@ public function isWritable(): bool
     /**
     * {@inheritdoc}
     */
-    public function rename(string $newPath)
+    public function rename(string $newPath): self
     {
         $normalizedNewPath = rtrim(Path::normalizePathDS($newPath), '\\/');
         if (strpos($normalizedNewPath, DIRECTORY_SEPARATOR) === false) {
@@ -264,7 +266,7 @@ public function rename(string $newPath)
     /**
     * {@inheritdoc}
     */
-    public function touch(int $time)
+    public function touch(int $time): self
     {
         touch($this->path, $time);
 

src/Adapter/Local/Directory.php

@@ -53,16 +53,18 @@
 use Platine\Filesystem\FileInterface;
 
 /**
- * Class Directory
+ * @class Directory
  * @package Platine\Filesystem\Adapter\Local
  */
 class Directory extends AbstractLocal implements DirectoryInterface
 {
     /**
     * {@inheritdoc}
     */
-    public function copyTo($directory, int $mode = 0775)
-    {
+    public function copyTo(
+        string|DirectoryInterface $directory,
+        int $mode = 0775
+    ): FileInterface|DirectoryInterface {
         if (!$this->exists()) {
             throw new NotFoundException(sprintf(
                 'Source path [%s] not found',
@@ -96,7 +98,7 @@ public function copyTo($directory, int $mode = 0775)
     /**
     * {@inheritdoc}
     */
-    public function create(string $name, int $mode = 0775, bool $recursive = false)
+    public function create(string $name, int $mode = 0775, bool $recursive = false): DirectoryInterface
     {
         if (!file_exists($this->path . DIRECTORY_SEPARATOR . $name)) {
             mkdir($this->path . DIRECTORY_SEPARATOR . $name, $mode, $recursive);

src/Adapter/Local/Exception/FilesystemException.php

@@ -36,7 +36,7 @@
 use Exception;
 
 /**
- * Class FilesystemException
+ * @class FilesystemException
  * @package Platine\Filesystem\Adapter\Local\Exception
  */
 class FilesystemException extends Exception

src/Adapter/Local/Exception/NotFoundException.php

@@ -34,7 +34,7 @@
 namespace Platine\Filesystem\Adapter\Local\Exception;
 
 /**
- * Class NotFoundException
+ * @class NotFoundException
  * @package Platine\Filesystem\Adapter\Local\Exception
  */
 class NotFoundException extends FilesystemException

src/Adapter/Local/File.php

@@ -47,11 +47,12 @@
 
 namespace Platine\Filesystem\Adapter\Local;
 
+use Platine\Filesystem\DirectoryInterface;
 use Platine\Filesystem\FileInterface;
 use Platine\Stdlib\Helper\Path;
 
 /**
- * Class File
+ * @class File
  * @package Platine\Filesystem\Adapter\Local
  */
 class File extends AbstractLocal implements FileInterface
@@ -69,8 +70,10 @@ public function append(string $content): self
     /**
     * {@inheritdoc}
     */
-    public function copyTo($directory, int $mode = 0775)
-    {
+    public function copyTo(
+        string|DirectoryInterface $directory,
+        int $mode = 0775
+    ): FileInterface {
         if (is_string($directory)) {
             $directory = $this->adapter->directory($directory);
         }
@@ -85,7 +88,7 @@ public function copyTo($directory, int $mode = 0775)
     /**
     * {@inheritdoc}
     */
-    public function create(string $path, string $content = '', int $mode = 0775)
+    public function create(string $path, string $content = '', int $mode = 0775): FileInterface
     {
         $file = $this->adapter->file($path)->write($content);
         $file->chmod($mode);