Перейти к содержимому
WebShield Docs

Как опубликовать сайт на Laravel

Соберите Laravel с Vite, подключите Postgres и опубликуйте сайт по HTTPS — с рабочими формами, сессиями и обновлением без потери данных.

Laravel нужны PHP-сервер, база и постоянный ключ приложения. Если оставить сессии и SQLite на диске контейнера, при следующем запуске данные могут пропасть.

Опубликуем Laravel 12 в Приложениях WebShield: сборка установит зависимости PHP, соберёт файлы Vite и запустит HTTP-сервер. Сессии будем хранить в Postgres.

Что получится: сайт с формой приветствия на app.example.com; счётчик посещений в сессии сохранится после обновления приложения. Понадобится: аккаунт WebShield, свободное имя своего домена, терминал, PHP 8.4 с Composer и расширением pdo_pgsql, Node.js 22 с npm, CLI WebShield. Время: около 40 минут без ожидания DNS.

Terminal window
composer create-project laravel/laravel laravel-hello "^12.0"
cd laravel-hello
composer require 'php:^8.4' 'ext-pdo_pgsql:*'
npm install

Версию PHP задаём в require файла composer.json: локальная настройка config.platform сама по себе не выбирает PHP на сервере. Сохраните composer.lock и package-lock.json: они фиксируют зависимости для сборки. Явное требование ext-pdo_pgsql нужно и сборщику, чтобы включить драйвер Postgres.

Замените routes/web.php:

<?php
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;
Route::get('/', function (Request $request) {
$name = $request->query('name', 'мир');
abort_unless(is_string($name), 422);
// Счётчик хранится в серверной сессии, имя экранирует шаблон Blade.
$visits = (int) $request->session()->get('visits', 0) + 1;
$request->session()->put('visits', $visits);
return view('hello', [
'name' => mb_substr($name, 0, 100),
'visits' => $visits,
]);
});
Route::post('/hello', function (Request $request) {
$data = $request->validate(['name' => ['required', 'string', 'max:100']]);
return redirect('/?'.http_build_query(['name' => $data['name']]));
});

Создайте resources/views/hello.blade.php:

<!doctype html>
<html lang="ru">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Laravel в WebShield</title>
@vite(['resources/css/app.css', 'resources/js/app.js'])
<h1>Здравствуйте, {{ $name }}!</h1>
<p>Посещений в этой сессии: {{ $visits }}</p>
<form method="post" action="{{ url('/hello') }}">
@csrf
<label>Ваше имя <input name="name" maxlength="100" required></label>
<button type="submit">Поздороваться</button>
</form>
</html>

Blade экранирует имя через {{ }}. Не заменяйте их на {!! !!} для данных посетителя. @csrf добавляет защиту формы, а @vite подключает собранные стили и JavaScript.

Замените bootstrap/app.php следующим кодом для Laravel 12:

<?php
use Illuminate\Foundation\Application;
use Illuminate\Foundation\Configuration\Exceptions;
use Illuminate\Foundation\Configuration\Middleware;
return Application::configure(basePath: dirname(__DIR__))
->withRouting(
web: __DIR__.'/../routes/web.php',
commands: __DIR__.'/../routes/console.php',
health: '/up',
)
->withMiddleware(function (Middleware $middleware): void {
// Входящие запросы доступны только через прокси платформы.
$middleware->trustProxies(at: '*', headers:
\Illuminate\Http\Request::HEADER_X_FORWARDED_FOR |
\Illuminate\Http\Request::HEADER_X_FORWARDED_HOST |
\Illuminate\Http\Request::HEADER_X_FORWARDED_PORT |
\Illuminate\Http\Request::HEADER_X_FORWARDED_PROTO
);
})
->withExceptions(function (Exceptions $exceptions): void {
})->create();

Так Laravel получит внешнее имя и HTTPS для ссылок и формы. Доверие всем прокси здесь рассчитано на Приложения WebShield: прямого публичного доступа к контейнеру нет. На собственном сервере с открытым портом задавайте только адреса доверенных прокси. Подробнее — документация Laravel о прокси.

Создайте в корне Caddyfile: сервер отдаёт только каталог public, слушает порт платформы и не включает отладочную запись заголовков запросов.

{
admin off
persist_config off
auto_https off
frankenphp
log {
format json
output stderr
level INFO
}
}
:{$PORT:8080} {
root * /app/public
encode gzip
php_server
}

Рядом создайте start-container.sh:

#!/bin/bash
set -euo pipefail
# Сначала снимаем кеш сборки: ключ и подключение к базе приходят только при запуске.
php artisan config:clear
php artisan package:discover --ansi
php artisan config:cache
php artisan migrate --force
php artisan route:cache
php artisan view:cache
exec docker-php-entrypoint --config /Caddyfile --adapter caddyfile

Кеш конфигурации очищается до миграций, затем создаётся с переменными запуска. Скрипт использует сервер сборщика; php artisan serve оставьте для локальной разработки. Dockerfile для этого примера не нужен. Подробности автоматической сборки — в документации PHP-сборщика.

Здесь миграции запускаются при старте: это подходит для первого учебного сайта с одним экземпляром. Для рабочего проекта продумайте отдельный управляемый запуск миграций и совместимость схемы с прежним кодом. Автоматическое масштабирование и повторные запуски могут вызвать миграции одновременно; отдельной задачи миграций в кабинете нет.

Terminal window
npm run build
php artisan migrate
php artisan serve

Откройте http://127.0.0.1:8000/, отправьте имя Анна & Борис и обновите страницу. Имя должно отображаться текстом, счётчик — расти. Локальная база этого шага не загружается на платформу. Остановите сервер сочетанием Ctrl+C.

