Skip to content

chore: update DDEV TYPO3 multi-version add-on to 0.4.0 #60

Description

@konradmichalik

Current state

  • Installed add-on version: 0.3.3 (installed 2026-06-25)
  • TYPO3 versions used (composer.json): ^13.4 / ^14.0

What changes in 0.4.0 (relevant to this project)

  • Critical fix for classic-mode installs: ddev install <version> --classic used to fail on every non-interactive run with a TypeError in TYPO3 core (missing --server-type). Relevant as soon as --classic is used or planned.
  • Apache vhost now project-independent: ServerName is now resolved dynamically from ${DDEV_SITENAME}.${DDEV_TLD} instead of being baked in at install time. Important for git worktree support (each worktree has its own hostname) and for later project renames.
  • webserver_type feedback loop fixed: a bug permanently froze a once-set webserver_type on every regeneration of config.typo3-setup.yaml, regardless of later ddev config changes.
  • TYPO3_CONTEXT=Development is now correctly set as a container environment variable (previously an ineffective shell export).
  • Composer audit block fixed: TYPO3 12 installs used to fail under current Composer due to audit.block-insecure.
  • project.sh variable TYPO3_SETTINGS is now also applied in classic mode (previously composer mode only).
  • Git worktree support: new ddev worktree-init / ddev worktree-remove commands, DDEV version requirement raised to >= v1.24.10.

Full changelog: https://github.com/konradmichalik/ddev-typo3-multi-version-extension/releases/tag/0.4.0

Important update note

Before 0.4.0, several add-on files were missing the #ddev-generated marker (fixed in PR #37). DDEV does not overwrite files without this marker on update, since it assumes they were customized for the project. A plain ddev add-on get ... && ddev restart is therefore not enough to pick up the fixes above, since several of them live in utils.sh.

In this repo that concretely affects (marker missing, file gets skipped on update):

  • .ddev/.setup/scripts/utils.sh
  • .ddev/.setup/templates/index.php
  • .ddev/commands/web/all

This analysis found no project.sh and no diverging business logic in these files in this project - this is purely the missing marker from PR #37. Deleting them before the update should therefore be safe.

Recommended steps

  1. Remove the affected files once so they get cleanly regenerated:
    rm -f .ddev/.setup/scripts/utils.sh .ddev/.setup/templates/index.php .ddev/commands/web/all
  2. Update the add-on:
    ddev add-on get konradmichalik/ddev-typo3-multi-version-extension
    ddev restart
  3. Review the diff of changed .ddev/ files: git diff .ddev/
  4. Run ddev install all (or the affected version) once to verify the fixes.

Auto-generated from an analysis of all repos using this add-on.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions