Download the PHP package guidofaecke/blast-base-url without Composer
On this page you can find all versions of the php package guidofaecke/blast-base-url. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download guidofaecke/blast-base-url
More information about guidofaecke/blast-base-url
Files in guidofaecke/blast-base-url
Package blast-base-url
Short Description PSR-7 middleware and helpers for working with base URL.
License BSD-2-Clause
Informations about the package blast-base-url
Blast\BaseUrl
Just another fork of mtymek/blast-base-url... Not exactly! The development of mtymek/blast-base-url apparently stopped in 2019, so here we go, strip the cruft and get back to PHP7.4 - 8.1
This package detects base URL of web application. It is useful when you need your app
to be served from subdirectory (like http://localhost/my-project/public
). This can
be useful sometimes, especially in development environment.
View helpers for working with assets are also provided in the package.
Detection logic is based on laminas-http
package.
Installation
Installation is supported using Composer:
If Zend Component Installer
is present, it will automatically update application configuration.
Usage
For simplicity, following instructions are targeting applications based on
Mezzio Skeleton,
assuming that laminas/laminas-servicemanager
was selected as DI container.
Blast\BaseUrl
is based on PSR-7, so it will work well with other frameworks/dispatchers
like Slim3 or Relay, just that wiring process will look different.
Base URL Middleware
Add BaseUrlMiddleware
to your pipeline, just before routing middleware (config/pipeline.php
file):
BaseUrlMiddleware
will alter path from request URI, stripping base url. It means that
even if you access your project from http:/localhost/~user/project/public/index.php/foo/bar
,
next middleware in the pipe will see the path as /foo/bar
.
Additionally, two attributes will be added to ServerRequest, holding base URL and base path:
Generating URLs
BaseUrlMiddleware
is able to automatically configure UrlHelper
, so that all URLs generated
by this helper will have appropriate prefix. This will be done automatically if UrlHelper
is available in service container.
Accessing assets - base path
Another feature provided by this package is base path helper. It can be used to generate URLS for your asset files that work correctly under subdirectory.
If BasePathHelper
is available, BaseUrlMiddleware
will automatically configure it during
execution.
Zend View
You will be able to use following syntax inside zend-view
templates:
Depending on your application directory, it will produce something similar to:
Twig
You will be able to use following syntax inside twig
templates:
Depending on your application directory, it will produce something similar to:
All versions of blast-base-url with dependencies
psr/http-message Version ^1.0|^2.0
psr/http-server-handler Version ^1.0|^2.0
psr/http-server-middleware Version ^1.0|^2.0