Aplikasi Laravel.
Apa yang projek Laravel dapat sedia ada: APP_KEY dan tetapan produksi, SQLite sehingga anda menambah pangkalan data, migrasi sebagai arahan keluaran, pekerja baris gilir dan penjadual.
Laravel dikenal pasti melalui laravel/framework dalam composer.json. Anda deploy projek itu seadanya — tanpa konfigurasi pelayan dan tanpa fail tambahan dalam repositori.
Cara ia dibina dan dijalankan
- PHP — versi terendah antara 8.2, 8.3 dan 8.4 yang memenuhi keperluan
phpdalamcomposer.json(8.3 jika tidak dinyatakan). - Composer —
composer install --no-dev --optimize-autoloader. - Aset front-end — jika
package.jsonmempunyai skripbuild(Vite), skrip itu dijalankan danpublic/builddisertakan. - Semasa bermula —
storage:link, kemudian cache konfigurasi, laluan dan paparan dibina. - HTTPS — aplikasi anda melihat permintaan HTTPS sebagai selamat, jadi
url(),asset()dan ubah hala menggunakanhttps://tanpa anda perlu mempercayai proksi sendiri.
Pemboleh ubah yang ditetapkan untuk anda
| Pemboleh ubah | Nilai |
|---|---|
APP_KEY | dijana sekali pada deploy pertama dan disimpan bersama pemboleh ubah anda |
APP_ENV | production |
APP_DEBUG | false |
APP_URL | alamat aplikasi |
LOG_CHANNEL | stderr — supaya tab Log menunjukkan log Laravel |
SESSION_DRIVER, CACHE_STORE | redis apabila aplikasi mempunyai Valkey, jika tidak file |
Mana-mana daripadanya boleh digantikan dengan pemboleh ubah anda sendiri yang mempunyai nama yang sama — contohnya SESSION_DRIVER=database. Lihat Pemboleh ubah persekitaran.
Pangkalan data: SQLite dahulu
Aplikasi Laravel baharu tanpa pangkalan data menyimpan datanya dalam SQLite — tetapan lalai Laravel sendiri — di storage/app/database.sqlite pada cakera aplikasi. Fail ini kekal selepas deploy dan disertakan dalam sandaran harian aplikasi, jadi anda boleh melancarkan dahulu dan memilih pangkalan data kemudian.
Apabila anda menambah PostgreSQL atau MySQL pada projek (Gambaran keseluruhan → Perkhidmatan → Tambah perkhidmatan), aplikasi beralih kepadanya pada deploy seterusnya, dan migrasi dijalankan di sana. Data dalam fail SQLite tidak dipindahkan — eksport dahulu jika anda memerlukannya, dan importnya pada tab Data pangkalan data. Lihat Pangkalan data.
Migrasi — arahan keluaran
Arahan keluaran yang disyorkan ialah php artisan migrate --force. Ia dijalankan sekali pada setiap deploy, sebelum versi baharu menerima pelawat; jika migrasi gagal, versi semasa terus berjalan. Anda boleh menukarnya pada tab Proses. Lihat Deploy.
Pekerja baris gilir dan penjadual
Secara lalai, tab Proses menjalankan:
| Apa | Arahan |
|---|---|
| Pekerja latar belakang «queue» | php artisan queue:work --sleep=3 --tries=3 --max-time=3600 |
| Arahan berjadual, setiap minit | php artisan schedule:run |
Kedua-duanya berkongsi sumber aplikasi dan dimulakan semula pada setiap deploy. Tukar atau buangnya pada tab Proses — contohnya, gantikan pekerja dengan php artisan horizon apabila anda menggunakan Horizon dengan Valkey.
Untuk baris gilir yang berat, jalankan pekerja sebagai perkhidmatan pekerja latar belakang yang berasingan dengan sumbernya sendiri, dan buangnya daripada Proses. Lihat Perkhidmatan projek.
Valkey untuk cache, sesi dan baris gilir
Tambahkan Valkey pada projek: sesi dan cache beralih kepadanya dengan sendiri (pada deploy seterusnya; pelawat perlu log masuk sekali lagi). Baris gilir dan apa-apa yang lain anda tetapkan pada tab Pemboleh ubah, contohnya:
CACHE_STORE=redis
SESSION_DRIVER=redis
QUEUE_CONNECTION=redisREDIS_HOST, REDIS_PASSWORD, REDIS_PORT dan REDIS_CLIENT=phpredis ditetapkan untuk anda.
WebSocket (Laravel Reverb)
Jalankan Reverb sebagai perkhidmatan web daripada kod projek ini dengan arahan php artisan reverb:start --host=0.0.0.0 --port=$PORT. Ia mendapat alamatnya sendiri.
Fail dan muat naik
Fail dalam storage/app — cakera local dan public Laravel — kekal pada cakera aplikasi antara deploy dan disandarkan setiap hari. Selebihnya dalam folder projek datang semula daripada repositori pada setiap deploy. Untuk fail yang banyak atau besar, gunakan storan objek dengan cakera s3 Laravel.