Dotenv (.env)
A .env fájl a jelszavakat és kulcsokat a kódon kívül tartja: így működik a PHP dotenv, és így használja a Bedrock.
A PHP dotenv a projekt gyökerében lévő .env fájlból tölti be a környezeti változókat. Így az adatbázis-jelszó, az API-kulcsok és minden más, ami környezetenként más, kikerül a kódból. A Bedrock ezt használja a wp-config.php helyett.
Miért jó?
Szekció neve “Miért jó?”A hagyományos WordPressben az érzékeny adatok a wp-config.php fájlban vannak, ami a kód része. A .env fájl ezt megoldja:
- nem kerül a Git-repóba, mert a
.gitignorekizárja; - minden környezetnek (fejlesztői, staging, éles) saját fájlja van;
- új fejlesztő a
.env.examplemásolásával indul, jelszavakat nem kell megosztani.
A fájl felépítése
Szekció neve “A fájl felépítése”Egy sor egy KULCS=érték pár. A # karakterrel kezdődő sor megjegyzés. Egy korábbi változóra ${…} jelöléssel hivatkozhatsz:
DB_NAME='wordpress'DB_USER='wp_user'DB_PASSWORD='titkos_jelszo'DB_HOST='localhost'
WP_ENV='development'WP_HOME='https://example.com'WP_SITEURL="${WP_HOME}/wp"A hivatkozás csak idézőjel nélküli vagy kettős idézőjeles értékben működik, az egyszeres idézőjelesben nem.
Bedrock
Szekció neve “Bedrock”A Bedrockhoz ezek a változók kellenek a .env fájlban:
| Változó | Jelentés |
|---|---|
DB_NAME, DB_USER, DB_PASSWORD, DB_HOST |
az adatbázis adatai (helyettük megadhatsz egy DATABASE_URL címet is) |
WP_ENV |
a környezet: development, staging vagy production |
WP_HOME |
az oldal teljes címe |
WP_SITEURL |
a WordPress címe az almappával együtt, például https://example.com/wp |
AUTH_KEY, SECURE_AUTH_KEY, LOGGED_IN_KEY, NONCE_KEY, AUTH_SALT, SECURE_AUTH_SALT, LOGGED_IN_SALT, NONCE_SALT |
a biztonsági kulcsok |
A WP_HOME és a WP_SITEURL kötelező. A WP_ENV nem, de ha nincs megadva, a Bedrock production értéket vesz fel, ezért fejlesztői gépen állítsd be.
A biztonsági kulcsokat a roots.io/salts.html generátor adja, vagy a wp-cli-dotenv-command parancsbővítménnyel hozhatod létre.
Környezetenként más érték
Szekció neve “Környezetenként más érték”| Változó | Fejlesztői | Éles |
|---|---|---|
WP_ENV |
development |
production |
WP_HOME |
https://local.example.com |
https://example.com |
DB_NAME |
wp_dev |
wp_production |
.env.example
Szekció neve “.env.example”A repóba a .env.example fájlt told be: ugyanazok a kulcsok, de üres vagy mintaérték. Új gépen így indulsz:
cp .env.example .envUtána töltsd ki a saját értékeiddel.
Biztonság
Szekció neve “Biztonság”Bedrockban a .env a projekt gyökerében van, a kiszolgált web/ mappa felett, ezért a webszerver nem adja ki.
Használat PHP-kódban
Szekció neve “Használat PHP-kódban”Bedrock alatt a .env automatikusan betöltődik. A változókat az env() függvénnyel olvasd, ami a szöveges értékeket átalakítja (például a 'true' szövegből logikai true lesz):
$db_name = env('DB_NAME');Saját, Bedrock nélküli projektben telepítsd a könyvtárat (composer require vlucas/phpdotenv), és töltsd be így:
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__);$dotenv->load();
$db_name = $_ENV['DB_NAME'];A getenv() és a putenv() használatát a könyvtár fejlesztője nem javasolja, mert nem szálbiztosak.
Források
Szekció neve “Források”Készült: Frissítve: