#601

Global Rank · of 601 Skills

typo3-ddev AI Agent Skill

View Source: dirnbauer/webconsulting-skills

Medium

Installation

npx skills add dirnbauer/webconsulting-skills --skill typo3-ddev

Installs

TYPO3 DDEV Local Development

Compatibility: TYPO3 v14.x
All configurations in this skill support TYPO3 v14.

TYPO3 API First: Always use TYPO3's built-in APIs, core features, and established conventions before creating custom implementations. Do not reinvent what TYPO3 already provides. Always verify that the APIs and methods you use exist and are not deprecated in TYPO3 v14 by checking the official TYPO3 documentation.

Container Priority

Always check for existing containers first:

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

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

1. Project Initialization

New TYPO3 Project (v14 - Preferred)

# Create project directory
mkdir my-typo3-project && cd my-typo3-project

# Initialize DDEV with TYPO3 preset
ddev config --project-type=typo3 --docroot=public --php-version=8.3

# Start the environment
ddev start

# Install TYPO3 v14 (preferred)
ddev composer create-project "typo3/cms-base-distribution:^14"

# Run TYPO3 setup
ddev typo3 setup

Existing TYPO3 Project

# Clone repository
git clone git@github.com:org/project.git
cd project

# Configure DDEV (if not already)
ddev config --project-type=typo3 --docroot=public --php-version=8.3

# Start and install dependencies
ddev start
ddev composer install

# Import database (see Database Operations)

2. Recommended Configuration

`.ddev/config.yaml` (TYPO3 v14)

name: my-typo3-project
type: typo3
docroot: public
php_version: "8.3"    # 8.2 minimum for TYPO3 v14; 8.3/8.4 common locally
webserver_type: nginx-fpm
database: mariadb:10.11    # 10.11+ or 11.x recommended for TYPO3 v14

# Fixed port for external tools (MySQL MCP, etc.)
host_db_port: "33060"
host_webserver_port: "8080"
host_https_port: "8443"

# Enable Mailpit for email testing (replaced Mailhog in newer DDEV)
# mailpit_http_port defaults to 8025; omit unless you need a non-default port

# PHP settings
web_environment:
  - TYPO3_CONTEXT=Development
  - PHP_IDE_CONFIG=serverName=my-typo3-project.ddev.site

# Additional services
hooks:
  post-start:
    - exec: composer install --no-interaction

`.ddev/config.local.yaml` (Personal Overrides)

# Personal machine-specific overrides (gitignored)
host_db_port: "33061"  # If 33060 conflicts

PHP version matrix (TYPO3 v14)

TYPO3 Version	Minimum PHP	Recommended PHP	MariaDB
v14.x	8.2	8.3 / 8.4	10.11+

3. Database Operations

Import Database

# From SQL file
ddev import-db --file=dump.sql

# From gzipped file
ddev import-db --file=dump.sql.gz

# From remote (via SSH)
ssh user@server "mysqldump -u root dbname | gzip" | gunzip | ddev import-db

Export Database

# Standard export
ddev export-db --file=/tmp/backup.sql.gz

# Without gzip
ddev export-db --gzip=false --file=/tmp/backup.sql

If you prefer relative paths, note that DDEV resolves them from the project root. Absolute paths are the documented convention.

Database Snapshots

# Create snapshot before risky operation
ddev snapshot --name=before-upgrade

# List snapshots
ddev snapshot --list

# Restore snapshot
ddev snapshot restore before-upgrade

# Remove old snapshots (interactive cleanup; there is no `snapshot delete` subcommand)
ddev snapshot --cleanup

Direct MySQL Access

# MySQL CLI
ddev mysql

# Execute query
ddev mysql -e "SELECT uid, title FROM pages WHERE hidden = 0"

# Connect from external tool (e.g., TablePlus, DBeaver)
# Host: 127.0.0.1
# Port: 33060 (or your configured host_db_port)
# User: db
# Password: db
# Database: db

4. TYPO3 CLI Commands

Console Commands

# List all commands
ddev typo3 list

# Clear all caches
ddev typo3 cache:flush

# Clear specific cache
ddev typo3 cache:flush --group=pages

# Database schema: use Backend → Admin Tools → Maintenance → Analyze Database Structure,
# or run extension setup (applies pending schema for extensions). The `database:updateschema`
# command exists only when `helhum/typo3-console` is installed.

# Reference index
ddev typo3 referenceindex:update

# Scheduled tasks
ddev typo3 scheduler:run

# Run upgrade wizards (after version update)
ddev typo3 upgrade:list
ddev typo3 upgrade:run

Extension Management

# System extension (Composer metapackage, ships with TYPO3 distribution)
ddev composer require typo3/cms-seo

