Home Explore Help
Sign In
SMusatov
/
frankenphp
mirror of https://github.com/dunglas/frankenphp
1
0
Fork 0
Files
Branch: main
Branches Tags
frankenphp
/
docs
/
ru
/
laravel.md

laravel.md 9.0 KB
Permalink History Raw

Laravel

Docker

Запустить Laravel веб-приложение с FrankenPHP очень просто: достаточно смонтировать проект в директорию /app официального Docker-образа.

Выполните эту команду из корневой директории вашего Laravel-приложения:

docker run -p 80:80 -p 443:443 -p 443:443/udp -v $PWD:/app dunglas/frankenphp

И наслаждайтесь!

Локальная установка

Вы также можете запустить ваши Laravel-проекты с FrankenPHP на локальной машине:

  1. Скачайте бинарный файл для вашей системы

  2. Добавьте следующую конфигурацию в файл с именем Caddyfile в корневой директории вашего Laravel-проекта:

    {
    frankenphp
}

# Доменное имя вашего сервера
localhost {
    # Укажите веб-корень как директорию public/
    root * public/
    # Включите сжатие (опционально)
    encode zstd br gzip
    # Выполняйте PHP-файлы из директории public/ и обслуживайте статические файлы
    php_server
}

  3. Запустите FrankenPHP из корневой директории вашего Laravel-проекта: frankenphp run

Laravel Octane

Octane можно установить с помощью менеджера пакетов Composer:

composer require laravel/octane

После установки Octane выполните Artisan-команду octane:install, которая создаст конфигурационный файл Octane в вашем приложении:

php artisan octane:install --server=frankenphp

Сервер Octane можно запустить с помощью Artisan-команды octane:frankenphp:

php artisan octane:frankenphp

Команда octane:frankenphp поддерживает следующие опции:

  • --host: IP-адрес, к которому должен привязаться сервер (по умолчанию: 127.0.0.1)
  • --port: Порт, на котором сервер будет доступен (по умолчанию: 8000)
  • --admin-port: Порт, на котором будет доступен административный сервер (по умолчанию: 2019)
  • --workers: Количество worker-скриптов для обработки запросов (по умолчанию: auto)
  • --max-requests: Количество запросов, обрабатываемых перед перезагрузкой сервера (по умолчанию: 500)
  • --caddyfile: Путь к файлу Caddyfile FrankenPHP (по умолчанию: stubbed Caddyfile в Laravel Octane)
  • --https: Включить HTTPS, HTTP/2 и HTTP/3, а также автоматически генерировать и обновлять сертификаты
  • --http-redirect: Включить редирект с HTTP на HTTPS (включается только при передаче --https)
  • --watch: Автоматически перезагружать сервер при изменении приложения
  • --poll: Использовать опрос файловой системы для отслеживания изменений в файлах через сеть
  • --log-level: Установить уровень логирования, используя встроенный логгер Caddy

[!TIP] Чтобы получить структурированные JSON-логи (полезно при использовании решений для анализа логов), явно укажите опцию --log-level.

Подробнее о Laravel Octane читайте в официальной документации.

Laravel-приложения как автономные бинарные файлы

Используя возможность встраивания приложений в FrankenPHP, можно распространять Laravel-приложения как автономные бинарные файлы.

Следуйте этим шагам, чтобы упаковать ваше Laravel-приложение в автономный бинарный файл для Linux:

  1. Создайте файл с именем static-build.Dockerfile в репозитории вашего приложения:

    FROM --platform=linux/amd64 dunglas/frankenphp:static-builder

# Скопируйте ваше приложение
WORKDIR /go/src/app/dist/app
COPY . .

# Удалите тесты и другие ненужные файлы, чтобы сэкономить место
# В качестве альтернативы добавьте эти файлы в .dockerignore
RUN rm -Rf tests/

# Скопируйте файл .env
RUN cp .env.example .env
# Измените APP_ENV и APP_DEBUG для продакшна
RUN sed -i'' -e 's/^APP_ENV=.*/APP_ENV=production/' -e 's/^APP_DEBUG=.*/APP_DEBUG=false/' .env

# Внесите другие изменения в файл .env, если необходимо

# Установите зависимости
RUN composer install --ignore-platform-reqs --no-dev -a

# Соберите статический бинарный файл
WORKDIR /go/src/app/
RUN EMBED=dist/app/ ./build-static.sh

    [!CAUTION]

    Некоторые .dockerignore файлы могут игнорировать директорию vendor/ и файлы .env. Убедитесь, что вы скорректировали или удалили .dockerignore перед сборкой.

  2. Соберите:

    docker build -t static-laravel-app -f static-build.Dockerfile .

  3. Извлеките бинарный файл:

    docker cp $(docker create --name static-laravel-app-tmp static-laravel-app):/go/src/app/dist/frankenphp-linux-x86_64 frankenphp ; docker rm static-laravel-app-tmp

  4. Заполните кеши:

    frankenphp php-cli artisan optimize

  5. Запустите миграции базы данных (если есть):

    frankenphp php-cli artisan migrate

  6. Сгенерируйте секретный ключ приложения:

    frankenphp php-cli artisan key:generate

  7. Запустите сервер:

    frankenphp php-server

Ваше приложение готово!

Узнайте больше о доступных опциях и о том, как собирать бинарные файлы для других ОС в документации по встраиванию приложений.

Изменение пути хранения

По умолчанию Laravel сохраняет загруженные файлы, кеши, логи и другие данные в директории storage/ приложения. Это неудобно для встроенных приложений, так как каждая новая версия будет извлекаться в другую временную директорию.

Установите переменную окружения LARAVEL_STORAGE_PATH (например, в вашем .env файле) или вызовите метод Illuminate\Foundation\Application::useStoragePath(), чтобы использовать директорию за пределами временной директории.

Запуск Octane как автономный бинарный файл

Можно даже упаковать приложения Laravel Octane как автономный бинарный файл!

Для этого установите Octane правильно и следуйте шагам, описанным в предыдущем разделе.

Затем, чтобы запустить FrankenPHP в worker-режиме через Octane, выполните:

PATH="$PWD:$PATH" frankenphp php-cli artisan octane:frankenphp

[!CAUTION] Для работы команды автономный бинарник обязательно должен быть назван frankenphp, так как Octane требует наличия программы с именем frankenphp в PATH.