always make paths absolute before processing files

src/FileSystem/FilePathHelper.php

@@ -45,6 +45,15 @@ public function relativePath(string $fileRealPath): string
         return $this->relativeFilePathFromDirectory($fileRealPath, getcwd());
     }
 
+    public function absolutePath(string $fileRealPath): string
+    {
+        if ($this->filesystem->isAbsolutePath($fileRealPath)) {
+            return $fileRealPath;
+        }
+
+        return realpath($fileRealPath);
+    }
+
     /**
      * Used from
      * https://github.com/phpstan/phpstan-src/blob/02425e61aa48f0668b4efb3e73d52ad544048f65/src/File/FileHelper.php#L40, with custom modifications

src/FileSystem/FilesFinder.php

@@ -39,6 +39,7 @@ public function findInDirectoriesAndFiles(array $source, array $suffixes = [], b
 
         // filtering files in files collection
         $filteredFilePaths = $this->fileAndDirectoryFilter->filterFiles($filesAndDirectories);
+        $filteredFilePaths = array_map(realpath(...), $filteredFilePaths);
         $filteredFilePaths = array_filter(
             $filteredFilePaths,
             fn (string $filePath): bool => ! $this->pathSkipper->shouldSkip($filePath)

tests/FileSystem/FilesFinder/FilesFinderTest.php

@@ -29,6 +29,26 @@ public function test(): void
         $this->assertCount(0, $foundFiles);
     }
 
+    #[DataProvider('alwaysReturnsAbsolutePathDataProvider')]
+    public function testAlwaysReturnsAbsolutePath(string $relativePath): void
+    {
+        $absolutePath = str_replace('/', DIRECTORY_SEPARATOR, getcwd() . '/' . $relativePath);
+        $foundFiles = $this->filesFinder->findInDirectoriesAndFiles([$absolutePath], ['php']);
+        $this->assertStringStartsWith($absolutePath, $foundFiles[0], 'should return absolute path if absolute is given');
+
+        $foundFiles = $this->filesFinder->findInDirectoriesAndFiles([$relativePath], ['php']);
+        $this->assertStringStartsWith($absolutePath, $foundFiles[0], 'should return absolute path if relative is given');
+    }
+
+    /**
+     * @return Iterator<array<string>>
+     */
+    public static function alwaysReturnsAbsolutePathDataProvider(): Iterator
+    {
+        yield 'directory given' => ['tests/FileSystem/FilesFinder/Source/'];
+        yield 'file given' => ['tests/FileSystem/FilesFinder/Source/SomeFile.php'];
+    }
+
     public function testWithFollowingBrokenSymlinks(): void
     {
         SimpleParameterProvider::setParameter(Option::SKIP, [__DIR__ . '/../SourceWithBrokenSymlinks/folder1']);