Backport CMS features

composer.json

@@ -8,7 +8,7 @@
     "require": {
         "php": "^8.3.0",
         "fig/link-util": "^1.0",
-        "psr/link": "^2.0"
+        "psr/link": "^1.1|^2.0"
     },
     "require-dev": {
         "joomla/application": "^4.0",

src/PreloadManager.php

@@ -18,7 +18,7 @@
  *
  * @since  2.0.0
  */
-class PreloadManager
+class PreloadManager implements PreloadManagerInterface
 {
     /**
      * The link provider
@@ -57,13 +57,15 @@ public function getLinkProvider(): EvolvableLinkProviderInterface
      *
      * @param   EvolvableLinkProviderInterface  $linkProvider  The link provider
      *
-     * @return  void
+     * @return  $this
      *
      * @since   2.0.0
      */
-    public function setLinkProvider(EvolvableLinkProviderInterface $linkProvider): void
+    public function setLinkProvider(EvolvableLinkProviderInterface $linkProvider): self
     {
         $this->linkProvider = $linkProvider;
+
+        return $this;
     }
 
     /**

src/PreloadManagerInterface.php

@@ -0,0 +1,100 @@
+<?php
+
+/**
+ * Part of the Joomla Framework Preload Package
+ *
+ * @copyright  Copyright (C) 2005 - 2026 Open Source Matters, Inc. All rights reserved.
+ * @license    GNU General Public License version 2 or later; see LICENSE
+ */
+
+namespace Joomla\Preload;
+
+use Psr\Link\EvolvableLinkProviderInterface;
+
+/**
+ * Joomla! Preload Manager Interface
+ *
+ * @since  4.1.0
+ */
+interface PreloadManagerInterface
+{
+    /**
+     * Get the link provider
+     *
+     * @return  EvolvableLinkProviderInterface
+     *
+     * @since   4.1.0
+     */
+    public function getLinkProvider(): EvolvableLinkProviderInterface;
+
+    /**
+     * Set the link provider
+     *
+     * @param   EvolvableLinkProviderInterface  $linkProvider  The link provider
+     *
+     * @return  $this
+     *
+     * @since   4.1.0
+     */
+    public function setLinkProvider(EvolvableLinkProviderInterface $linkProvider);
+
+    /**
+     * Preloads a resource.
+     *
+     * @param   string  $uri         A public path
+     * @param   array   $attributes  The attributes of this link (e.g. "array('as' => true)", "array('crossorigin' => 'use-credentials')")
+     *
+     * @return  void
+     *
+     * @since   4.1.0
+     */
+    public function preload(string $uri, array $attributes = []);
+
+    /**
+     * Resolves a resource origin as early as possible.
+     *
+     * @param   string  $uri         A public path
+     * @param   array   $attributes  The attributes of this link (e.g. "array('as' => true)", "array('pr' => 0.5)")
+     *
+     * @return  void
+     *
+     * @since   4.1.0
+     */
+    public function dnsPrefetch(string $uri, array $attributes = []);
+
+    /**
+     * Initiates an early connection to a resource (DNS resolution, TCP handshake, TLS negotiation).
+     *
+     * @param   string  $uri         A public path
+     * @param   array   $attributes  The attributes of this link (e.g. "array('as' => true)", "array('pr' => 0.5)")
+     *
+     * @return  void
+     *
+     * @since   4.1.0
+     */
+    public function preconnect(string $uri, array $attributes = []);
+
+    /**
+     * Indicates to the client that it should prefetch this resource.
+     *
+     * @param   string  $uri         A public path
+     * @param   array   $attributes  The attributes of this link (e.g. "array('as' => true)", "array('pr' => 0.5)")
+     *
+     * @return  void
+     *
+     * @since   4.1.0
+     */
+    public function prefetch(string $uri, array $attributes = []);
+
+    /**
+     * Indicates to the client that it should prerender this resource.
+     *
+     * @param   string  $uri         A public path
+     * @param   array   $attributes  The attributes of this link (e.g. "array('as' => true)", "array('pr' => 0.5)")
+     *
+     * @return  void
+     *
+     * @since   4.1.0
+     */
+    public function prerender(string $uri, array $attributes = []);
+}

tests/EventListener/PreloadSubscriberTest.php

@@ -12,6 +12,7 @@
 use Joomla\Application\Event\ApplicationEvent;
 use Joomla\Preload\EventListener\PreloadSubscriber;
 use Joomla\Preload\PreloadManager;
+use Laminas\Diactoros\Response;
 use PHPUnit\Framework\TestCase;
 use Psr\Link\EvolvableLinkProviderInterface;
 
@@ -57,6 +58,9 @@ public function testAddHeaderToApplication()
  * @since    1.0
  */
 class TestAbstractWebApplication extends AbstractWebApplication {
+    public function __construct() {
+        $this->setResponse(new Response());
+    }
     protected function doExecute()
     {
         // TODO: Implement doExecute() method.