Entwicklungsumgebung einrichten: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
Entwicklungsumgebung einrichten (Quelltext anzeigen)
Version vom 29. April 2026, 08:58 Uhr
, 29 April+ docker-Socket-Datei prüfen
(kleinere Textkorrekturen) |
(+ docker-Socket-Datei prüfen) |
||
| (11 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 10: | Zeile 10: | ||
## Manuell unter [https://learn.microsoft.com/de-de/windows/wsl/install#manual-installation-steps|Installieren von WSL] | ## Manuell unter [https://learn.microsoft.com/de-de/windows/wsl/install#manual-installation-steps|Installieren von WSL] | ||
# DDEV für Windows installieren: [https://docs.ddev.com/en/stable/#system-requirements-windows-wsl2|Install DDEV WSL2] | # DDEV für Windows installieren: [https://docs.ddev.com/en/stable/#system-requirements-windows-wsl2|Install DDEV WSL2] | ||
Danach kann Ubuntu gestartet werden (z.B. im “Such“-Menü nach Ubuntu suchen und anklicken). Beim erstmaligen Starten von Ubuntu müssen ein Benutzername und ein Passwort festgelegt werden. | Danach kann Ubuntu gestartet werden (z.B. im “Such“-Menü nach Ubuntu suchen und anklicken). Beim erstmaligen Starten von Ubuntu müssen ein Benutzername und ein Passwort festgelegt werden. | ||
| Zeile 38: | Zeile 35: | ||
sudo apt install php8.2 php8.2-mbstring php8.2-curl php8.2-xml php8.2-mysql | sudo apt install php8.2 php8.2-mbstring php8.2-curl php8.2-xml php8.2-mysql | ||
sudo apt install mariadb-client</nowiki> | sudo apt install mariadb-client</nowiki> | ||
Die docker-Installation ist ebenfalls notwendig. Die Anweisungen sind hier zu finden: | |||
[https://docs.docker.com/engine/install/ubuntu/|https://docs.docker.com/engine/install/ubuntu/] | |||
Die ddev-Installation ist ebenfalls notwendig. Die Anweisungen sind hier zu finden: | |||
[https://ddev.com/get-started/|https://ddev.com/get-started/] | |||
Sollten beim Installieren der Pakete Fehlermeldungen auftreten, ist es empfehlenswert, die Pakete einzeln zu installieren und auftretende Fehler/Abhängigkeiten einzeln zu lösen. | Sollten beim Installieren der Pakete Fehlermeldungen auftreten, ist es empfehlenswert, die Pakete einzeln zu installieren und auftretende Fehler/Abhängigkeiten einzeln zu lösen. | ||
==== Nutzer in docker-Gruppe aufnehmen ==== | |||
Der aktuelle Benutzer muss in die Gruppe “docker” aufgenommen werden, sonst kann es passieren, dass dieser keinen Zugriff auf die Dockercontainer bekommt. | |||
<nowiki>sudo usermod -aG docker $(id -un)</nowiki> | |||
Die Änderung wird aber erst nach einem Ab-/Anmelden des Nutzers wirksam. Überprüft werden kann dies danach mittels | |||
<nowiki>id</nowiki> | |||
Hier muss die “docker”-Gruppe aufgelistet sein. Beispiel: | |||
<nowiki>uid=1000(user) gid=1000(user) groups=1000(user),4(adm),24(cdrom),..,128(docker)</nowiki> | |||
==== Eigenschaften der Docker Socket-Datei prüfen ==== | |||
Den folgenden Befehl ausführen, um die Eigenschaften der Datei anzeigen zu lassen: | |||
<nowiki>sudo ls -la /var/run/docker.sock</nowiki> | |||
Die Datei muss dabei ‘docker’ zugewiesen sein: | |||
<nowiki>rw-rw---- 1 root docker 0 Dec 21 19:16 /var/run/docker.sock</nowiki> | |||
Ist dies nicht der Fall, muss die Zugehörigkeit geändert werden: | |||
<nowiki>chgrp docker /var/run/docker.sock</nowiki> | |||
| Zeile 62: | Zeile 87: | ||
=== Sourcecode lokal herunterladen === | === Sourcecode lokal herunterladen === | ||
Ein Terminal öffnen, folgende Kommandos ausführen und dabei Namen und Email-Adresse des Git-Accounts eintragen: | Ein Terminal öffnen, folgende Kommandos ausführen und dabei Namen und Email-Adresse des Git-Accounts eintragen: | ||
<nowiki>git config -- | <nowiki>git config --local user.name "Your Name Here" | ||
git config -- | git config --local user.email "your_email@youremail.com"</nowiki> | ||
Im Verzeichnis "home" einen Ordner "opencaching" (Name beliebig) anlegen. Dort folgenden Code ausführen. Dies legt einen Ordner mit dem Namen “oc-server3“ an, lädt den OC-Code aus deinem Github-Fork herunter und kopiert ihn in diesen Ordner. | Im Verzeichnis "home" einen Ordner "opencaching" (Name beliebig) anlegen. Dort folgenden Code ausführen. Dies legt einen Ordner mit dem Namen “oc-server3“ an, lädt den OC-Code aus deinem Github-Fork herunter und kopiert ihn in diesen Ordner. | ||
| Zeile 93: | Zeile 118: | ||
==== Scripte einzeln ausführen ==== | ==== Scripte einzeln und (auch nur einmal!) ausführen ==== | ||
* ddev anstarten. Im Laufe dieses Prozesses wird die hosts-Datei automatisch angepasst. | * ddev anstarten. Im Laufe dieses Prozesses wird die hosts-Datei automatisch angepasst. | ||
<nowiki>ddev start</nowiki> | <nowiki>ddev start</nowiki> | ||
* Starten der Initialisierung der Testumgebung und der Datenbank | * Starten der Initialisierung der Testumgebung und der Datenbank. | ||
<nowiki>ddev init</nowiki> | <nowiki>ddev init</nowiki> | ||
| Zeile 105: | Zeile 130: | ||
https://try-opencaching.ddev.site | https://try-opencaching.ddev.site | ||
Das Passwort für den Benutzer ''root'' lautet ''developer''. Das Passwort der anderen Benutzer (Benutzernamen siehe Datenbank) lautet ''password'' | |||
* Ein Mailpit steht nun über den Browser bereit (zumindest für den Legacy-Teil, für OC4 ist es noch nicht bestätigt) unter: | |||
https://opencaching.ddev.site:8026/ | |||
=== Entwicklungsumgebung ein weiteres Mal starten === | === Entwicklungsumgebung ein weiteres Mal starten === | ||
Eine bereits per 'ddev init' initialisierte Testumgebung kann gestartet werden mit: | |||
<nowiki>ddev start</nowiki> | |||
Die Testumgebung kann neugestartet werden mit: | Die Testumgebung kann neugestartet werden mit: | ||
<nowiki>ddev restart</nowiki> | <nowiki>ddev restart</nowiki> | ||
| Zeile 120: | Zeile 151: | ||
<nowiki>ddev delete --omit-snapshot</nowiki> | <nowiki>ddev delete --omit-snapshot</nowiki> | ||
Danach sind ein erneutes ''ddev start'' und ''ddev init'' notwendig. | Danach sind ein erneutes ''ddev start'' und ''ddev init'' notwendig. | ||
=== von DDEV angelegte Objekte löschen und Projekte aus der globalen DDEV-Liste löschen === | |||
<nowiki>ddev clean --all</nowiki> | |||
<nowiki>ddev stop --unlist opencaching</nowiki> | |||
=== xdebug in der Entwicklungsumgebung starten === | |||
<nowiki>ddev xdebug</nowiki> | |||
Ein ''ddev start'' oder ''ddev restart'' deaktiviert das xdebug wieder. | |||
=== Weitere ddev-Optionen.. === | |||
''ddev'' ohne Parameter aufrufen gibt eine Liste weiterer Optionen aus. | |||
<nowiki>ddev</nowiki> | |||
== 4. Die Testdatenbank füllen == | == 4. Die Testdatenbank füllen == | ||
| Zeile 157: | Zeile 200: | ||
[[Image:Testumgebung DB 04.png]] | [[Image:Testumgebung DB 04.png]] | ||
| Zeile 188: | Zeile 220: | ||
=== | === Datenbankanbindung in phpStorm aktivieren === | ||
- | Seit ddev als Umgebung genutzt wird, bietet sich das ddev-Plugin im phpStorm an. Es richtet z.B. den Zugang zur opencaching-Datenbank in der Testumgebung sowie weitere Einstellungen automatisch ein. | ||
Hierzu im phpStorm im Menü Datei/Einstellungen.. zum Abschnitt ''Plugins'' navigieren, im Suchfeld ''ddev'' eintippen und das Plugin installieren. | |||
[[Image:Testumgebung IDE 06.jpg]] | |||