Konfigurace projektu
Konfigurace a nejdůležitější nastavení projektu.
Po instalaci projektu není potřeba nic měnit či přenastavovat. Je ale dobré, možnosti nastavení znát.
Environment proměnné
V .env souboru najdete veškrá nastavení projektu. Od nastavení aplikace, přes přepínání do produkčního
módu, logování, připojení k databázi a úložišti (AWS S3) až po SMTP a debugger.
Hlavní výhodou environment proměnných je to, že je snadno změníte pro různé prostředí (dev, staging, production). V kapitolách nasazení na server si pak ukážeme, jak je nastavit na produkčním serveru pro konkrétní projekt.
APP_URL=http://localhost:8090
APP_NAME=dev-appname
APP_ENV_MODE=develop
APP_TIME_ZONE=Europe/Prague
APP_TRUSTED_PROXIES=192.168.0.0/16,172.16.0.0/12,10.0.0.0/8
APP_STORAGE_ADAPTER=s3
AUTH_EXPIRATION=1day
AUTH_STRICT_RESOURCES=false
LOG_ADAPTER=local
LOG_MAIL=
DB_DRIVER=pdo_sqlite
DB_SQLITE_FILE=db.sqlite3
#DB_DRIVER=pdo_pgsql
#DB_HOST=postgres
#DB_PORT=5432
#DB_USERNAME=root
#DB_PASSWORD=root
#DB_DATABASE=dev-appname
S3_ENDPOINT=https://s3.eu-central-1.amazonaws.com
S3_REGION=eu-central-1
S3_BUCKET=dev-appname
S3_KEY=
S3_SECRET=
SMTP_SENDER=fw@strategio.dev
SMTP_HOST=email-smtp.eu-central-1.amazonaws.com
SMTP_USERNAME=
SMTP_PASSWORD=
SMTP_PORT=465
SMTP_SECURE=ssl
TRACY_EDITOR=phpstorm://open?file=%file&line=%line
TRACY_EDITOR_MAPPING=/Users/jz/www/<local_project_path>
Admin panel
Admin panel je naprogramován jako Vue aplikace a je možné ho nastavit dle potřeb pro každý váš projekt.
Veškeré nastavení lze upravit v souboru assets/panel.ts. Kompletní
dokumentace megio panelu je zde.
// Minimal setup
import 'megio-panel/styles'
import { createMegioPanel } from 'megio-panel'
createMegioPanel(window.location.host.includes('localhost') ? 'http://localhost:8090/' : '/')
DI container
V souboru config/app.neon můžete registrovat vlastní služby. Zároveň zde můžete načítat i další .neon soubory nebo
registrovat celá DI rozšíření jako je například contributte/translations.
Long story short: Pokud do DI zaregistrujete nějakou třídu (službu), automaticky se vytvoří její továrnička. Chytrý auto-wiring zajistí, že služba bude dostupná v kterémkoli konstruktoru ostatních tříd - to vám zabezpečí, zrychlí, zpřehlední a zkrátí kód. Pokud jste se s Nette\DI ještě nesetkali, prostudujte si tuto dokumentaci.
# Registrace entity manageru a user-create commandu
services:
entityManager: App\Database\EntityManager
- App\Console\UserCreateCommand
# Načtení dalších neon souborů
includes:
- ./../vendor/strategio/megio-core/config/app.neon
- ./../vendor/strategio/megio-core/config/events.neon
# Registrace vlastních event subscriberů
events:
- App\Subscriber\Collection\OnUserCreated
#- Megio\Subscriber\RedirectToWww
# Načtení dalších DI extensions
extensions:
doctrine: Megio\Extension\Doctrine\DoctrineExtension
events: Megio\Extension\Events\EventsExtension
latte: Megio\Extension\Latte\LatteExtension
Docker compose
V případě použití Dockeru pro lokální vývoj je dobré umět pracovat se souborem docker-compose.yml, ve kterém
specifikujete, které serverové balíčky (images) se mají sestavit pro lokální vývoj. Pokud bychom například chtěli
zapnout Postgres databázi, stačí odkomentovat řádky a spustit příkaz ./project.sh serve.
version: '3'
networks:
megio-apps:
services:
app:
build:
context: .
dockerfile: Dockerfile
restart: "no"
networks:
- megio-apps
ports:
- "8090:80"
volumes:
- ./docker/nginx/nginx.conf:/etc/nginx/nginx.conf
- ./docker/nginx/http.d/default.conf:/etc/nginx/http.d/default.conf
- ./docker/php/php.ini:/usr/local/etc/php/conf.d/php.ini
- $PWD:/var/www/html:cached
# postgres:
# image: postgres:16
# #restart: on-failure because postgres shutdown on first creation (permissions problem)
# restart: "on-failure"
# environment:
# POSTGRES_USER: ${DB_USERNAME}
# POSTGRES_PASSWORD: ${DB_PASSWORD}
# POSTGRES_DB: ${DB_DATABASE}
# networks:
# - megio-apps
# ports:
# - "${DB_PORT}:5432"
# volumes:
# - ./docker/temp/postgres:/var/lib/postgresql/data:cached