webman поддерживает доступ к статическим файлам, которые находятся в каталоге public
. Например, при доступе по адресу http://127.0.0.8787/upload/avatar.png
фактически осуществляется доступ к файлу {основной_каталог_проекта}/public/upload/avatar.png
.
Обратите внимание
Начиная с версии 1.4, webman поддерживает приложения-плагины, поэтому доступ к статическим файлам, начинающийся с/app/xx/имя_файла
, фактически осуществляется доступ к каталогуpublic
приложения-плагина. То есть в версии webman >=1.4.0 не поддерживается доступ к каталогам в{основной_каталог_проекта}/public/app/
.
Дополнительную информацию можно найти в Плагинах приложений.
Отключение поддержки статических файлов
Если нет необходимости в поддержке статических файлов, откройте config/static.php
и измените параметр enable
на false
. После отключения вся попытка доступа к статическим файлам будет возвращать ошибку 404.
Изменение каталога статических файлов
По умолчанию webman использует каталог public в качестве каталога статических файлов. Для изменения этого параметра измените функцию-помощник public_path()
в файле support/helpers.php
.
Middleware для статических файлов
webman поставляется с middleware для статических файлов, расположенным по адресу app/middleware/StaticFile.php
.
Иногда нам нужно внести некоторые изменения в статические файлы, например, добавить заголовок HTTP для кросс-доменных запросов, запретить доступ к файлам, начинающимся с точки (.
). Для этого можно использовать это middleware.
Содержимое файла app/middleware/StaticFile.php
выглядит примерно так:
<?php
namespace support\middleware;
use Webman\MiddlewareInterface;
use Webman\Http\Response;
use Webman\Http\Request;
class StaticFile implements MiddlewareInterface
{
public function process(Request $request, callable $next) : Response
{
// Запретить доступ к скрытым файлам, начинающимся с точки
if (strpos($request->path(), '/.') !== false) {
return response('<h1>403 forbidden</h1>', 403);
}
/** @var Response $response */
$response = $next($request);
// Добавить заголовок HTTP для кросс-доменных запросов
/*$response->withHeaders([
'Access-Control-Allow-Origin' => '*',
'Access-Control-Allow-Credentials' => 'true',
]);*/
return $response;
}
}
Если требуется использование этого middleware, необходимо включить его в параметре middleware
файла config/static.php
.