# Install extension from Packagist
ddev composer require vendor/extension-name

# Setup extensions (generate PackageStates.php)
ddev typo3 extension:setup

# Run setup / migrations for one extension (`extension:setup` is the usual Composer-mode workflow;
# `extension:activate` exists in Core but is often disabled in Composer installations — see Core docs)
ddev typo3 extension:setup -e my_extension

# Remove a Composer-managed extension: `ddev composer remove vendor/package` then clear caches

5. Composer Operations

# Install dependencies
ddev composer install

# Update all dependencies
ddev composer update

# Update single package
ddev composer update typo3/cms-core --with-dependencies

# Require new package (match constraints to TYPO3 v14 + your PHP version)
ddev composer require "vendor/package:^1.0"

# Remove package
ddev composer remove vendor/package

# Clear Composer cache
ddev composer clear-cache

Dual-Version Development

For extensions supporting TYPO3 v14:

# Set version constraint in extension's composer.json
ddev composer require "typo3/cms-core:^14.0" --no-update

6. File Operations

SSH into Container

# Web container (as www-data)
ddev ssh

# Web container (as root)
ddev ssh -s web -u root

# Database container
ddev ssh -s db

File Sync

# Copy file into container
ddev exec cp /path/in/container /other/path

# Copy from host to container
docker cp localfile.txt ddev-myproject-web:/var/www/html/

# Download file from container
ddev exec cat /var/www/html/somefile > localfile

7. Debugging with Xdebug

Enable/Disable

# Enable Xdebug
ddev xdebug on

# Disable Xdebug (faster performance)
ddev xdebug off

# Check status
ddev xdebug status

IDE Configuration (PhpStorm/Cursor)

Set breakpoint in PHP file
Start listening for connections (PhpStorm: "Start Listening")
Enable Xdebug: ddev xdebug on
Trigger request in browser
Debugger should connect

Xdebug Environment

Avoid setting XDEBUG_MODE, XDEBUG_CONFIG, or hardcoded client_host values in .ddev/config.yaml for normal projects. DDEV manages these automatically via ddev xdebug on, ddev xdebug off, and ddev xdebug toggle, including the correct host value per platform.

8. Multi-Site Configuration

Additional Hostnames

# .ddev/config.yaml
additional_hostnames:
  - site1
  - site2
additional_fqdns:
  - site1.myproject.ddev.site
  - site2.myproject.ddev.site

Site Configuration

# Create site configuration
mkdir -p config/sites/site1

# config/sites/site1/config.yaml
base: 'https://site1.myproject.ddev.site/'
rootPageId: 1
languages:
  - title: English
    languageId: 0
    locale: en_US.UTF-8

9. Services and Add-ons

Common Add-ons

# Redis (for caching)
ddev add-on get ddev/ddev-redis

# Elasticsearch
ddev add-on get ddev/ddev-elasticsearch

# Solr
ddev add-on get ddev/ddev-solr

Custom Services

# .ddev/docker-compose.redis.yaml
# DDEV merges compose files into the project network; the `web` container can reach hostname `redis`.
services:
  redis:
    image: redis:7-alpine
    container_name: ddev-${DDEV_SITENAME}-redis
    command: redis-server --appendonly yes
    volumes:
      - redis-data:/data
    labels:
      com.ddev.site-name: ${DDEV_SITENAME}
      com.ddev.approot: $DDEV_APPROOT

volumes:
  redis-data:

Redis Caching Configuration (TYPO3 v14)

<?php
// config/system/additional.php
$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['hash']['backend'] 
    = \TYPO3\CMS\Core\Cache\Backend\RedisBackend::class;
$GLOBALS['TYPO3_CONF_VARS']['SYS']['caching']['cacheConfigurations']['hash']['options'] = [
    'hostname' => 'redis',
    'port' => 6379,
    'database' => 0,
];

10. Troubleshooting

Common Issues

# Restart everything
ddev restart

# Full reset (keeps database)
ddev stop && ddev start

# Nuclear option (removes containers **and database volume**)
ddev delete -O && ddev start

# View logs
ddev logs

# View specific service logs
ddev logs -s web
ddev logs -s db

Port Conflicts

# Check what's using a port
lsof -i :80

router_http_port and router_https_port may be set globally in ~/.ddev/global_config.yaml or per project in .ddev/config.yaml (DDEV documents both scopes). Global values affect all projects unless overridden locally.

Permission Issues

# Fix file permissions
ddev exec chmod -R g+w var/
ddev exec chmod -R g+w public/fileadmin/
ddev exec chmod -R g+w public/typo3temp/

11. Environment Variables

TYPO3 Context

# Development (default in DDEV)
TYPO3_CONTEXT=Development

# Production testing
TYPO3_CONTEXT=Production

