laravel

Pilns izvietošanas ceļvedis laravel uz NStrim

Pārskats

Laravel ir PHP tīmekļa lietojumprogrammu ietvars ar izteiksmīgu, elegantu sintaksi. Šis ceļvedis palīdzēs jums izvietot Laravel lietojumprogrammu NStrim platformā no sākuma līdz beigām.

Pirms sākat
Pārliecinieties, ka jums ir atvērts informācijas panelis - jums būs nepieciešami tur redzamie akreditācijas dati (lietotājvārds, parole un datubāzes savienojuma informācija).

Ātrais sākums

1

Izveidojiet repozitoriju no veidnes

Savā vadības panelī atveriet cilni Tools & Deployment. Noklikšķiniet uz pogas "New Repository", izvēlieties Laravel veidni no nolaižamā saraksta, ievadiet repozitorija nosaukumu un apakšdomēnu, un noklikšķiniet "Create Repository".

2

Klonējiet savu repozitoriju

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

Instalējiet atkarības

composer install
4

Konfigurējiet vidi

Nokopējiet vides faila paraugu un konfigurējiet datubāzi (skatiet detalizētas instrukcijas zemāk):

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

Palaidiet migrācijas un augšupielādējiet

php artisan migrate
git add .
git commit -m "Initial setup"
git push origin main
Katrs push uz Git automātiski izvieto jūsu lietojumprogrammu. Pārbaudiet savu Moduļa darba URL informācijas panelī, lai redzētu savu tiešsaistes vietni.

Lokālā izstrāde ar Docker

Ja jums nav lokāli instalēts PHP, varat izmantot Docker, lai palaistu Laravel komandas. Projektā ir iekļauts Dockerfile, kas iestata visu nepieciešamo.

Kas ir Docker?
Docker izveido izolētus "konteinerus" ar visu nepieciešamo programmatūru (PHP, Composer, Node.js), neinstalējot to jūsu datorā. Iedomājieties to kā vieglu virtuālo mašīnu.

Priekšnosacījumi

Instalējiet Docker Desktop savai operētājsistēmai (Windows, Mac vai Linux).

Komandu palaišana ar Docker

Tā vietā, lai tieši palaistu php artisan migrate, jūs to palaižat Docker konteinerā: 

# Izveidot Docker attēlu (nepieciešams tikai vienreiz)
docker build -t laravel-app .

# Palaist jebkuru artisan komandu
docker run --rm laravel-app php artisan migrate

# Palaist composer install
docker run --rm -v $(pwd):/var/www/html laravel-app composer install

# Interaktīvā čaula konteinerā
docker run --rm -it -v $(pwd):/var/www/html laravel-app bash
Piezīme
Docker ir neobligāts lokālai izstrādei. NStrim platforma automātiski apstrādā izvietošanu - Docker ir nepieciešams tikai tad, ja vēlaties palaist komandas lokāli bez instalēta PHP.

Datubāzes konfigurācija

NStrim platforma nodrošina jums MySQL/MariaDB datubāzi. Jums ir jākonfigurē .env fails ar pareiziem datubāzes akreditācijas datiem, lai izveidotu savienojumu.

Kāpēc konfigurēt datubāzi?

Laravel izmanto .env failu, lai glabātu videi specifisko konfigurāciju. Pēc noklusējuma veidne izmanto SQLite (failu bāzētu datubāzi), bet NStrim nodrošina MySQL labākai veiktspējai un savietojamībai ar reālās pasaules scenārijiem.

Soli pa solim konfigurācija

1

Atveriet savu .env failu

Atveriet .env failu projekta saknē ar savu koda redaktoru.

2

Atrodiet datubāzes sadaļu

Meklējiet šīs rindas (parasti ap 23. rindu):

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

Atjauniniet ar saviem akreditācijas datiem

Aizstājiet ar akreditācijas datiem no jūsu informācijas paneļa:

DB_CONNECTION=mysql
DB_HOST=db.<session-domain>
DB_PORT=3306
DB_DATABASE=<your-username>
DB_USERNAME=<your-username>
DB_PASSWORD=<your-password>
Svarīgi
Jūsu datubāzes nosaukums un lietotājvārds parasti ir tāds pats kā jūsu informācijas paneļa lietotājvārds (piemēram, student01). Pārbaudiet informācijas paneļa akreditācijas datu sadaļu precīzām vērtībām.

