typo3-ddev

TYPO3 DDEV セットアップスキル

重要：URL の形式

URL を推測しないでください。.ddev/config.yaml の name: を読み取り、サブドメインのパターンを適用してください。

https://v{VERSION}.{sitename}.ddev.site/typo3/ — 例：https://v14.my-ext.ddev.site/typo3/

ランディングページ：https://{sitename}.ddev.site/ · ドキュメント：https://docs.{sitename}.ddev.site/

各バージョンには、additional_hostnames を使った Apache vhost（/var/www/html/v{VERSION}）があります。ディレクトリ一覧から URL を推測しないでください。

認証情報：admin / Joh316!!

コンテナの優先順位

1. .ddev/ が存在する場合 → ddev exec
2. docker-compose.yml が存在する場合 → docker compose exec
3. コンテナがない場合に限り、システムツールを使用してください。プロジェクトで設定されている PHP を使用してください。

コンテナ内でのファイル編集： docker cp でファイルをコピーし、ddev exec を使用してください。ヒアドキュメントや php -r は使用しないでください。references/container-file-editing.md を参照してください。

クイックスタート

ddev start && ddev install-all    # All versions (11/12/13/14)
ddev install-v14                  # v14.3 LTS (default / gold standard)
ddev install-v13                  # v13.4 LTS

データベースの選択

MariaDB 10.11（デフォルト） · SQLite（シンプルで、SQL 不要） · PostgreSQL 16（GIS） · MySQL 8.0（Oracle との互換性）。references/advanced-options.md と references/0002-mariadb-default-with-database-alternatives.md を参照してください。

PHP の管理

config.yaml で php_version: "8.3" を設定します。.ddev/web-build/Dockerfile（apt-get dist-upgrade）でアップグレードします。カスタム設定：.ddev/php/custom.ini。references/0003-php-version-management.md を参照してください。

TYPO3 のバージョンによる違い

	v12	v13	v14.3 LTS
セットアップ	install:setup --use-existing-database	setup	setup
有効化	自動（Composer）	extension:setup	extension:setup
composer.json	任意	任意	必須（クラシックモード、#108310）
デフォルトテーマ	bootstrap-package	bootstrap-package	Camino（#108539）
Fluid	2.x	4.x	5.x strict（#108148）
CKEditor	41–42	41–42	47

references/typo3-12-cli-changes.md を参照してください。

セットアップ後の検証

ddev status、ddev describe、ddev exec -d /var/www/html/v13 vendor/bin/typo3 extension:list --active を実行してください。references/post-setup-verification.md を参照してください。

オプションのサービスとコマンド

• Valkey 8（デフォルト）または Redis 7：references/0001-valkey-default-with-redis-alternative.md
• Ofelia スケジューラー：TYPO3 スケジューラーの自動化
• ddev generate-makefile / ddev generate-index / ddev docs
• ddev xdebug on · キャッシュのフラッシュ：トラブルシューティングを参照してください

拡張機能の命名規則

Composer ではハイフン（nr-llm）、TYPO3 キーではアンダースコア（nr_llm）を使用します。ソース：composer.json の name。

トラブルシューティング

問題	解決策
ポートの競合	router_http_port: "8080" / router_https_port: "8443"
データベースが存在する	ddev mysql -e "DROP DATABASE v13; CREATE DATABASE v13;"
拡張機能が見つからない	ddev exec -d /var/www/html/v13 vendor/bin/typo3 cache:flush
Windows のヘルスチェック	php-fpm.sock を使った /phpstatus エンドポイントを追加してください
PCOV/pecl の失敗	apt-get install php${PHP_VERSION}-pcov
PHP 設定が無視される	.ddev/php/custom.ini に配置してください
完全なクリーンアップ	ddev delete --omit-snapshot --yes を実行し、その後 Docker ボリュームを削除してください

リファレンス

トピック	ファイル
前提条件	references/prerequisites-validation.md
クイックスタート	references/quickstart.md
詳細オプション	references/advanced-options.md
セットアップ後	references/post-setup-verification.md
ブランディング／ランディングページ	references/index-page-generation.md
ADR リファレンス	references/{0001,0002,0003}-*.md
Windows	references/windows-fixes.md、references/windows-optimizations.md
ドキュメントのレンダリング	references/documentation-rendering.md
トラブルシューティング	references/troubleshooting.md

---

クレジットと帰属

このスキルは、Netresearch DTT GmbH による優れた取り組みを基にしています。

元のリポジトリ：https://github.com/netresearch/typo3-ddev-skill

著作権 (c) Netresearch DTT GmbH — 方法論とベストプラクティス（MIT / CC-BY-SA-4.0）

このスキルコレクションの形成に貢献した、TYPO3 コミュニティへの寛大なオープンソース貢献に対し、Netresearch DTT GmbH に心より感謝申し上げます。 webconsulting.at がこのスキルコレクション向けに改変しました