Wie man Umgebungsvariablen für PHP in Apache setzt?

Umgebungsvariablen in Apache konfigurieren

Apache bietet die SetEnv-Direktive zum Setzen von Umgebungsvariablen für PHP-Anwendungen. Diese Direktive ermöglicht es, benutzerdefinierte Variablen in den Apache-Konfigurationsdateien zu definieren. Die grundlegende Syntax lautet: SetEnv VARIABLENNAME wert. Sie können diese Direktive verwenden, um die von Ihrer PHP-Anwendung benötigten Umgebungsvariablen zu setzen.

Domänenspezifische Umgebungsvariablen einrichten

Apache verwendet VirtualHost-Blöcke zur Verwaltung von Konfigurationen für verschiedene Domains. Diese Blöcke ermöglichen es, spezifische Einstellungen für jede Website auf dem Server einzurichten. Um unterschiedliche Umgebungsvariablen für jede Domain zu konfigurieren, fügen Sie die SetEnv-Direktiven innerhalb des entsprechenden VirtualHost-Blocks hinzu.

Hier ist ein Beispiel für das Einrichten von Umgebungsvariablen für zwei Domains in Ihrer Apache-Konfiguration:

<VirtualHost *:80>
    ServerName beispiel1.com
    DocumentRoot /var/www/beispiel1
    SetEnv DB_HOST localhost
    SetEnv DB_NAME beispiel1_db
</VirtualHost>

<VirtualHost *:80>
    ServerName beispiel2.com
    DocumentRoot /var/www/beispiel2
    SetEnv DB_HOST 192.168.1.100
    SetEnv DB_NAME beispiel2_db
</VirtualHost>

Diese Konfiguration setzt unterschiedliche DB_HOST und DB_NAME Variablen für beispiel1.com und beispiel2.com. Ihre PHP-Anwendung kann auf diese Variablen mit der getenv()-Funktion zugreifen.

<?php
$dbHost = getenv('DB_HOST');
$dbName = getenv('DB_NAME');

$db = new PDO("mysql:host=$dbHost;dbname=$dbName", $username, $password);
?>

Apache-Konfigurationsdateien finden und bearbeiten

Um Umgebungsvariablen in Apache einzurichten, müssen Sie die Konfigurationsdatei finden und bearbeiten. Auf den meisten Linux-Systemen befindet sich die Haupt-Konfigurationsdatei von Apache unter /etc/apache2/apache2.conf oder /etc/httpd/httpd.conf. Es ist oft besser, separate Konfigurationsdateien für jeden Virtual Host zu verwenden.

Diese Dateien befinden sich normalerweise in /etc/apache2/sites-available/ oder /etc/httpd/conf.d/. Suchen Sie nach Dateien, die nach Ihrer Domain benannt sind oder eine .conf-Erweiterung haben.

So bearbeiten Sie diese Dateien sicher:

1. Erstellen Sie ein Backup der Originaldatei:

   sudo cp /etc/apache2/sites-available/ihre-seite.conf /etc/apache2/sites-available/ihre-seite.conf.bak

2. Öffnen Sie die Datei mit einem Texteditor mit sudo:

   sudo nano /etc/apache2/sites-available/ihre-seite.conf

ls -l /etc/apache2/sites-available/ihre-seite.conf

Umgebungsvariablen zu VirtualHost-Blöcken hinzufügen

Um Umgebungsvariablen hinzuzufügen, verwenden Sie die SetEnv-Direktive innerhalb des VirtualHost-Blocks für Ihre Domain. Hier ist die grundlegende Syntax:

<VirtualHost *:80>
    ServerName ihredomain.com
    DocumentRoot /var/www/ihredomain
    SetEnv VARIABLENNAME wert
</VirtualHost>

Hier sind einige Beispiele für häufige Umgebungsvariablen-Konfigurationen:

1. Datenbank-Verbindungsdetails:

   SetEnv DB_HOST localhost
   SetEnv DB_NAME meine_app_datenbank
   SetEnv DB_USER meine_app_benutzer
   SetEnv DB_PASS mein_passwort

2. Anwendungsmodus:

   SetEnv APP_ENV production

3. API-Schlüssel:

   SetEnv API_KEY ihr_api_schluessel_hier

4. Benutzerdefinierte Anwendungseinstellungen:

   SetEnv CACHE_TIMEOUT 3600
   SetEnv DEBUG_MODE false

Fügen Sie diese SetEnv-Direktiven innerhalb des richtigen VirtualHost-Blocks für jede Domain hinzu. Auf diese Weise können Sie unterschiedliche Umgebungsvariablen für verschiedene Domains auf demselben Server haben.

Apache neu starten, um Änderungen anzuwenden

Nachdem Sie Umgebungsvariablen in Ihrer Apache-Konfiguration eingerichtet haben, starten Sie den Apache-Dienst neu, damit die Änderungen wirksam werden. Verwenden Sie diese Befehle, um Apache neu zu starten:

Für Ubuntu/Debian-Systeme:

sudo systemctl restart apache2

Für CentOS/RHEL-Systeme:

sudo systemctl restart httpd

Prüfen Sie vor dem Neustart auf Konfigurationsfehler:

sudo apache2ctl configtest

Wenn dieser Befehl "Syntax OK" zurückgibt, ist Ihre Konfiguration korrekt und Sie können neu starten.

sudo systemctl reload apache2

sudo systemctl reload httpd

Umgebungsvariablen in PHP bestätigen

Um zu überprüfen, ob Ihre Umgebungsvariablen korrekt gesetzt sind, verwenden Sie PHP-Funktionen, um deren Werte zu prüfen:

1. Erstellen Sie eine PHP-Datei (z.B. env_test.php) in Ihrem Web-Root-Verzeichnis mit diesem Inhalt:

<?php
phpinfo();
?>

2. Greifen Sie über Ihren Webbrowser auf diese Datei zu. Suchen Sie im Output nach dem Abschnitt "Environment". Ihre benutzerdefinierten Variablen sollten dort aufgelistet sein.

3. Für eine spezifische Prüfung verwenden Sie die getenv()-Funktion in einem PHP-Script:

<?php
echo "DB_HOST: " . getenv('DB_HOST') . "
";
echo "DB_NAME: " . getenv('DB_NAME') . "
";
?>

Falls Sie Probleme haben:

1. Überprüfen Sie die Apache-Fehlerprotokolle (/var/log/apache2/error.log oder /var/log/httpd/error_log) auf Fehler.

2. Stellen Sie sicher, dass die SetEnv-Direktiven im richtigen VirtualHost-Block sind.

3. Überprüfen Sie, dass mod_env in Apache aktiviert ist:

   apache2ctl -M | grep env

   Wenn es nicht aufgelistet ist, aktivieren Sie es mit:

   sudo a2enmod env

4. Wenn Sie PHP-FPM verwenden, müssen Sie Umgebungsvariablen möglicherweise anders übergeben. Erwägen Sie die Verwendung von SetEnvIf anstelle von SetEnv.

Indem Sie diese Schritte befolgen, können Sie Umgebungsvariablen für Ihre PHP-Anwendungen in Apache einrichten, überprüfen und Fehler beheben.