Konfigurācijas piemērs

Ja jūsu lietotājvārds ir student01 un sesijas domēns ir 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āciju palaišana

Migrācijas ir Laravel veids, kā izveidot datubāzes tabulas. Pēc datubāzes konfigurēšanas palaidiet migrācijas, lai iestatītu nepieciešamās tabulas: 

php artisan migrate

Ja nepieciešams atiestatīt un atkārtoti palaist visas migrācijas (tas izdzēsīs visus datus): 

php artisan migrate:fresh

Lai palaistu migrācijas ar sākuma datiem (ja jūsu projektam ir seederi): 

php artisan migrate:fresh --seed

Projekta struktūra

Izpratne par failu atrašanās vietām:

├── app/                  # Lietojumprogrammas kods
│   ├── Http/
│   │   └── Controllers/  # Šeit atrodas jūsu kontrolieri
│   └── Models/           # Eloquent modeļi
├── config/               # Konfigurācijas faili
├── database/
│   ├── migrations/       # Datubāzes migrācijas
│   └── seeders/          # Datubāzes seederi
├── public/               # Publiskie resursi (CSS, JS, attēli)
├── resources/
│   └── views/            # Blade veidnes
├── routes/
│   └── web.php           # Tīmekļa maršruti (URL → Kontrolieris)
├── .env                  # Vides konfigurācija (DB utt.)
└── composer.json         # PHP atkarības

Noderīgas komandas

php artisan serve Sākt lokālo izstrādes serveri
php artisan migrate Palaist datubāzes migrācijas
php artisan migrate:status Pārbaudīt migrāciju statusu
php artisan make:controller Izveidot jaunu kontrolieri
php artisan make:model -m Izveidot modeli ar migrāciju
php artisan route:list Uzskaitīt visus reģistrētos maršrutus

Problēmu novēršana

SQLSTATE[HY000] [2002] Connection refused

Iemesls: Datubāzes resursdators ir nepareizs vai datubāzes serveris nav pieejams.

Risinājums: Pārbaudiet, vai DB_HOST jūsu .env failā atbilst datubāzes resursdatoram no jūsu informācijas paneļa (parasti db.<session-domain>).

SQLSTATE[HY000] [1045] Access denied for user

Iemesls: Nepareizs lietotājvārds vai parole.

Risinājums: Vēlreiz pārbaudiet, vai DB_USERNAME un DB_PASSWORD precīzi atbilst jūsu informācijas panelī redzamajam. Paroles ir reģistrjutīgas!

SQLSTATE[HY000] [1049] Unknown database

Iemesls: Datubāzes nosaukums neeksistē.

Risinājums: Pārliecinieties, ka DB_DATABASE ir iestatīts uz jūsu lietotājvārdu (piemēram, student01). Jūsu datubāze ir iepriekš izveidota ar tādu pašu nosaukumu kā jūsu lietotājvārds.

No application encryption key has been specified

Iemesls: APP_KEY trūkst .env failā.

Risinājums: Palaidiet php artisan key:generate, lai ģenerētu jaunu atslēgu.

500 servera kļūda pēc izvietošanas

Iemesls: Parasti konfigurācijas problēma vai trūkstošas atkarības.

Risinājums: Pārbaudiet, vai:

  • .env fails eksistē un tam ir pareizas vērtības
  • APP_KEY ir iestatīts (palaidiet php artisan key:generate)
  • Visas atkarības ir instalētas (composer install)
  • Datubāzes akreditācijas dati ir pareizi

Izvietošanas darbplūsma

Katru reizi, kad jūs nosūtāt kodu uz Git, jūsu lietojumprogramma tiek automātiski izvietota:

Koda izmaiņas git push Auto izvietošana Tiešsaistē!

Jūsu izvietotās lietojumprogrammas URL formāts ir šāds: 

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

Piemērs: https://student01-module-a.demo.nstrim.app

Papildu informācijai apmeklējiet oficiālo Laravel dokumentāciju.