Validate shortcode controllername service configurations (Case 173693)

src/Handler/EmbeddedShortcodeHandler.php

@@ -2,6 +2,7 @@
 
 namespace Webfactory\ShortcodeBundle\Handler;
 
+use InvalidArgumentException;
 use Psr\Log\LoggerInterface;
 use Psr\Log\NullLogger;
 use Symfony\Component\HttpFoundation\RequestStack;
@@ -33,17 +34,18 @@ class EmbeddedShortcodeHandler
     /** @var RequestStack */
     private $requestStack;
 
-    /**
-     * @param string $controllerName
-     * @param string $renderer
-     */
     public function __construct(
         FragmentHandler $fragmentHandler,
-        $controllerName,
-        $renderer,
+        string $controllerName,
+        string $renderer,
         RequestStack $requestStack,
         ?LoggerInterface $logger = null
     ) {
+        $callableFragments = explode('::', $controllerName);
+        if (!\is_array($callableFragments) || !isset($callableFragments[1]) || !method_exists($callableFragments[0], $callableFragments[1])) {
+            throw new InvalidArgumentException('The controller method: "'.$controllerName.'" does not exist.');
+        }
+
         $this->fragmentHandler = $fragmentHandler;
         $this->controllerName = $controllerName;
         $this->renderer = $renderer;

tests/Fixtures/config/config.yml

@@ -18,7 +18,6 @@ webfactory_shortcode:
             controller: 'Webfactory\ShortcodeBundle\Tests\Fixtures\Controller\ShortcodeTestController::test'
             description: "Description for the 'test-shortcode-guide' shortcode"
             example: "test-shortcode-guide test=true"
-        test-config-invalid-controller: 'Foo\Bar::baz'
 
 services:
     Webfactory\ShortcodeBundle\Tests\Fixtures\Controller\:

tests/Functional/EmbeddedShortcodeHandlerTest.php

@@ -3,10 +3,14 @@
 namespace Webfactory\ShortcodeBundle\Tests\Functional;
 
 use Generator;
+use InvalidArgumentException;
 use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
 use Symfony\Component\HttpFoundation\Request;
 use Symfony\Component\HttpFoundation\RequestStack;
+use Symfony\Component\HttpKernel\Fragment\FragmentHandler;
+use Webfactory\ShortcodeBundle\Handler\EmbeddedShortcodeHandler;
 use Webfactory\ShortcodeBundle\Test\EndToEndTestHelper;
+use Webfactory\ShortcodeBundle\Tests\Fixtures\Controller\ShortcodeTestController;
 
 /**
  * Test shortcode processing using EmbeddedShortcodeHandler and a fixture ShortodeTestController,
@@ -64,6 +68,41 @@ public static function provideEsiShortcodes(): Generator
         yield 'ESI-based shortcode defined in service configuration' => ['test-service-esi'];
     }
 
+    /**
+     * @test
+     */
+    public function throws_no_exception_on_valid_controller_name(): void
+    {
+        $this->expectNotToPerformAssertions();
+
+        new EmbeddedShortcodeHandler(
+            $this->createMock(FragmentHandler::class),
+            ShortcodeTestController::class.'::test',
+            'inline',
+            $this->createMock(RequestStack::class)
+        );
+    }
+
+    /**
+     * @test
+     *
+     * @dataProvider provideControllerNames
+     */
+    public function throws_exception_on_invalid_controller_names(string $controllerName): void
+    {
+        $this->expectException(InvalidArgumentException::class);
+
+        new EmbeddedShortcodeHandler($this->createMock(FragmentHandler::class), $controllerName, 'inline', $this->createMock(RequestStack::class));
+    }
+
+    public static function provideControllerNames(): Generator
+    {
+        yield 'Empty string' => [''];
+        yield 'Not existing controller' => ['Foo\Bar::baz'];
+        yield 'Missing method name' => [ShortcodeTestController::class];
+        yield 'Not existing method' => [ShortcodeTestController::class.'_notExistingMethod'];
+    }
+
     private function processShortcodes(string $content, ?Request $request = null): string
     {
         self::bootKernel();

tests/Functional/ShortcodeDefinitionTestHelperTest.php

@@ -2,7 +2,6 @@
 
 namespace Webfactory\ShortcodeBundle\Tests\Functional;
 
-use InvalidArgumentException;
 use RuntimeException;
 use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
 use Thunder\Shortcode\Handler\PlaceholderHandler;
@@ -31,15 +30,6 @@ public function throws_exception_for_handlers_that_do_not_use_controllers(): voi
         $this->helper->resolveShortcodeController('placeholder'); // uses the \Thunder\Shortcode\Handler\PlaceholderHandler handler class directly
     }
 
-    /**
-     * @test
-     */
-    public function throws_exception_for_shortcode_with_unresolvable_controller(): void
-    {
-        self::expectException(InvalidArgumentException::class);
-        $this->helper->resolveShortcodeController('test-config-invalid-controller');
-    }
-
     /**
      * @test
      */