Εφαρμογές Laravel.
Τι παίρνει έτοιμο ένα project Laravel: APP_KEY και ρυθμίσεις παραγωγής, SQLite μέχρι να προσθέσεις βάση δεδομένων, migrations ως εντολή release, queue worker και scheduler.
Το Laravel αναγνωρίζεται από το laravel/framework στο composer.json. Το κάνεις deploy όπως είναι — χωρίς ρυθμίσεις server, χωρίς επιπλέον αρχεία στο repository.
Πώς γίνεται το build και πώς τρέχει
- PHP — η χαμηλότερη από 8.2, 8.3 και 8.4 που ικανοποιεί την απαίτηση
phpστοcomposer.json(8.3 όταν δεν ορίζεται). - Composer —
composer install --no-dev --optimize-autoloader. - Front-end assets — αν το
package.jsonέχει scriptbuild(Vite), εκτελείται και περιλαμβάνεται τοpublic/build. - Κατά την εκκίνηση —
storage:linkκαι μετά δημιουργούνται οι caches για config, routes και views. - HTTPS — η εφαρμογή σου βλέπει τα αιτήματα HTTPS ως ασφαλή, οπότε τα
url(),asset()και οι ανακατευθύνσεις χρησιμοποιούνhttps://χωρίς να χρειάζεται να ορίσεις εσύ trusted proxies.
Μεταβλητές που ορίζονται για σένα
| Μεταβλητή | Τιμή |
|---|---|
APP_KEY | δημιουργείται μία φορά στο πρώτο deploy και φυλάσσεται μαζί με τις μεταβλητές σου |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | η διεύθυνση της εφαρμογής |
LOG_CHANNEL | stderr — ώστε η καρτέλα Logs να δείχνει το log του Laravel |
SESSION_DRIVER, CACHE_STORE | redis όταν η εφαρμογή έχει Valkey, αλλιώς file |
Οποιαδήποτε από αυτές μπορεί να αντικατασταθεί από δική σου μεταβλητή με το ίδιο όνομα — για παράδειγμα SESSION_DRIVER=database. Δες Μεταβλητές περιβάλλοντος.
Η βάση δεδομένων: πρώτα SQLite
Μια νέα εφαρμογή Laravel χωρίς βάση δεδομένων κρατά τα δεδομένα της σε SQLite — την προεπιλογή του ίδιου του Laravel — στο storage/app/database.sqlite στον δίσκο της εφαρμογής. Το αρχείο διατηρείται στα deploys και περιλαμβάνεται στα ημερήσια backup της εφαρμογής, οπότε μπορείς να ξεκινήσεις πρώτα και να αποφασίσεις για βάση δεδομένων αργότερα.
Όταν προσθέσεις PostgreSQL ή MySQL στο project (Επισκόπηση → Υπηρεσίες → Προσθήκη υπηρεσίας), η εφαρμογή περνά σε αυτήν με το επόμενο deploy και τα migrations τρέχουν εκεί. Τα δεδομένα του αρχείου SQLite δεν μεταφέρονται — κάνε πρώτα εξαγωγή αν τα χρειάζεσαι και εισαγωγή στην καρτέλα Δεδομένα της βάσης. Δες Βάσεις δεδομένων.
Migrations — η εντολή release
Η προτεινόμενη εντολή release είναι php artisan migrate --force. Τρέχει μία φορά σε κάθε deploy, πριν η νέα έκδοση δεχτεί επισκέπτες· αν ένα migration αποτύχει, η τρέχουσα έκδοση συνεχίζει να τρέχει. Μπορείς να την αλλάξεις στην καρτέλα Διεργασίες. Δες Deploys.
Queue worker και scheduler
Από την αρχή, η καρτέλα Διεργασίες τρέχει:
| Τι | Εντολή |
|---|---|
| Background worker «queue» | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| Προγραμματισμένη εντολή, κάθε λεπτό | php artisan schedule:run |
Μοιράζονται τους πόρους της εφαρμογής και κάνουν επανεκκίνηση με κάθε deploy. Άλλαξέ τα ή αφαίρεσέ τα στην καρτέλα Διεργασίες — για παράδειγμα, αντικατέστησε τον worker με php artisan horizon όταν χρησιμοποιείς Horizon με Valkey.
Για βαριά ουρά, τρέξε τον worker ως ξεχωριστή υπηρεσία background worker με δικούς της πόρους και αφαίρεσέ τον από τις Διεργασίες. Δες Υπηρεσίες ενός project.
Valkey για cache, sessions και ουρές
Πρόσθεσε Valkey στο project: τα sessions και η cache μεταφέρονται εκεί μόνα τους (με το επόμενο deploy· οι επισκέπτες συνδέονται άλλη μία φορά). Τις ουρές και οτιδήποτε άλλο τα ορίζεις στην καρτέλα Μεταβλητές, π.χ.:
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisΤα REDIS_HOST, REDIS_PASSWORD, REDIS_PORT και REDIS_CLIENT=phpredis ορίζονται για σένα.
WebSockets (Laravel Reverb)
Τρέξε το Reverb ως web υπηρεσία από τον κώδικα αυτού του project με την εντολή php artisan reverb:start --host=0.0.0.0 --port=$PORT. Παίρνει δική του διεύθυνση.
Αρχεία και uploads
Τα αρχεία στο storage/app — οι δίσκοι local και public του Laravel — μένουν στον δίσκο της εφαρμογής ανάμεσα στα deploys και γίνεται backup τους κάθε μέρα. Όλα τα υπόλοιπα στον φάκελο του project έρχονται φρέσκα από το repository σε κάθε deploy. Για πολλά ή μεγάλα αρχεία, χρησιμοποίησε τον χώρο αποθήκευσης αντικειμένων με τον δίσκο s3 του Laravel.