Home Arrow Icon Knowledge base Arrow Icon Global Arrow Icon Melyek a Laravel Sail -ban alkalmazott általános környezeti változók


Melyek a Laravel Sail -ban alkalmazott általános környezeti változók


A Laravel Sail, a Laravel fejlesztési környezete a Docker használatával, nagymértékben támaszkodik a környezeti változókra, amelyeket elsősorban a „.env” fájlban határoznak meg a projekt gyökérében. Ezek a környezeti változók konfigurálják az alkalmazást és annak szolgáltatásait, lehetővé téve a konténerek zökkenőmentes hangszerelését és a helyi fejlesztéshez megfelelő beállítások hangolását.

A Laravel Sailban használt közös környezeti változók céljaik szerint csoportosíthatók: alkalmazáskonfiguráció, adatbázis-konfiguráció, szolgáltatási portok és kötések, a Container felhasználói beállításai és a vitorlás-specifikus testreszabások.

alkalmazáskonfigurációs változók

- `App_Name`: meghatározza a Laravel alkalmazás nevét.
- `App_env`: beállítja a környezet típusát, általában a„ helyi ”vitorláshoz.
- `App_Key`: Base64-kódolt titkosítási kulcs, amelyet a Laravel használ a titkosításhoz és a munkamenet biztonságához.
- `App_debug`: logikai zászló a részletes hibaüzenetek és hibakeresési szolgáltatások (` true "vagy„ false ”) engedélyezéséhez.
- `App_url`: Az URL, ahol az alkalmazás helyben elérhető, gyakran„ http: // localhost ”-ra állítja.

Adatbázis -csatlakozási változók

Az adatbázis -tároló (`mysql` szolgáltatás) hangszereléséhez a Sail olyan változókat használ, amelyek meghatározzák a kapcsolatot a MySQL adatbázis -tárolóval:

- `db_connection`: jelzi az adatbázis -illesztőprogramot, általában` mysql`.
- `DB_HOST`: Az adatbázis -kiszolgáló gazdagépneve, általában a MySQL Container neve, például a` mysql '.
- `db_port`: alapértelmezett port a MySQL csatlakozáshoz, általában` 3306 '.
- `DB_DATABASE`: Az adatbázis neve, amelyet a konténerben használnak.
- `db_userName`: Felhasználónév az adatbázis eléréséhez.
- `db_password`: Jelszó az adatbázis -felhasználóhoz.

redis konfiguráció

A vitorlás opcionálisan támogatja a redist a gyorsítótárazáshoz vagy a munkamenetkezeléshez. Ezek a változók konfigurálják a Redis kapcsolatot:

- `redis_host`: gazdagépnév a Redis szerverhez, gyakran` redis`, hogy megfeleljen a Redis tárolóhoz.
- `redis_password`: Jelszó a redishez, ha van.
- `redis_port`: A Port Redis hallgat, gyakran` 6379 '.

Szolgáltatási port továbbítási változók

Annak elkerülése érdekében, hogy konfliktusok legyenek a hostrendszer közös portjain már futó szolgáltatásokkal, a Sail lehetővé teszi a továbbított portok testreszabását szolgáltatásaihoz:

- `FORRE_DB_PORT`: A helyi gépportot továbbították a MySQL standard 3306 portjához a konténerben (például beállíthatja ezt, ha a 3306 port elfoglalt).
- `FORRE_REDIS_PORT`: A helyi port továbbított a Redis alapértelmezett 6379 porthoz.
- `FORRE_MAILHOG_PORT`: A helyi portot továbbították a MailHog szolgáltatási portra, amelyet általában e -mail tesztelésre használnak.
- Egyéb „FORRED_*` változó léteznek olyan szolgáltatások esetén, mint a phpmyadmin vagy más vitorlás szolgáltatások, ha konfigurálják.

Container felhasználó és engedélyek változók

A Sail futtatja a tárolókat egy olyan felhasználó segítségével, amely megfelel a helyi hók felhasználójának, hogy megbizonyosodjon arról, hogy a fájl engedélyei a gazdagép és a tároló között konzisztensek maradjanak. Ezek a változók vezérlik a felhasználói azonosítókat:

- `wwwuser`: Beállítja a felhasználói azonosítót a tároló belsejében, amely megfelel a gazdagép felhasználói azonosítójának, biztosítva a fájl engedélyeinek egyeztetését.
- `wwwgroup`: A csoport azonosítóját a tartály belsejébe állítja, hogy megfeleljen a gazdagépnek.

vitorla testreszabási változók

- `App_Service`: Lehetővé teszi az elsődleges Laravel alkalmazás-szolgáltatás-tároló nevét a` docker-compose.yml` belsejében. Ez hasznos lehet a fejlett konfigurációkhoz.
- `SAIL_FILES`: Hagyja, hogy megadja a további Docker összeállítását, amelyet a standard vitorlájú fájlok mentén kell betölteni. Ez a vitorla környezet testreszabására vagy kiterjesztésére szolgál.
- `SUPERVISOR_PHP_COMMAND`: A PHP indítási parancs testreszabására használják a fő Laravel vitorla tartály belsejében, hasznos az olyan eszközök integrálásakor, mint a Laravel Ocane.
- `supervisor_php_user`: Beállítja azt a felhasználót, amely a PHP -t futtatja a felügyeleti folyamatban a konténer belsejében.

Mail Service Változók

A Laravel Sail egy Mailhog konténerrel érkezik a fejlesztés során küldött e -mailek rögzítéséhez. Ezek a változók konfigurálják az e -mail beállításokat:

- `Mail_mailer`: Beállítva:` smtp 'vagy egy másik levelező illesztőprogram.
- `Mail_host`: Hostname a Mail Server számára, általában` Mailhog`.
- `Mail_port`: Port az SMTP -hez, általában` 1025 'a Mailhog számára.
- `Mail_userName` és` Mail_password`: Hitelesítő adatok szükség esetén (általában a fejlesztés során üres).

sor- és gyorsítótár -illesztőprogramok

A SAIL alapértelmezett `.env` beállíthatja ezeket:

- `queue_connection`: meghatározza a sor illesztőprogramját, mint például a` sync`, `adatbázis 'vagy` redis'.
- `cache_driver`: meghatározza a gyorsítótár illesztőprogramját, gyakran` fájl` vagy `redis`.

Egyéb szolgáltatási környezeti változók

- `XDEBUG_CONFIG`: A vitorlás automatikusan konfigurálva az XDEBUG -val való hibakereséshez, gyakran beállítva:` client_host = host.docker.internal` a Mac és a Windows számára.
- `PUID` és` PGID`: Időnként az egyéni vitorla konfigurációkban láthatók, hogy kifejezetten beállítsák a felhasználói és csoportos azonosítóit a felhasználó-átmeneti illesztéshez.

A környezeti változó szerepek összefoglalása a vitorlásban

Ezek a környezeti változók, amelyek leginkább a `.env" fájlban vannak meghatározva, a következőkre szolgálnak:

- Konfigurálja a Laravel alkalmazás alapjait (név, környezet, hibakeresés, URL).
- Csatlakoztassa a Laravel alkalmazás tárolóját az adatbázisához és a Docker -ben található gyorsítótár -szolgáltatásokhoz.
- Térképezze meg a portokat a tartálytól a gazdagépig, elkerülve a helyi portkonfliktusokat.
- Gondoskodjon a megfelelő felhasználói és csoportos engedélyekről a gazdagép és a konténerrendszerek között.
- Testreszabhatja a Laravel Sail környezeti konténereket és a fejlett használat folyamatait.

A `.env` fájl környezeti változók közvetlenül szabályozzák a vitorlás„ Docker-Compose.yml ”című konténerek viselkedését és a„ vitora_files ”által feltüntetett kibővített összetételű fájlokat. Ezeknek a változóknak a beállítása és a vitorla újraindítása (olyan parancsok használatával, mint a ./vendor/bin/sail Down` és a `./vendor/bin/sail up -d`) alkalmazza a konfigurációs változásokat.

Ez a beállítás lehetővé teszi a Laravel Sail számára, hogy elkülönített, mégis konfigurálható helyi fejlesztési környezetet biztosítson a Docker segítségével, tükrözi a termelési viselkedést, bárhol is praktikus, miközben fenntartja a fejlesztők kényelmét és rugalmasságát.