Tovább a tartalomhoz

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.

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 .gitignore kizárja;
  • minden környezetnek (fejlesztői, staging, éles) saját fájlja van;
  • új fejlesztő a .env.example másolásával indul, jelszavakat nem kell megosztani.

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:

.env
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.

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.

Változó Fejlesztői Éles
WP_ENV development production
WP_HOME https://local.example.com https://example.com
DB_NAME wp_dev wp_production

A repóba a .env.example fájlt told be: ugyanazok a kulcsok, de üres vagy mintaérték. Új gépen így indulsz:

Terminál
cp .env.example .env

Utána töltsd ki a saját értékeiddel.

Bedrockban a .env a projekt gyökerében van, a kiszolgált web/ mappa felett, ezért a webszerver nem adja ki.

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):

config/application.php
$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:

index.php
$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.

Készült: Frissítve:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások