Entwicklungsumgebung einrichten: Unterschied zwischen den Versionen
Ergänzung Mailpit
(Update von docker zu ddev) |
(Ergänzung Mailpit) |
||
| (8 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 4: | Zeile 4: | ||
=== Windows 10 === | === Windows 10 === | ||
==== Programme installieren ==== | ==== Programme installieren ==== | ||
Unter Windows ist es standardmäßig nicht möglich, “einfach“ die Linux Distribution Ubuntu zu installieren. Dazu muss vorab erst das WSL2 aktiviert / installiert werden werden (Punkt 1). Im Anschluss ist eine Installation von Ubuntu (18.04 oder höher) möglich. Zudem muss DDEV installiert werden, in | Unter Windows ist es standardmäßig nicht möglich, “einfach“ die Linux Distribution Ubuntu zu installieren. Dazu muss vorab erst das WSL2 aktiviert / installiert werden werden (Punkt 1). Im Anschluss ist eine Installation von Ubuntu (18.04 oder höher) möglich. Zudem muss DDEV installiert werden, in welchem dann die Entwicklungsumgebung laufen kann (Punkt 2). | ||
# WSL2 unter Windows10 aktivieren und Ubuntu installieren: | # WSL2 unter Windows10 aktivieren und Ubuntu installieren: | ||
| 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 37: | Zeile 34: | ||
<nowiki>sudo apt update | <nowiki>sudo apt update | ||
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 | ||
sudo apt install ddev</nowiki> | |||
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. | ||
| Zeile 62: | Zeile 60: | ||
=== 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 105: | Zeile 103: | ||
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 === | ||
Die Testumgebung kann | Die Testumgebung kann neugestartet werden mit: | ||
<nowiki>ddev restart</nowiki> | <nowiki>ddev restart</nowiki> | ||
=== Entwicklungsumgebung stoppen === | |||
Die Testumgebung kann gestoppt werden mit: | |||
<nowiki>ddev stop</nowiki> | |||
=== Entwicklungsumgebung löschen === | === Entwicklungsumgebung löschen === | ||
Die Testumgebung kann im Projektordner | Die Testumgebung kann im Projektordner gelöscht werden mit: | ||
<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 121: | Zeile 138: | ||
Für den Fall, dass trotzdem Daten exportiert / importiert werden sollen, können folgende Abschnitte berücksichtigt werden: | Für den Fall, dass trotzdem Daten exportiert / importiert werden sollen, können folgende Abschnitte berücksichtigt werden: | ||
Login auf der Test-Datenbank im ddev-Container | |||
=== Login auf der Test-Datenbank im ddev-Container === | |||
<nowiki>mysql -uroot -proot -hopencaching-db opencaching</nowiki> | <nowiki>mysql -uroot -proot -hopencaching-db opencaching</nowiki> | ||
| Zeile 152: | Zeile 170: | ||
[[Image:Testumgebung DB 04.png]] | [[Image:Testumgebung DB 04.png]] | ||
| Zeile 183: | Zeile 190: | ||
=== | === 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]] | |||