Release 1.2.1: fix PHP 8.5 finfo_close() deprecation in mime checks.

Author: HecFranco

.php-cs-fixer.dist.php

@@ -80,7 +80,10 @@
         'modernize_types_casting' => true,
         'no_short_bool_cast' => true,
         'explicit_string_variable' => true,
-        'fully_qualified_strict_types' => true,
+        'fully_qualified_strict_types' => [
+            // Convert \Foo\Bar to use Foo\Bar; + Bar (instanceof, new, types, ::class, etc.).
+            'import_symbols' => true,
+        ],
         'global_namespace_import' => [
             'import_classes' => true,
             'import_constants' => true,

demo/symfony8/composer.lock

@@ -1,12 +1,18 @@
 <?php
 
 declare(strict_types=1);
+use Nowo\TwigInspectorBundle\NowoTwigInspectorBundle;
+use Nowo\WordToPdfBundle\WordToPdfBundle;
+use Symfony\Bundle\DebugBundle\DebugBundle;
+use Symfony\Bundle\FrameworkBundle\FrameworkBundle;
+use Symfony\Bundle\TwigBundle\TwigBundle;
+use Symfony\Bundle\WebProfilerBundle\WebProfilerBundle;
 
 return [
-    Symfony\Bundle\FrameworkBundle\FrameworkBundle::class     => ['all' => true],
-    Symfony\Bundle\TwigBundle\TwigBundle::class               => ['all' => true],
-    Symfony\Bundle\DebugBundle\DebugBundle::class             => ['dev' => true],
-    Symfony\Bundle\WebProfilerBundle\WebProfilerBundle::class => ['dev' => true],
-    Nowo\WordToPdfBundle\WordToPdfBundle::class               => ['all' => true],
-    Nowo\TwigInspectorBundle\NowoTwigInspectorBundle::class   => ['dev' => true, 'test' => true],
+    FrameworkBundle::class         => ['all' => true],
+    TwigBundle::class              => ['all' => true],
+    DebugBundle::class             => ['dev' => true],
+    WebProfilerBundle::class       => ['dev' => true],
+    WordToPdfBundle::class         => ['all' => true],
+    NowoTwigInspectorBundle::class => ['dev' => true, 'test' => true],
 ];

demo/symfony8/config/bundles.php

@@ -7,6 +7,20 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [1.2.1] - 2026-07-22
+
+### Fixed
+
+- Avoid PHP 8.5 deprecation on `finfo_close()` by using the object-oriented `\finfo` API in source mime checks (`WordToPdfConverter`).
+
+### Changed
+
+- PHP-CS-Fixer `fully_qualified_strict_types.import_symbols` enabled (import FQCN in `use` statements).
+
+### Compatibility
+
+- Unchanged from 1.2.0.
+
 ## [1.2.0] - 2026-07-22
 
 ### Added

docs/CHANGELOG.md

@@ -9,6 +9,23 @@
 
 After creating the release commit and tag, run `make check-no-cursor-coauthor` again **before** `git push` (REQ-GIT-001). The release commit itself is not covered by an earlier `release-check` run.
 
+## Example for v1.2.1
+
+```bash
+git add -A
+git status   # review
+make release-check
+git commit -m "$(cat <<'EOF'
+Release 1.2.1: fix PHP 8.5 finfo_close() deprecation in mime checks.
+
+EOF
+)"
+git tag -a v1.2.1 -m "Release v1.2.1"
+make check-no-cursor-coauthor
+git push origin main
+git push origin v1.2.1
+```
+
 ## Example for v1.2.0
 
 ```bash

docs/RELEASE.md

@@ -4,6 +4,22 @@
 
 *(none yet)*
 
+## To 1.2.1
+
+No breaking public API changes. Safe to upgrade with:
+
+```bash
+composer update nowo-tech/word-to-pdf-bundle
+```
+
+### Behavioral notes (non-breaking)
+
+- Source mime probing no longer calls `finfo_close()` (deprecated on PHP 8.5); uses `new \finfo(...)` instead. Apps that copy the old procedural pattern should apply the same change.
+
+### Breaking changes
+
+None.
+
 ## To 1.2.0
 
 No breaking public API changes. Safe to upgrade with:

docs/UPGRADING.md

@@ -4,6 +4,7 @@
 
 namespace Nowo\WordToPdfBundle\Converter;
 
+use finfo;
 use Nowo\WordToPdfBundle\Config\ProfileResolver;
 use Nowo\WordToPdfBundle\Config\ResolvedConfig;
 use Nowo\WordToPdfBundle\Exception\ConversionFailedException;
@@ -15,8 +16,8 @@
 use Throwable;
 
 use function array_replace_recursive;
+use function class_exists;
 use function filesize;
-use function function_exists;
 use function in_array;
 use function is_file;
 use function is_readable;
@@ -200,15 +201,12 @@ private function assertSource(string $sourcePath, ResolvedConfig $config): void
             throw new ConversionFailedException(sprintf('Source file "%s" exceeds max_source_bytes (%d > %d).', $sourcePath, $size, $config->maxSourceBytes));
         }
 
-        // Light magic check when fileinfo is available
-        if (function_exists('finfo_open')) {
-            $finfo = finfo_open(FILEINFO_MIME_TYPE);
-            if ($finfo !== false) {
-                $mime = finfo_file($finfo, $sourcePath) ?: '';
-                finfo_close($finfo);
-                if ($mime !== '' && $mime !== 'inode/x-empty' && (str_starts_with($mime, 'text/') || str_starts_with($mime, 'image/'))) {
-                    throw new UnsupportedFormatException(sprintf('File "%s" does not look like a Word document (mime: %s).', $sourcePath, $mime));
-                }
+        // Light magic check when fileinfo is available (OO API: finfo_close() is deprecated since PHP 8.5)
+        if (class_exists(finfo::class)) {
+            $finfo = new finfo(FILEINFO_MIME_TYPE);
+            $mime  = $finfo->file($sourcePath) ?: '';
+            if ($mime !== '' && $mime !== 'inode/x-empty' && (str_starts_with($mime, 'text/') || str_starts_with($mime, 'image/'))) {
+                throw new UnsupportedFormatException(sprintf('File "%s" does not look like a Word document (mime: %s).', $sourcePath, $mime));
             }
         }
     }

src/Converter/WordToPdfConverter.php

@@ -5,6 +5,7 @@
 namespace Nowo\WordToPdfBundle\Converter;
 
 use Nowo\WordToPdfBundle\Exception\InvalidProfileException;
+use Nowo\WordToPdfBundle\Exception\MissingDependencyException;
 use Nowo\WordToPdfBundle\Naming\PdfNaming;
 use Nowo\WordToPdfBundle\Result\ConvertedPdf;
 
@@ -85,7 +86,7 @@ public function convertMany(
      *
      * @param string|null $profile Profile key, or null for the default
      *
-     * @throws \Nowo\WordToPdfBundle\Exception\MissingDependencyException
+     * @throws MissingDependencyException
      * @throws InvalidProfileException
      *
      * @return void

src/Converter/WordToPdfConverterInterface.php

@@ -5,6 +5,7 @@
 namespace Nowo\WordToPdfBundle\Naming;
 
 use InvalidArgumentException;
+use Nowo\WordToPdfBundle\Converter\WordToPdfConverterInterface;
 
 use function basename;
 use function in_array;
@@ -19,7 +20,7 @@
 /**
  * Builds suggested PDF download filenames from Word source paths.
  *
- * Use with {@see \Nowo\WordToPdfBundle\Converter\WordToPdfConverterInterface::convertMany()}.
+ * Use with {@see WordToPdfConverterInterface::convertMany()}.
  * Explicit path => filename maps passed to convertMany override this strategy.
  */
 final readonly class PdfNaming

src/Naming/PdfNaming.php

@@ -4,6 +4,7 @@
 
 namespace Nowo\WordToPdfBundle\Tests\Unit\Export;
 
+use League\Flysystem\FilesystemOperator;
 use Nowo\WordToPdfBundle\Exception\ExportException;
 use Nowo\WordToPdfBundle\Export\PdfExporter;
 use Nowo\WordToPdfBundle\Result\ConvertedPdf;
@@ -70,7 +71,7 @@ public function testFlysystemUpload(): void
         self::assertNotFalse($src);
         file_put_contents($src, '%PDF');
 
-        $fs = $this->createMock(\League\Flysystem\FilesystemOperator::class);
+        $fs = $this->createMock(FilesystemOperator::class);
         $fs->expects(self::once())->method('writeStream');
 
         $exporter = new PdfExporter($fs);