laravel

Teljes telepítési útmutató a laravel keretrendszerhez NStrim platformon

Áttekintés

A Laravel egy PHP webalkalmazás-keretrendszer kifejező, elegáns szintaxissal. Ez az útmutató végigvezeti Önt egy Laravel alkalmazás telepítésén az NStrim platformon az elejétől a végéig.

Mielőtt elkezdené
Győződjön meg róla, hogy az irányítópultja nyitva van - szüksége lesz az ott megjelenített hitelesítő adatokra (felhasználónév, jelszó és adatbázis kapcsolati adatok).

Gyors kezdés

1

Tároló létrehozása sablonból

A vezérlőpultodon menj a Tools & Deployment fülre. Kattints a "New Repository" gombra, válaszd ki a Laravel sablont a legördülő menüből, add meg a repository nevét és az aldomaint, majd kattints a "Create Repository" gombra.

2

Klónozza a tárolóját

git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>
3

Függőségek telepítése

composer install
4

Környezet konfigurálása

Másolja a példa környezeti fájlt és konfigurálja az adatbázist (lásd az alábbi részletes utasításokat):

cp .env.example .env
php artisan key:generate
5

Migrációk futtatása és feltöltés

php artisan migrate
git add .
git commit -m "Initial setup"
git push origin main
Minden Git push automatikusan telepíti az alkalmazást. Ellenőrizze a Modul munka URL-jét az irányítópulton az élő webhely megtekintéséhez.

Helyi fejlesztés Dockerrel

Ha nincs helyben telepített PHP-je, használhatja a Dockert Laravel parancsok futtatásához. A projekt tartalmaz egy Dockerfile-t, amely mindent beállít.

Mi az a Docker?
A Docker izolált "konténereket" hoz létre az összes szükséges szoftverrel (PHP, Composer, Node.js) anélkül, hogy telepítené őket a számítógépére. Gondoljon rá úgy, mint egy könnyű virtuális gépre.

Előfeltételek

Telepítse a Docker Desktop-ot az operációs rendszeréhez (Windows, Mac vagy Linux).

Parancsok futtatása Dockerrel

Ahelyett, hogy közvetlenül futtatná a php artisan migrate parancsot, Docker konténerben futtatja: 

# Docker kép létrehozása (csak egyszer szükséges)
docker build -t laravel-app .

# Bármilyen artisan parancs futtatása
docker run --rm laravel-app php artisan migrate

# Composer install futtatása
docker run --rm -v $(pwd):/var/www/html laravel-app composer install

# Interaktív shell a konténerben
docker run --rm -it -v $(pwd):/var/www/html laravel-app bash
Megjegyzés
A Docker opcionális a helyi fejlesztéshez. Az NStrim platform automatikusan kezeli a telepítést - csak akkor van szüksége Dockerre, ha parancsokat szeretne futtatni helyben telepített PHP nélkül.

Adatbázis konfiguráció

Az NStrim platform MySQL/MariaDB adatbázist biztosít Önnek. A csatlakozáshoz konfigurálnia kell a .env fájlt a megfelelő adatbázis hitelesítő adatokkal.

Miért kell konfigurálni az adatbázist?

A Laravel egy .env fájlt használ a környezet-specifikus konfiguráció tárolására. Alapértelmezés szerint a sablon SQLite-ot használ (fájl alapú adatbázis), de az NStrim MySQL-t biztosít jobb teljesítmény és valós helyzetek kompatibilitás érdekében.

Lépésről lépésre konfiguráció

1

Nyissa meg a .env fájlt

Nyissa meg a .env fájlt a projekt gyökerében a kódszerkesztőjével.

2

Keresse meg az adatbázis részt

Keresse ezeket a sorokat (általában a 23. sor körül):

DB_CONNECTION=sqlite
# DB_HOST=127.0.0.1
# DB_PORT=3306
# DB_DATABASE=laravel
# DB_USERNAME=root
# DB_PASSWORD=
3

Frissítse a hitelesítő adataival

Cserélje ki az irányítópultjáról származó hitelesítő adatokkal:

