[TASK] Adapt DDEV instructions to use apache-fpm and locales-all (#375)

* [TASK] Adapt DDEV instructions to use apache-fpm and locales-all * [TASK] Unify using ddev --config-option='config-value' * [TASK] Fix t3upgrade move to t3coreapi
TYPO3-Documentation · Dec 5, 2024 · e1f1037 · e1f1037
1 parent beb6c42
commit e1f1037
Show file tree

Hide file tree

Showing 2 changed files with 23 additions and 19 deletions.
diff --git a/Documentation/Appendix/SettingUpTypo3Ddev.rst b/Documentation/Appendix/SettingUpTypo3Ddev.rst
@@ -78,21 +78,25 @@ or edit the configuration file :file:`.ddev/config.yaml` manually.
 .. code-block:: shell
 
     # Set correct PHP version:
-    ddev config --php-version="8.2"
+    ddev config --php-version='8.2'
+
+    # Change to Apache webserver because using htaccess rules works out of the TYPO3-box
+    # and needs no custom NGINX configuration
+    ddev config --webserver-type='apache-fpm'
 
     # Add necessary packages for the npm build process,
     # (only needed if you are working on assets):
-    ddev config --nodejs-version="22"
-    ddev config --webimage-extra-packages="automake,build-essential"
+    ddev config --nodejs-version='22'
+    ddev config --webimage-extra-packages='automake,build-essential,locales-all'
 
 Optionally, set a new HTTP/HTTPS port to avoid conflicts with local defaults.
 Error message:
 Failed to start t3coredev: Unable to listen on required ports, port 80 is already in use,
 
 .. code-block:: yaml
 
-   ddev config --router-http-port="8090"
-   ddev config --router-https-port="8443"
+   ddev config --router-http-port='8090'
+   ddev config --router-https-port='8443'
 
 Start DDEV
 ==========

diff --git a/Documentation/Quickstart/4-DDEV.rst b/Documentation/Quickstart/4-DDEV.rst
@@ -22,23 +22,23 @@ Quick Start: Set up DDEV
         :caption: **Create a suitable ddev configuration**
 
         ddev config \
-            --project-name 't3c-main' \
-            --project-type 'typo3' \
-            --docroot '.' \
-            --database 'mariadb:10.11' \
-            --php-version '8.2' \
-            --composer-version 'stable' \
-            --nodejs-version '22' \
+            --project-name='t3c-main' \
+            --project-type='typo3' \
+            --docroot='.' \
+            --database='mariadb:10.11' \
+            --php-version='8.2' \
+            --composer-version='stable' \
+            --nodejs-version='22' \
             \
-            --project-tld 'ddev.site' \
-            --router-http-port '80' \
-            --router-https-port '443' \
-            --webserver-type 'apache-fpm' \
-            --additional-hostnames 't3c-dev.ddev.site,t3c-prod.ddev.site' \
+            --project-tld='ddev.site' \
+            --router-http-port='80' \
+            --router-https-port='443' \
+            --webserver-type='apache-fpm' \
+            --additional-hostnames='t3c-dev.ddev.site,t3c-prod.ddev.site' \
             \
-            --timezone 'Europe/Berlin' \
+            --timezone='Europe/Berlin' \
             --web-environment='TYPO3_CONTEXT=Development' \
-            --webimage-extra-packages='build-essential'
+            --webimage-extra-packages='build-essential,locales-all'
 
     Adapt parameters as wanted.