Make fallback extension configurable

src/ViewInterface.php

@@ -14,6 +14,8 @@
  */
 interface ViewInterface
 {
+    public const PHP_EXTENSION = 'php';
+
     /**
      * Returns a new instance with specified base path to the view directory.
      *

src/ViewTrait.php

@@ -39,7 +39,8 @@
     private ?ViewContextInterface $context = null;
     private string $placeholderSignature;
     private string $sourceLocale = 'en';
-    private string $defaultExtension = 'php';
+    private string $defaultExtension = self::PHP_EXTENSION;
+    private string $fallbackExtension = self::PHP_EXTENSION;
 
     /**
      * @var array A list of available renderers indexed by their corresponding
@@ -105,7 +106,7 @@
     /**
      * Returns a new instance with the specified default view file extension.
      *
-     * @param string $defaultExtension The default view file extension. Default is "php".
+     * @param string $defaultExtension The default view file extension. Default is {@see ViewInterface::PHP_EXTENSION}.
      * This will be appended to view file names if they don't have file extensions.
      */
     public function withDefaultExtension(string $defaultExtension): static
@@ -115,6 +116,19 @@
         return $new;
     }
 
+    /**
+     * Returns a new instance with the specified fallback view file extension.
+     *
+     * @param string $fallbackExtension The fallback view file extension. Default is {@see ViewInterface::PHP_EXTENSION}.
+     * This will be appended to view file names if they don't exist.
+     */
+    public function withFallbackExtension(string $fallbackExtension): static
+    {
+        $new = clone $this;
+        $new->fallbackExtension = $fallbackExtension;
+        return $new;
+    }
+
     /**
      * Returns a new instance with the specified view context instance.
      *
@@ -430,14 +444,14 @@
         }
 
         $output = '';
         $this->viewFiles[] = [
             'resolved' => $viewFile,
             'requested' => $requestedFile,
         ];
 
         if ($this->beforeRender($viewFile, $parameters)) {
             $ext = pathinfo($viewFile, PATHINFO_EXTENSION);
             $renderer = $this->renderers[$ext] ?? new PhpTemplateRenderer();
             $output = $renderer->render($this, $viewFile, $parameters);
             $output = $this->afterRender($viewFile, $parameters, $output);
         }
@@ -607,7 +621,7 @@
         $path = $file . '.' . $this->defaultExtension;
 
         if ($this->defaultExtension !== 'php' && !is_file($path)) {
-            $path = $file . '.php';
+            $path = $file . '.' . $this->fallbackExtension;
         }
 
         return $path;

tests/ViewTest.php

@@ -195,6 +195,10 @@ public function testRenderWithoutFileExtension(): void
         $this->assertSame('Test', $view
             ->withDefaultExtension('txt')
             ->render('file'));
+        $this->assertSame(
+            'Test',
+            $view->withDefaultExtension('phpt')->withFallbackExtension('tpl')->render('file')
+        );
     }
 
     public function testLocalize(): void
@@ -545,6 +549,7 @@ public function testImmutability(): void
         $this->assertNotSame($view, $view->withPlaceholderSalt(''));
         $this->assertNotSame($view, $view->withClearedState());
         $this->assertNotSame($view, $view->withLocale('es'));
+        $this->assertNotSame($view, $view->withFallbackExtension('tpl'));
     }
 
     private function createViewWithBasePath(string $basePath): View