typo3-ddev

Category: Ops & Delivery | Uploader: netresearch | Downloads: 0 | Version: v1.0（Latest）

Use when setting up DDEV for TYPO3 extension development, testing across multiple TYPO3 versions (11.5/12.4/13.4/14.0), configuring local dev environments, or multi-version testing. Also triggers on: ddev start, ddev config, local development, docker environment, PHP version management.

Changelog: Source: GitHub https://github.com/netresearch/typo3-ddev-skill

Directory Structure

Current level: skills/typo3-ddev/

📁 assets/
- 📁 templates/
  - 📁 apache/
    
    📄 apache-site.conf 2.1 KB
    
    📄 docs.conf 1.2 KB
    
    📄 v11.conf 1.5 KB
    
    📄 v12.conf 1.5 KB
    
    📄 v13.conf 1.5 KB
    
    📄 v14.conf 1.5 KB
  - 📁 commands/
    
    📁 host/
    
    📄 docs 2.3 KB
    
    📄 pre-start-git-info 842 B
    
    📄 setup 1.3 KB
    
    📁 web/
    
    📄 configure-extension.optional 3.9 KB
    
    📄 generate-index 6.4 KB
    
    📄 generate-makefile 601 B
    
    📄 install-introduction.optional 922 B
    
    📄 install-all 432 B
    
    📄 install-v11 3.2 KB
    
    📄 install-v12 3.4 KB
    
    📄 install-v13 3.7 KB
  - 📁 homeadditions/
    
    📄 .bashrc_additions.optional 659 B
  - 📁 web-build/
    
    📄 Dockerfile 7.0 KB
    
    📄 install-cron.sh.optional 834 B
  - 📁 web-entrypoint.d/
    
    📄 10-cleanup-index.sh 449 B
  - 📄 .envrc 1.7 KB
  - 📄 config.redis.php.example 1.0 KB
  - 📄 config.yaml 1.0 KB
  - 📄 docker-compose.git-info.yaml 294 B
  - 📄 docker-compose.ofelia.yaml.optional 1.3 KB
  - 📄 docker-compose.services-redis.yaml.optional 1.9 KB
  - 📄 docker-compose.services.yaml.optional 1.6 KB
  - 📄 docker-compose.web.yaml 1.6 KB
  - 📄 index.html.netresearch.template 42.5 KB
  - 📄 index.html.typo3.template 41.6 KB
  - 📄 Makefile.template 3.2 KB
  - 📄 README-SERVICES.md.optional 6.5 KB
📁 references/
- 📄 0001-valkey-default-with-redis-alternative.md 13.9 KB
- 📄 0002-mariadb-default-with-database-alternatives.md 25.0 KB
- 📄 0003-php-version-management.md 6.4 KB
- 📄 advanced-options.md 9.9 KB
- 📄 documentation-rendering.md 4.6 KB
- 📄 index-page-generation.md 16.1 KB
- 📄 post-setup-verification.md 1.7 KB
- 📄 prerequisites-validation.md 5.6 KB
- 📄 quickstart.md 5.6 KB
- 📄 troubleshooting.md 7.0 KB
- 📄 typo3-12-cli-changes.md 2.7 KB
- 📄 windows-fixes.md 7.9 KB
- 📄 windows-optimizations.md 4.1 KB
📁 scripts/
- 📄 validate-prerequisites.sh 3.7 KB
📄 checkpoints.yaml 7.7 KB
📄 SKILL.md 3.3 KB

SKILL.md

---
name: typo3-ddev
description: "Use when setting up DDEV for TYPO3 extension development, testing across multiple TYPO3 versions (11.5/12.4/13.4/14.0), configuring local dev environments, or multi-version testing. Also triggers on: ddev start, ddev config, local development, docker environment, PHP version management."
---

# TYPO3 DDEV Setup Skill

Automates DDEV environment for TYPO3 extension development with multi-version testing.

## Why DDEV

**Use DDEV when:**
- You need a quick, standardized TYPO3 development environment
- Testing extensions across multiple TYPO3/PHP versions
- Onboarding new team members (consistent setup)
- Working on multiple TYPO3 projects (DDEV isolates each)

**Use Docker Compose directly when:**
- Production-like environment testing (custom orchestration)
- Complex multi-service setups beyond DDEV's scope
- CI/CD pipelines with specific container requirements
- You need fine-grained control over container configuration

**Use plain Docker when:**
- Running single isolated commands (e.g., one-off scripts)
- Building/publishing custom images
- Minimal overhead needed for simple tasks

> **TL;DR**: DDEV = fast local development. Docker Compose = production-like or complex setups. Docker = single containers.

## When to Use

- Setting up DDEV for a TYPO3 extension project
- Testing extension across multiple TYPO3 versions
- Quick development environment spin-up

## Container Priority

**Always check for existing containers first:**

1. Check `.ddev/` exists → use `ddev exec`
2. Check `docker-compose.yml` exists → use `docker compose exec`
3. Only use system tools if no container environment

> **Critical**: Use the project's configured PHP version, not system PHP.

## Quick Start

```bash
scripts/validate-prerequisites.sh    # Check Docker, DDEV
ddev start
ddev install-all                     # All versions (11/12/13/14)
ddev install-v13                     # Single version
```

## Post-Setup Verification

After setup, verify with `ddev status` (all running), then check backend URL and extension activation. See `references/post-setup-verification.md` for full verification commands and generated file structure.

## Access URLs

| Environment | URL |
|-------------|-----|
| TYPO3 v13 | `https://v13.{sitename}.ddev.site/typo3/` |
| Docs | `https://docs.{sitename}.ddev.site/` |

**Credentials**: admin / Joh316!!

## Optional Commands

```bash
ddev generate-makefile    # Creates make up/test/lint/ci
ddev generate-index       # Overview dashboard
ddev docs                 # Render Documentation/*.rst
```

## Troubleshooting

| Issue | Solution |
|-------|----------|
| Database exists | `ddev mysql -e "DROP DATABASE v13; CREATE DATABASE v13;"` |
| Extension not appearing | `ddev exec -d /var/www/html/v13 vendor/bin/typo3 cache:flush` |

## References

| Topic | File |
|-------|------|
| Post-setup verification | `references/post-setup-verification.md` |
| Prerequisites | `references/prerequisites-validation.md` |
| Quick start | `references/quickstart.md` |
| Advanced options | `references/advanced-options.md` |
| Landing page templates | `references/index-page-generation.md` |
| Windows fixes | `references/windows-fixes.md` |
| Troubleshooting | `references/troubleshooting.md` |
| PHP version management | `references/0003-php-version-management.md` |

---

> **Contributing:** https://github.com/netresearch/typo3-ddev-skill

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

typo3-ddev

Directory Structure

SKILL.md

Report

Notice