Как опубликовать сайт на 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.
1. Создайте проект Laravel
Заголовок раздела «1. Создайте проект Laravel»composer create-project laravel/laravel laravel-hello "^12.0"cd laravel-hellocomposer 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.
2. Добавьте страницу с формой
Заголовок раздела «2. Добавьте страницу с формой»Замените 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.
3. Настройте работу за HTTPS-прокси
Заголовок раздела «3. Настройте работу за HTTPS-прокси»Замените 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 о прокси.
4. Подготовьте запуск
Заголовок раздела «4. Подготовьте запуск»Создайте в корне 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/bashset -euo pipefail
# Сначала снимаем кеш сборки: ключ и подключение к базе приходят только при запуске.php artisan config:clearphp artisan package:discover --ansiphp artisan config:cachephp artisan migrate --forcephp artisan route:cachephp artisan view:cache
exec docker-php-entrypoint --config /Caddyfile --adapter caddyfileКеш конфигурации очищается до миграций, затем создаётся с переменными запуска.
Скрипт использует сервер сборщика; php artisan serve оставьте для локальной разработки.
Dockerfile для этого примера не нужен. Подробности автоматической сборки —
в документации PHP-сборщика.
Здесь миграции запускаются при старте: это подходит для первого учебного сайта с одним экземпляром. Для рабочего проекта продумайте отдельный управляемый запуск миграций и совместимость схемы с прежним кодом. Автоматическое масштабирование и повторные запуски могут вызвать миграции одновременно; отдельной задачи миграций в кабинете нет.
5. Проверьте сайт на компьютере
Заголовок раздела «5. Проверьте сайт на компьютере»npm run buildphp artisan migratephp artisan serveОткройте http://127.0.0.1:8000/, отправьте имя Анна & Борис и обновите страницу.
Имя должно отображаться текстом, счётчик — расти. Локальная база этого шага не загружается
на платформу. Остановите сервер сочетанием Ctrl+C.
6. Создайте приложение и базу
Заголовок раздела «6. Создайте приложение и базу»В кабинете откройте Услуги → Приложения,
ознакомьтесь с оплатой по факту и создайте проект laravel-demo.
В нём создайте приложение web: вид Приложение, порт 8080,
Наибольшее число экземпляров — 1.
В том же проекте создайте базу Postgres db размером 1 ГБ, без реплики.
Дождитесь готовности базы. Это новая пустая база, отдельно от локальной SQLite.
7. Задайте переменные
Заголовок раздела «7. Задайте переменные»В терминале выполните:
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 нельзя будет прочитать.
Для существующего сайта переносите его ключ, а не создавайте другой.
8. Загрузите исходники
Заголовок раздела «8. Загрузите исходники»Добавьте .webshieldignore, чтобы исключить секреты, локальные зависимости и кеш:
.env.env.*!.env.example/vendor//node_modules//public/build//public/hot/auth.json/database/*.sqlite*/storage/logs/*/bootstrap/cache/*.phpcomposer.json, оба lock-файла, package.json и исходники Vite должны остаться в архиве.
Сборка создаст public/build заново.
Создайте webshield.toml:
[app]project = "laravel-demo"name = "web"В карточке проекта выпустите Токен для CI, затем выполните:
webshield auth loginwebshield apps deployТокен вставьте в приглашение входа; в файлы проекта его не записывайте.
Дождитесь статуса Работает. При ошибке откройте Журнал сборки:
должны определиться PHP и Laravel, установиться зависимости и выполниться vite build.
9. Подключите имя
Заголовок раздела «9. Подключите имя»Во вкладке Имена добавьте свободное app.example.com своего домена.
Если домена ещё нет в аккаунте, подключите его.
При DNS в WebShield запись и сертификат создаются автоматически. Для DNS у другого
провайдера добавьте записи из инструкции подключения без смены NS.
Откройте https://app.example.com/. Отправьте имя: форма должна вернуться на HTTPS,
показать приветствие и увеличить счётчик.
10. Обновите сайт и проверьте данные
Заголовок раздела «10. Обновите сайт и проверьте данные»В шаблоне замените Поздороваться на Отправить привет, повторите:
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 на публичном сайте. |
Что дальше
Заголовок раздела «Что дальше»- Приложения — переменные, сон, журнал и стоимость.
- Postgres — резервные копии и восстановление.
- Выкатка из приватного репозитория — обновление через CI.