В кабинете откройте Услуги → Приложения, ознакомьтесь с оплатой по факту и создайте проект laravel-demo. В нём создайте приложение web: вид Приложение, порт 8080, Наибольшее число экземпляров — 1.

В том же проекте создайте базу Postgres db размером 1 ГБ, без реплики. Дождитесь готовности базы. Это новая пустая база, отдельно от локальной SQLite.

В терминале выполните:

Terminal window
php artisan key:generate --show

Сохраните полученный ключ в надёжном месте. В приложении web нажмите Переменные окружения и добавьте значения:

Имя Значение
APP_NAME Laravel Demo
APP_ENV production
APP_DEBUG false
APP_KEY полученный ключ целиком, включая base64:
APP_URL https://app.example.com — ваше имя
DB_CONNECTION pgsql
DB_URL ${{db.url}}
SESSION_DRIVER database
SESSION_SECURE_COOKIE true
CACHE_STORE database
QUEUE_CONNECTION sync
LOG_CHANNEL stderr
LOG_LEVEL info

У Laravel 12 строка подключения называется DB_URL. Ссылка ${{db.url}} подставится при выкатке; пароль вручную копировать не нужно.

Не генерируйте новый APP_KEY при каждом запуске. Он должен оставаться тем же при обновлении и откате, иначе прежние зашифрованные данные и cookie нельзя будет прочитать. Для существующего сайта переносите его ключ, а не создавайте другой.

Добавьте .webshieldignore, чтобы исключить секреты, локальные зависимости и кеш:

.env
.env.*
!.env.example
/vendor/
/node_modules/
/public/build/
/public/hot
/auth.json
/database/*.sqlite*
/storage/logs/*
/bootstrap/cache/*.php

composer.json, оба lock-файла, package.json и исходники Vite должны остаться в архиве. Сборка создаст public/build заново.

Создайте webshield.toml:

[app]
project = "laravel-demo"
name = "web"

В карточке проекта выпустите Токен для CI, затем выполните:

Terminal window
webshield auth login
webshield apps deploy

Токен вставьте в приглашение входа; в файлы проекта его не записывайте. Дождитесь статуса Работает. При ошибке откройте Журнал сборки: должны определиться PHP и Laravel, установиться зависимости и выполниться vite build.

Во вкладке Имена добавьте свободное app.example.com своего домена. Если домена ещё нет в аккаунте, подключите его. При DNS в WebShield запись и сертификат создаются автоматически. Для DNS у другого провайдера добавьте записи из инструкции подключения без смены NS.

Откройте https://app.example.com/. Отправьте имя: форма должна вернуться на HTTPS, показать приветствие и увеличить счётчик.

В шаблоне замените Поздороваться на Отправить привет, повторите:

Terminal window
webshield apps deploy

В том же браузере обновите страницу: кнопка изменится, а счётчик продолжит расти. На вкладке Выкатки у первой успешной версии нажмите Вернуть эту версию: прежняя кнопка вернётся, сессия останется.

Откат возвращает код. Он не отменяет миграции и не восстанавливает базу; для восстановления данных используйте восстановление Postgres.

  • / и /up открываются по HTTPS; /up проверяет загрузку Laravel, а не сохранность данных.
  • Форма принимает имя Анна & Борис, возвращается на ваш адрес и сохраняет сессию.
  • <script>alert(1)</script> блокируется WAF или показывается текстом без выполнения.
  • Во вкладке сети браузера файлы из /build/assets/ отвечают 200.
  • После повторной выкатки и отката счётчик в том же браузере продолжает расти.
  • webshield apps logs показывает запуск и миграции без вывода секретов.

После знакомства отзовите учебный CI-токен, отвяжите имя, удалите учебное приложение и его базу. Работающие ресурсы оплачиваются по факту использования.

Что поддерживается и что настраивать отдельно

Заголовок раздела «Что поддерживается и что настраивать отдельно»
Возможность Как использовать
PHP, Composer, Laravel, Vite, HTTPS Сборка и запуск по этому руководству. Пример рассчитан на Laravel 12.
Постоянные данные и сессии Postgres; локальный диск приложения для них не подходит.
Redis-совместимый кеш Подключите Valkey и PHP-клиент Redis; справка. Этот пример использует кеш базы.
Очереди В примере sync: задача выполняется внутри запроса. Отдельного типа фонового сервиса без HTTP в кабинете нет; queue:work нельзя поставить единственной командой веб-приложения. Horizon требует отдельной настройки.
Планировщик schedule:run Автоматически не запускается. Нужен отдельный механизм запуска; сон приложения нельзя использовать как расписание.
Загружаемые файлы Используйте S3-диск Laravel и объектное хранилище. storage:link не делает диск контейнера постоянным.
Почта и Reverb Требуют отдельного подключения и проверки. Публикация веб-сайта сама их не настраивает.
Симптом Причина и решение
could not find driver Добавьте ext-pdo_pgsql в require файла composer.json, обновите lock-файл и пересоберите.
MissingAppKeyException или подключение к SQLite вместо Postgres Проверьте переменные и config:clear перед config:cache и миграциями в скрипте запуска.
Форма отвечает 419 или перенаправляет на HTTP Проверьте доверенные прокси, APP_URL, HTTPS и cookie; после правки переменных выкатите заново.
Vite manifest not found В архиве нужны package.json, lock-файл и исходники; в журнале сборки должен пройти npm run build.
Сессия исчезает после обновления Проверьте постоянный APP_KEY, SESSION_DRIVER=database, готовность Postgres и таблицу sessions из стандартных миграций.
Запуск не завершается Посмотрите журнал приложения: миграции должны пройти до запуска HTTP-сервера. Не включайте APP_DEBUG на публичном сайте.