facile-it / laminas-link-headers-module
Laminas module to push Link headers for resourcers added with HeadLink view helper
Installs: 10 077
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 4
Forks: 0
Open Issues: 0
Requires
- php: ^7.1
- container-interop/container-interop: ^1.2
- laminas/laminas-eventmanager: ^3.0
- laminas/laminas-http: ^2.5.4
- laminas/laminas-modulemanager: ^2.7.1
- laminas/laminas-mvc: ^3.0
- laminas/laminas-servicemanager: ^3.0.3
- laminas/laminas-stdlib: ^3.1
- laminas/laminas-view: ^2.6.7
- psr/container: ^1.0
Requires (Dev)
- facile-it/facile-coding-standard: ^0.3.1
- laminas/laminas-config: ^2.6.0 || ^3.0
- laminas/laminas-dependency-plugin: ^1.0
- laminas/laminas-test: ^3.1
- phpunit/phpunit: ^7.5.20 || ^8.5.2
This package is auto-updated.
Last update: 2024-10-24 04:28:10 UTC
README
This module will automatically sends Link
HTTP headers supporting
resource hints
and preload, via HTTP headers.
Currently supported hints
From OptionsInterface
:
public const MODE_PRELOAD = 'preload'; public const MODE_PREFETCH = 'prefetch'; public const MODE_DNS_PREFETCH = 'dns-prefetch'; public const MODE_PRECONNECT = 'preconnect'; public const MODE_PRERENDER = 'prerender';
Configuration
This is the default configuration and options can be overridden in your configuration.
return [ 'facile' => [ 'laminas_link_headers_module' => [ 'stylesheet_enabled' => false, // send link headers for stylesheet links 'stylesheet_mode' => 'preload', // resource hint for stylesheet links 'script_enabled' => false, // send link headers for scripts 'script_mode' => 'preload', // resource hint for script links 'http2_push_enabled' => true, // if disabled, a "nopush" attributed will be added to disable HTTP/2 push ], ], ];
Example
Configuration:
Default configuration:
return [ 'facile' => [ 'laminas_link_headers_module' => [ 'stylesheet_enabled' => false, // send link headers for stylesheet links 'stylesheet_mode' => 'preload', // resource hint for stylesheet links 'script_enabled' => false, // send link headers for scripts 'script_mode' => 'preload', // resource hint for script links 'http2_push_enabled' => true, // if disabled, a "nopush" attributed will be added to disable HTTP/2 push ], ], ];
Template
In your template:
<!DOCTYPE html> <html lang="it"> <head> <?= $this->headLink(['rel' => 'preload', 'as' => 'image', 'href' => $this->basePath() . $this->asset('assets/images/logo.png'), 'media' => 'image/png') ->headLink(['rel' => 'preload', 'as' => 'style', 'href' => $this->basePath() . $this->asset('assets/vendor.css')]) ->headLink(['rel' => 'preload', 'as' => 'script', 'href' => $this->basePath() . $this->asset('assets/vendor.js')]) // prefetch (low priority) resources required in th next pages ->headLink(['rel' => 'prefetch', 'as' => 'style', 'href' => $this->basePath() . $this->asset('assets/next.css')]) // do not send preload headers ->prependStylesheet($this->basePath() . $this->asset('assets/vendor.css')) ->prependStylesheet($this->basePath() . $this->asset('assets/vendor.js')) ?> <?= $this->headScript() ->prependFile('/script/foo.js') ?> </head> <body> <!-- your content here --> <script type="text/javascript" src="<?= $this->basePath() . $this->asset('assets/vendor.js') ?>"></script> </body> </html>
Response headers
The module will automatically add a Link header to the response:
Link: </assets/images/logo.png>; rel="preload"; as="image"; media="image/png",
</assets/vendor.css>; rel="preload"; as="style",
</assets/vendor.js>; rel="preload"; as="script",
</assets/next.css>; rel="prefetch"; as="style"
You should notice that resource /script/foo.js
is not in headers, because it wasn't
included in preload head links.
Automatically sends stylesheets preload
Enabling stylesheet_enabled
mode in your configuration, you can avoid inserting preload links
for all your styles.
Configuration:
return [ 'facile' => [ 'laminas_link_headers_module' => [ 'stylesheet_enabled' => true, // send link headers for stylesheet links ], ], ];
You can optionally change the stylesheet_mode
(supported modes are vailable as constants in OptionsInterface
)
to use on stylesheets.
Template
In your template:
<!DOCTYPE html> <html lang="it"> <head> <?= $this->prependStylesheet($this->basePath() . $this->asset('assets/vendor.css')) ?> </head> <body> <!-- your content here --> </body> </html>
Response headers
The module will automatically add a Link header to the response:
Link: </assets/vendor.css>; rel="preload"; as="style"; type="text/css"; media="screen"
Automatically sends scripts preload
Enabling script_enabled
mode in your configuration, you can avoid inserting preload links
for all your scripts.
Configuration:
return [ 'facile' => [ 'laminas_link_headers_module' => [ 'script_enabled' => true, // send link headers for script links ], ], ];
You can optionally change the script_mode
(supported modes are vailable as constants in OptionsInterface
)
to use on stylesheets.
Template
In your template:
<!DOCTYPE html> <html lang="it"> <head> <?= $this->headScript() ->prependFile('/script/foo.js') ->prependFile('/script/bar.js', 'text/foo') ?> </head> <body> <!-- your content here --> </body> </html>
Response headers
The module will automatically add a Link header to the response:
Link: </script/foo.js>; rel="preload"; as="script"; type="text/javascript",
</script/bar.js>; rel="preload"; as="script"; type="text/foo"
Disable HTTP/2 push
Using HTTP/2, sending preload link headers the web server will push contents to the browser when the page is requested.
This isn't always necessary, because browsers can cache the contents and pushing them can increase bandwidth usage with no significant performance.
You can disable push setting http2_push_enabled
configuration option to false
.
This will add a nopush
attribute
that indicates to an HTTP/2 push capable server that the resource hould not be pushed
(e.g. the origin may have additional information indicating that it may already be in cache).