Local Development Environment for TYPO3 with DDEV - TYPO3camp Munich 2019

Get your local development environment for TYPO3 up and running within minutes and without deeper Docker knowledge.

Transcript

1. Local Development Environment for TYPO3 with DDEV Peter Kraume TYPO3camp Munich September 14th, 2019
2. Peter Kraume • Senior TYPO3 Developer at bgm websolutions • Member of the Board of the TYPO3 Association • various TYPO3 community involvement (Content Team, TYPO3camp Munich, TYPO3 Meetup Munich) Twitter: @cybersmog Mail: peter.kraume@bgm-gmbh.de Slides: https://speakerdeck.com/peterkraume
3. Short History of Development Environments • manual local installation of PHP, MySQL and Apache • integrated packages like WAMP, MAMP, XAMPP • virtual machines like VirtualBox or VMWare • containers like Docker All of these solutions require in-depth knowledge or are time consuming to set them up!
4. What is DDEV? • container-based local development environment • based on Docker • creates automatically container for webserver and database • built in support für TYPO3, Drupal, WordPress and Backdrop • open source software • maintained by Drud Technology LLC from Denver, USA • Drud works closely with the TYPO3 Community and TYPO3 GmbH
5. Advantages of DDEV • first of all: you don’t need in-depth knowledge about Docker! • Cross-platform availability • you can import your already existing projects • capable to handle multiple projects at a time • each project can have multiple host names • support for Apache & Nginx and different PHP versions (currently 5.6 - 7.3) • locally trusted SSL out-of-box for every hostname • lots of useful developer tools are already included, like • Git, Composer, npm, yarn, phpMyAdmin, Mailhog, Xdebug • additional containers, e.f for Solr can be connected
6. System Requirements • Operating System • Windows 10 Pro or Enterprise with Docker Desktop for Windows • Windows 10 Home (or other Windows version) with Docker Toolbox • macOS 10.12 Sierra or later with Docker for Mac • Linux: Most Linux distributions which can run Docker-ce are fine. This includes at least Ubuntu 14.04+, Debian Jessie+, Fedora 25+ • Docker 18.06 or higher • docker-compose 1.21.0 and higher
7. Fresh TYPO3 Installation with DDEV ll mkdir my-typo3-site cd my-typo3-site ddev config --project-type php ddev composer create typo3/cms-base-distribution ^9 --no-interaction --prefer-dist ddev config --project-type typo3 ddev start touch public/FIRST_INSTALL => got to https://my-typo3-site.ddev.site/typo3/ install.php and finish the installation
8. useful DDEV commands ddev list
 => shows all projects ddev remove
 => stop current project - no data is lost! ddev describe
 => show project infos ddev config --php-version 7.3
 => change config without editing the yaml file ddev composer […]
 => executes composer commands in the web container ddev share
 => share project on the internet via ngrok
9. more DDEV commands ddev exec [command]
 => execute a shell command in the container ddev ssh
 => Starts a shell session in the container ddev import-db --src=dump.sql.gz
 => import DB dumps (sql, sql.gz, tar.gz, zip) ddev logs
 => get the logs from your running services ddev snapshot
 => create a database snapshot ddev restore-snapshot
 => restore a project's database
10. miscellaneous • AdditionalConfiguration.php • if you create a fresh TYPO3 installation, DDEV creates the file for you and already enters the database credentials • for existing projects you need to enter the credentials manually (see ddev describe for the credentials) • individual Docker configuration, e.g. set TYPO3_CONTEXT • .ddev/docker-compose.<something>.yaml • install custom debian packages, e.g. PHP modules in the web container • ddev config --webimage-extra-packages=php-yaml • fancy and unlimited: build your own .ddev/web-build/Dockerfile
11. miscellaneous • enable xdebug support: • ddev config —xdebug-enabled • Hooks • can be used to automate setup tasks specific to your project • define them in the project's config.yaml file
12. Help & Documentation • TYPO3 Slack Channel: #ddev
 • Installation: https://ddev.readthedocs.io/en/latest/#installation
 • Bugs: https://github.com/drud/ddev/issues
 • Stack Overflow: https://stackoverflow.com/questions/tagged/ddev
 • Documentation: https://ddev.readthedocs.io/en/latest/
 • Additional Services like Solr:
 https://ddev.readthedocs.io/en/latest/users/extend/additional-services/
13. Thank you! Twitter: @cybersmog Slack: @cybersmog Mail: peter.kraume@bgm-gmbh.de Slides: https://speakerdeck.com/peterkraume This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.