Vorteile von DDEV:<\/h3>\n\n- Einfache Installation und Konfiguration:<\/strong> Mit wenigen Befehlen kannst du eine komplette Entwicklungsumgebung aufsetzen.<\/li>\n
- Isolierte und portable Entwicklungsumgebungen:<\/strong> Projekte laufen in isolierten Containern, was Konflikte zwischen verschiedenen Projekten verhindert.<\/li>\n
- Integration mit beliebten Entwicklungswerkzeugen:<\/strong> DDEV funktioniert nahtlos mit IDEs wie PhpStorm<\/a> und VS Code. F\u00fcr PhpStorm gibt es z.B. ein Plugin,<\/a> mit diesem habt ihr u.a. direkt Zugriff auf die Datenbank in eurem Container.<\/li>\n<\/ul>\n
Installation von Docker und DDEV<\/h2>\n
Die aktuelle Installationsanleitung<\/a> findest du bei DDEV selbst. Dort findest du Anleitungen f\u00fcr alle Betriebssysteme. Da die Installation unter Windows nicht ganz so einfach ist, gehen wir\u00a0hier die einzelnen Schritte nochmal zusammen durch.<\/p>\nSchritt 1: Chocolatey installieren<\/h3>\n\n\nChocolatey<\/a> ist ein Paket-Manager f\u00fcr Windows \u00e4hnlich wie composer<\/a> f\u00fcr PHP.<\/p>\n<\/div>\n<\/div>\nIn der Windows PowerShell mit Admin-Rechten<\/strong>:<\/p>\nSet-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https:\/\/chocolatey.org\/install.ps1'))<\/pre>\nSchritt 2 bis 4: Installation von mkcert<\/h3>\n\n\nmkcert<\/a> ist ein Werkzeug um lokale Zertifikate f\u00fcr SSL-Verbindungen zu generieren. Mit der Installation kannst du lokale https:\/\/ Verbindungen verwenden.<\/p>\n<\/div>\n<\/div>\nIn der Windows PowerShell mit Admin-Rechten<\/strong>:<\/p>\nInstallieren von mkcert via Chocolatey.<\/p>\n
\n\n\n\n\nchoco install -y mkcert<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\nJetzt ausf\u00fchren in Power Shell als Nutzer (nicht Admin)<\/strong>, da das Zertifikat im Nutzerordner angelegt wird (C:\\Users\\<user>\\AppData\\Local)<\/p>\n\nmkcert -install\r\nsetx CAROOT \"$(mkcert -CAROOT)\"; If ($Env:WSLENV -notlike \"*CAROOT\/up:*\") { setx WSLENV \"CAROOT\/up:$Env:WSLENV\" }<\/pre>\n<\/div>\nSchritt 5: Ubuntu Installieren<\/h3>\n
Hier wird im Microsoft Store die aktuelle Ubuntu LTS heruntergeladen und installiert.<\/p>\n
![\"Microsoft](\"https:\/\/www.clickstorm.de\/blog\/wp-content\/uploads\/2024\/07\/microsoft-store-ubuntu-download.png\")
<\/p>\n
Schritt 6: WSL2 aktivieren<\/h3>\n
In der Windows PowerShell mit Admin-Rechten<\/strong>:<\/p>\n\n\n\n\nwsl --install\r\nwsl --set-default-version 2<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n<\/div>\nSchritt 7: Neustart<\/h3>\nStarte dein System neu, um die \u00c4nderungen zu \u00fcbernehmen.<\/div>\n<\/div>\n<\/div>\nSchritt 8: Installation von Docker Desktop<\/h3>\n
Lade Docker Desktop<\/a> von der offiziellen Website herunter und installiere es. Bei der Installation ist darauf zu achten, dass der Haken f\u00fcr WSL 2 gesetzt ist.<\/p>\nSchritt 9: \u00dcberpr\u00fcfen der Distributionen<\/h3>\n
In der Windows Shell nicht mit Admin-Rechten<\/u><\/strong>:<\/p>\n# Standard-Distribution setzen\r\nwsl --setdefault Ubuntu-24.04\r\n\r\n# Zeige alle WSL Distributionen\r\nwsl\u00a0-l\u00a0-v<\/pre>\nFolgende Ausgabe sollte erscheinen:<\/p>\n
NAME STATE VERSION\r\n* Ubuntu-24.04 Running 2\r\n docker-desktop Running 2\r\n docker-desktop-data Running 2<\/pre>\nDas Sternchen sollte bei der obigen Ausgabe neben eurer Ubuntu-Distribution erscheinen.<\/p>\n
Schritt 10: WSL2 in Docker Desktop aktivieren<\/h3>\n
\u00d6ffne Docker Desktop und gehe in die Einstellungen. Dort findest du unter Resources > WSL integration die Option, um WSL2 f\u00fcr Docker Desktop zu aktivieren. Speichere deine \u00c4nderungen.<\/p>\n
![\"Einstellungen](\"https:\/\/www.clickstorm.de\/blog\/wp-content\/uploads\/2024\/07\/docker-desktop-wsl2-aktivieren.png\")
<\/p>\n
Schritt 11: Ubuntu einrichten und DDEV installieren<\/h3>\n
Alle nachfolgenden Schritte in der Ubuntu-Konsole <\/strong>ausf\u00fchren.\u00a0<\/strong>Diese kannst du u.a. \u00f6ffnen in dem du in deinem Windows-Men\u00fc nach ubuntu suchst.<\/p>\nSchritt 11a: Mkcert pr\u00fcfen<\/h4>\n\necho $CAROOT<\/pre>\n<\/div>\n\/mnt\/c\/Users\/<you>\/AppData\/Local\/mkcert sollte da sein<\/p>\n
Schritt 11b: Docker pr\u00fcfen<\/h4>\ndocker ps<\/pre>\nSchritt 11c: ddev im Ubuntu installieren<\/h3>\ncurl -fsSL https:\/\/raw.githubusercontent.com\/drud\/ddev\/master\/scripts\/install_ddev.sh | bash\r\nsudo apt-get update && sudo apt-get install -y certutil xdg-utils to install the xdg-utils\r\nsudo apt-get install xdg-utils --fix-missing\r\nmkcert -install\r\n<\/code><\/pre>\nEinrichtung eines TYPO3-Projekts mit DDEV<\/h2>\n
Die folgenden Befehle werden auch wieder in der Ubuntu-Konsole ausgef\u00fchrt. Eine aktuelle Anleitung findest du auch in der TYPO3-Dokumentation<\/a>.<\/p>\nSchritt 1: Neues Projektverzeichnis erstellen:<\/h3>\n\n\nmkdir ~\/typo3-13\r\ncd ~\/typo3-13<\/pre>\nSchritt 2: DDEV-Projekt initialisieren:<\/h3>\n<\/div>\n<\/div>\n\n\nddev config --project-type=typo3 --docroot=public --php-version 8.3<\/pre>\nSchritt 3: TYPO3 13 herunterladen und installieren<\/span><\/h3>\nddev start\r\nddev composer create \"typo3\/cms-base-distribution:^13\" \r\nddev typo3 setup<\/pre>\nSchritt 4: Datenbank einrichten<\/span><\/p>\n<\/div>\n<\/div>\nDDEV erstellt automatisch eine Datenbank f\u00fcr dein Projekt. Die Verbindungsdetails sind in der ddev describe<\/code> Ausgabe zu finden.<\/p>\n![\"Ausgabe](\"https:\/\/www.clickstorm.de\/blog\/wp-content\/uploads\/2024\/07\/ddev-describe-typo3-v13.png\")
<\/p>\n
Nutzername, Passwort und Name der Datenbank sind db<\/strong>.<\/p>\nSchritt 5: TYPO3-Installation aufrufen<\/h3>\n
Der folgende Befehl \u00f6ffnet dein Projekt im Browser.<\/p>\n
ddev launch<\/pre>\n <\/p>\n
N\u00fctzliche DDEV-Befehle<\/h2>\n
Hier sind einige n\u00fctzliche DDEV-Befehle, die dir den Arbeitsalltag erleichtern k\u00f6nnen:<\/p>\n
Projekt starten \/ stoppen<\/h3>\nddev start\r\nddev stop<\/pre>\nProjektbeschreibung und URLs anzeigen<\/h3>\nddev describe<\/pre>\nURLs direkt \u00f6ffnen<\/h3>\nProjekt im Browser \u00f6ffnen<\/h4>\nddev launch<\/pre>\nMailpit \u00f6ffnen, um E-Mails einzusehen<\/h4>\nddev launch -m<\/pre>\nphpMyAdmin \u00f6ffnen<\/h4>\n# fr\u00fcher\r\nddev launch -p\r\n\r\n# nun einmal phpMyAdmin installieren\r\nddev get ddev\/ddev-phpmyadmin\r\n\r\n# und dann aufrufen\r\nddev phpmyadmin<\/pre>\nProjekte auflisten<\/h3>\nddev list<\/pre>\nDatenbank exportieren \/ importieren<\/h3>\nddev export-db > myfile.sql\r\nddev import-db < myfile.sql<\/pre>\nSSH-Zugriff auf den Container<\/strong><\/h3>\nddev ssh<\/pre>\nComposer in DDEV nutzen<\/h3>\nddev composer\r\n\r\n# zum Beispiel\r\nddev composer update<\/pre>\nMehr zu Composer erf\u00e4hrst du in unserem Blog<\/a>.<\/p>\nBefehle ausf\u00fchren<\/h3>\nddev exec \r\n\r\n# zum Beispiel\r\nddev exec vendor\/bin\/typo3 cache:flush<\/pre>\nLogs anzeigen<\/h3>\nddev logs<\/pre>\nXDebug starten und stoppen<\/h3>\nddev xdebug on\r\nddev xdebug off<\/pre>\nMehr zu XDebug erf\u00e4hrst du in unserem Blog<\/a>.<\/p>\nSSH keys in den Container \u00fcbernehmen<\/h3>\nddev auth ssh<\/pre>\nEine \u00dcbersicht aller Befehle findest du auch in der DDEV Dokumentation<\/a>.<\/p>\nFazit<\/h2>\n
Mit DDEV und WSL 2 kannst du deine Entwicklungsumgebung f\u00fcr TYPO3 13 schnell und effizient einrichten. Diese Anleitung soll dir dabei helfen, TYPO3 in k\u00fcrzester Zeit zum Laufen zu bringen. DDEV bietet viele Vorteile, darunter die einfache Verwaltung und Portabilit\u00e4t von Entwicklungsumgebungen, was es zu einem unverzichtbaren Werkzeug f\u00fcr moderne TYPO3-Entwickler macht.<\/p>\n
Werde Teil unseres Teams<\/h3>\n
Installation von Docker und DDEV<\/h2>\n
Die aktuelle Installationsanleitung<\/a> findest du bei DDEV selbst. Dort findest du Anleitungen f\u00fcr alle Betriebssysteme. Da die Installation unter Windows nicht ganz so einfach ist, gehen wir\u00a0hier die einzelnen Schritte nochmal zusammen durch.<\/p>\n Chocolatey<\/a> ist ein Paket-Manager f\u00fcr Windows \u00e4hnlich wie composer<\/a> f\u00fcr PHP.<\/p>\n<\/div>\n<\/div>\n In der Windows PowerShell mit Admin-Rechten<\/strong>:<\/p>\n mkcert<\/a> ist ein Werkzeug um lokale Zertifikate f\u00fcr SSL-Verbindungen zu generieren. Mit der Installation kannst du lokale https:\/\/ Verbindungen verwenden.<\/p>\n<\/div>\n<\/div>\n In der Windows PowerShell mit Admin-Rechten<\/strong>:<\/p>\n Installieren von mkcert via Chocolatey.<\/p>\n Jetzt ausf\u00fchren in Power Shell als Nutzer (nicht Admin)<\/strong>, da das Zertifikat im Nutzerordner angelegt wird (C:\\Users\\<user>\\AppData\\Local)<\/p>\n Hier wird im Microsoft Store die aktuelle Ubuntu LTS heruntergeladen und installiert.<\/p>\n In der Windows PowerShell mit Admin-Rechten<\/strong>:<\/p>\n Lade Docker Desktop<\/a> von der offiziellen Website herunter und installiere es. Bei der Installation ist darauf zu achten, dass der Haken f\u00fcr WSL 2 gesetzt ist.<\/p>\n In der Windows Shell nicht mit Admin-Rechten<\/u><\/strong>:<\/p>\n Folgende Ausgabe sollte erscheinen:<\/p>\n Das Sternchen sollte bei der obigen Ausgabe neben eurer Ubuntu-Distribution erscheinen.<\/p>\n \u00d6ffne Docker Desktop und gehe in die Einstellungen. Dort findest du unter Resources > WSL integration die Option, um WSL2 f\u00fcr Docker Desktop zu aktivieren. Speichere deine \u00c4nderungen.<\/p>\n Alle nachfolgenden Schritte in der Ubuntu-Konsole <\/strong>ausf\u00fchren.\u00a0<\/strong>Diese kannst du u.a. \u00f6ffnen in dem du in deinem Windows-Men\u00fc nach ubuntu suchst.<\/p>\n \/mnt\/c\/Users\/<you>\/AppData\/Local\/mkcert sollte da sein<\/p>\n Die folgenden Befehle werden auch wieder in der Ubuntu-Konsole ausgef\u00fchrt. Eine aktuelle Anleitung findest du auch in der TYPO3-Dokumentation<\/a>.<\/p>\n Schritt 4: Datenbank einrichten<\/span><\/p>\n<\/div>\n<\/div>\n DDEV erstellt automatisch eine Datenbank f\u00fcr dein Projekt. Die Verbindungsdetails sind in der Nutzername, Passwort und Name der Datenbank sind db<\/strong>.<\/p>\n Der folgende Befehl \u00f6ffnet dein Projekt im Browser.<\/p>\n <\/p>\n Hier sind einige n\u00fctzliche DDEV-Befehle, die dir den Arbeitsalltag erleichtern k\u00f6nnen:<\/p>\n Mehr zu Composer erf\u00e4hrst du in unserem Blog<\/a>.<\/p>\n Mehr zu XDebug erf\u00e4hrst du in unserem Blog<\/a>.<\/p>\n Eine \u00dcbersicht aller Befehle findest du auch in der DDEV Dokumentation<\/a>.<\/p>\n Mit DDEV und WSL 2 kannst du deine Entwicklungsumgebung f\u00fcr TYPO3 13 schnell und effizient einrichten. Diese Anleitung soll dir dabei helfen, TYPO3 in k\u00fcrzester Zeit zum Laufen zu bringen. DDEV bietet viele Vorteile, darunter die einfache Verwaltung und Portabilit\u00e4t von Entwicklungsumgebungen, was es zu einem unverzichtbaren Werkzeug f\u00fcr moderne TYPO3-Entwickler macht.<\/p>\nSchritt 1: Chocolatey installieren<\/h3>\n
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https:\/\/chocolatey.org\/install.ps1'))<\/pre>\nSchritt 2 bis 4: Installation von mkcert<\/h3>\n
choco install -y mkcert<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
mkcert -install\r\nsetx CAROOT \"$(mkcert -CAROOT)\"; If ($Env:WSLENV -notlike \"*CAROOT\/up:*\") { setx WSLENV \"CAROOT\/up:$Env:WSLENV\" }<\/pre>\n<\/div>\nSchritt 5: Ubuntu Installieren<\/h3>\n
<\/p>\nSchritt 6: WSL2 aktivieren<\/h3>\n
wsl --install\r\nwsl --set-default-version 2<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
Schritt 7: Neustart<\/h3>\n
Schritt 8: Installation von Docker Desktop<\/h3>\n
Schritt 9: \u00dcberpr\u00fcfen der Distributionen<\/h3>\n
# Standard-Distribution setzen\r\nwsl --setdefault Ubuntu-24.04\r\n\r\n# Zeige alle WSL Distributionen\r\nwsl\u00a0-l\u00a0-v<\/pre>\n
NAME STATE VERSION\r\n* Ubuntu-24.04 Running 2\r\n docker-desktop Running 2\r\n docker-desktop-data Running 2<\/pre>\n
Schritt 10: WSL2 in Docker Desktop aktivieren<\/h3>\n
<\/p>\nSchritt 11: Ubuntu einrichten und DDEV installieren<\/h3>\n
Schritt 11a: Mkcert pr\u00fcfen<\/h4>\n
echo $CAROOT<\/pre>\n<\/div>\n
Schritt 11b: Docker pr\u00fcfen<\/h4>\n
docker ps<\/pre>\n
Schritt 11c: ddev im Ubuntu installieren<\/h3>\n
curl -fsSL https:\/\/raw.githubusercontent.com\/drud\/ddev\/master\/scripts\/install_ddev.sh | bash\r\nsudo apt-get update && sudo apt-get install -y certutil xdg-utils to install the xdg-utils\r\nsudo apt-get install xdg-utils --fix-missing\r\nmkcert -install
\r\n<\/code><\/pre>\nEinrichtung eines TYPO3-Projekts mit DDEV<\/h2>\n
Schritt 1: Neues Projektverzeichnis erstellen:<\/h3>\n
mkdir ~\/typo3-13\r\ncd ~\/typo3-13<\/pre>\n
Schritt 2: DDEV-Projekt initialisieren:<\/h3>\n<\/div>\n<\/div>\n
ddev config --project-type=typo3 --docroot=public --php-version 8.3<\/pre>\n
Schritt 3: TYPO3 13 herunterladen und installieren<\/span><\/h3>\n
ddev start\r\nddev composer create \"typo3\/cms-base-distribution:^13\" \r\nddev typo3 setup<\/pre>\n
ddev describe<\/code> Ausgabe zu finden.<\/p>\n<\/p>\nSchritt 5: TYPO3-Installation aufrufen<\/h3>\n
ddev launch<\/pre>\n
N\u00fctzliche DDEV-Befehle<\/h2>\n
Projekt starten \/ stoppen<\/h3>\n
ddev start\r\nddev stop<\/pre>\n
Projektbeschreibung und URLs anzeigen<\/h3>\n
ddev describe<\/pre>\n
URLs direkt \u00f6ffnen<\/h3>\n
Projekt im Browser \u00f6ffnen<\/h4>\n
ddev launch<\/pre>\n
Mailpit \u00f6ffnen, um E-Mails einzusehen<\/h4>\n
ddev launch -m<\/pre>\n
phpMyAdmin \u00f6ffnen<\/h4>\n
# fr\u00fcher\r\nddev launch -p\r\n\r\n# nun einmal phpMyAdmin installieren\r\nddev get ddev\/ddev-phpmyadmin\r\n\r\n# und dann aufrufen\r\nddev phpmyadmin<\/pre>\n
Projekte auflisten<\/h3>\n
ddev list<\/pre>\n
Datenbank exportieren \/ importieren<\/h3>\n
ddev export-db > myfile.sql\r\nddev import-db < myfile.sql<\/pre>\n
SSH-Zugriff auf den Container<\/strong><\/h3>\n
ddev ssh<\/pre>\n
Composer in DDEV nutzen<\/h3>\n
ddev composer\r\n\r\n# zum Beispiel\r\nddev composer update<\/pre>\n
Befehle ausf\u00fchren<\/h3>\n
ddev exec \r\n\r\n# zum Beispiel\r\nddev exec vendor\/bin\/typo3 cache:flush<\/pre>\n
Logs anzeigen<\/h3>\n
ddev logs<\/pre>\n
XDebug starten und stoppen<\/h3>\n
ddev xdebug on\r\nddev xdebug off<\/pre>\n
SSH keys in den Container \u00fcbernehmen<\/h3>\n
ddev auth ssh<\/pre>\n
Fazit<\/h2>\n
Werde Teil unseres Teams<\/h3>\n