DB_CONNECTION=mysql
DB_HOST=db.<session-domain>
DB_PORT=3306
DB_DATABASE=<your-username>
DB_USERNAME=<your-username>
DB_PASSWORD=<your-password>
Fontos
Az adatbázis neve és felhasználóneve általában megegyezik az irányítópult felhasználónevével (pl. student01). Ellenőrizze az irányítópult hitelesítő adatok részét a pontos értékekért.

Konfigurációs példa

Ha a felhasználóneve student01 és a session domain demo.nstrim.app:

DB_CONNECTION=mysql
DB_HOST=db.demo.nstrim.app
DB_PORT=3306
DB_DATABASE=student01
DB_USERNAME=student01
DB_PASSWORD=your-password-from-dashboard

Migrációk futtatása

A migrációk a Laravel módszere az adatbázis táblák létrehozására. Az adatbázis konfigurálása után futtassa a migrációkat a szükséges táblák beállításához: 

php artisan migrate

Ha visszaállítania és újra kell futtatnia az összes migrációt (ez törli az összes adatot): 

php artisan migrate:fresh

Migrációk futtatása seed adatokkal (ha a projektjének vannak seederei): 

php artisan migrate:fresh --seed

Projekt struktúra

A fájlok helyének megértése:

├── app/                  # Alkalmazás kód
│   ├── Http/
│   │   └── Controllers/  # A kontrollerek itt találhatók
│   └── Models/           # Eloquent modellek
├── config/               # Konfigurációs fájlok
├── database/
│   ├── migrations/       # Adatbázis migrációk
│   └── seeders/          # Adatbázis seederek
├── public/               # Nyilvános assets (CSS, JS, képek)
├── resources/
│   └── views/            # Blade sablonok
├── routes/
│   └── web.php           # Web útvonalak (URL → Kontroller)
├── .env                  # Környezeti konfiguráció (DB stb.)
└── composer.json         # PHP függőségek

Hasznos parancsok

php artisan serve Helyi fejlesztési szerver indítása
php artisan migrate Adatbázis migrációk futtatása
php artisan migrate:status Migrációk állapotának ellenőrzése
php artisan make:controller Új kontroller létrehozása
php artisan make:model -m Modell létrehozása migrációval
php artisan route:list Összes regisztrált útvonal listázása

Hibaelhárítás

SQLSTATE[HY000] [2002] Connection refused

Ok: Az adatbázis host helytelen vagy az adatbázis szerver nem elérhető.

Megoldás: Ellenőrizze, hogy a DB_HOST a .env fájlban megegyezik-e az irányítópult adatbázis hostjával (általában db.<session-domain>).

SQLSTATE[HY000] [1045] Access denied for user

Ok: Helytelen felhasználónév vagy jelszó.

Megoldás: Ellenőrizze, hogy a DB_USERNAME és DB_PASSWORD pontosan megegyezik-e az irányítópulton láthatóval. A jelszavak kis- és nagybetű érzékenyek!

SQLSTATE[HY000] [1049] Unknown database

Ok: Az adatbázis neve nem létezik.

Megoldás: Győződjön meg róla, hogy a DB_DATABASE a felhasználónevére van állítva (pl. student01). Az adatbázisa ugyanazzal a névvel lett előre létrehozva, mint a felhasználóneve.

No application encryption key has been specified

Ok: Az APP_KEY hiányzik a .env fájlból.

Megoldás: Futtassa a php artisan key:generate parancsot egy új kulcs generálásához.

500 Server Error telepítés után

Ok: Általában konfigurációs probléma vagy hiányzó függőségek.

Megoldás: Ellenőrizze:

  • A .env fájl létezik és helyes értékeket tartalmaz
  • Az APP_KEY be van állítva (futtassa a php artisan key:generate parancsot)
  • Minden függőség telepítve van (composer install)
  • Az adatbázis hitelesítő adatok helyesek

Telepítési munkafolyamat

Minden alkalommal, amikor kódot küld a Git-re, az alkalmazása automatikusan telepítésre kerül:

Kód módosítás git push Auto telepítés Éles!

A telepített alkalmazás URL-je ezt a formátumot követi: 

https://<your-subdomain>-<repo-name>.<session-domain>

Példa: https://student01-module-a.demo.nstrim.app

További információkért látogasson el a hivatalos Laravel Dokumentációhoz.