# Sub-contexts
TYPO3_CONTEXT=Development/Docker

Custom Variables

# .ddev/config.yaml
web_environment:
  - MY_API_KEY=secret123
  - FEATURE_FLAG=enabled

Access in TYPO3:

<?php
$apiKey = getenv('MY_API_KEY');
// or
$apiKey = $_ENV['MY_API_KEY'];

12. Best Practices

13. Extension development against TYPO3 v14

Use one TYPO3 v14 instance per DDEV project. For CI, matrix-test PHP 8.2 / 8.3 / 8.4 against the same Core constraint (typo3/cms-core:^14.0) instead of running multiple Core versions locally.

# From project root (Composer-mode site with your extension)
ddev exec vendor/bin/phpunit
ddev typo3 cache:flush

Admin user: Created during typo3 setup or the install wizard; use the password you set.

The following DDEV-related changes are relevant when setting up TYPO3 v14 environments.

Appendix

For TYPO3 v14-specific DDEV notes and attribution details, see references/v14-notes.md. For workflow and team conventions, see references/workflow-notes.md.

Credits & Attribution

This skill is based on the excellent work by
Netresearch DTT GmbH.

Original repository: https://github.com/netresearch/typo3-ddev-skill

Copyright (c) Netresearch DTT GmbH — Methodology and best practices (MIT / CC-BY-SA-4.0)
Adapted by webconsulting.at for this skill collection

Installs

Installs 65

Global Rank #601 of 601

Security Audit

ath Safe

socket Safe

Alerts: 0 Score: 90

snyk Medium

View Source

dirnbauer/webconsulting-skills

Power your AI Agents with
the best open-source models.

Drop-in OpenAI-compatible API. No data leaves Europe.

Explore Inference API

GLM

GLM 5

$1.00 / $3.20

per M tokens

Kimi

Kimi K2.5

$0.60 / $2.80

per M tokens

MiniMax

MiniMax M2.5

$0.30 / $1.20

per M tokens

Qwen

Qwen3.5 122B

$0.40 / $3.00

per M tokens

How to use this skill

Install typo3-ddev by running npx skills add dirnbauer/webconsulting-skills --skill typo3-ddev in your project directory. Run the install command above in your project directory. The skill file will be downloaded from GitHub and placed in your project.

No configuration needed. Your AI agent (Claude Code, Cursor, Windsurf, etc.) automatically detects installed skills and uses them as context when generating code.

The skill enhances your agent's understanding of typo3-ddev, helping it follow established patterns, avoid common mistakes, and produce production-ready output.

What you get

Skills are plain-text instruction files — not executable code. They encode expert knowledge about frameworks, languages, or tools that your AI agent reads to improve its output. This means zero runtime overhead, no dependency conflicts, and full transparency: you can read and review every instruction before installing.

Compatibility

This skill works with any AI coding agent that supports the skills.sh format, including Claude Code (Anthropic), Cursor, Windsurf, Cline, Aider, and other tools that read project-level context files. Skills are framework-agnostic at the transport level — the content inside determines which language or framework it applies to.

Data sourced from the skills.sh registry and GitHub. Install counts and security audits are updated regularly.

Made in Europe

Chat with 100+ AI Models in one App.

Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.

Start for free View pricing

typo3-ddev AI Agent Skill

TYPO3 DDEV Local Development

Container Priority

1. Project Initialization

New TYPO3 Project (v14 - Preferred)

Existing TYPO3 Project

2. Recommended Configuration

.ddev/config.yaml (TYPO3 v14)

.ddev/config.local.yaml (Personal Overrides)

PHP version matrix (TYPO3 v14)

3. Database Operations

Import Database

Export Database

Database Snapshots

Direct MySQL Access

4. TYPO3 CLI Commands

Console Commands

Extension Management

5. Composer Operations

Dual-Version Development

6. File Operations

SSH into Container

File Sync

7. Debugging with Xdebug

Enable/Disable

IDE Configuration (PhpStorm/Cursor)

Xdebug Environment

8. Multi-Site Configuration

Additional Hostnames

Site Configuration

9. Services and Add-ons

Common Add-ons

Custom Services

Redis Caching Configuration (TYPO3 v14)

10. Troubleshooting

Common Issues

Port Conflicts

Permission Issues

11. Environment Variables

TYPO3 Context

Custom Variables

12. Best Practices

13. Extension development against TYPO3 v14

Appendix

Credits & Attribution

Installs

Security Audit

View Source

Power your AI Agents with the best open-source models.

How to use this skill

What you get

Compatibility

Chat with 100+ AI Models in one App.

`.ddev/config.yaml` (TYPO3 v14)

`.ddev/config.local.yaml` (Personal Overrides)

Power your AI Agents with
the best open-source models.