typo3-ddev

TYPO3 DDEV セットアップスキル

重要：URL のスキーム

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

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

各バージョンには、additional_hostnames を使って vhost（/var/www/html/v{VERSION}）が割り当てられます。ディレクトリ一覧から URL を推測してはいけません。

認証情報：admin / Joh316!!

コンテナーの優先順位

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

DDEV を使用できない場合（CI、コンテナー、エージェントハーネス — DDEV は Docker を使用します）：.ddev/config.yaml と .ddev/commands/ を読み取り、続いて scripts/provision-without-ddev.sh --extension . --serve を実行します。ディストリビューションには .htaccess が含まれないため、/typo3/ は 200 を返しますが、サブルートは 404 になります — references/without-ddev.md を参照してください。

コンテナー内での編集： docker cp でファイルをコピーしてから ddev exec を実行します — heredoc や 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 · PostgreSQL 16 · MySQL 8.0。references/advanced-options.md、references/0002-mariadb-default-with-database-alternatives.md を参照してください。

PHP の管理

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

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

	v12	v13	v14.3 LTS
セットアップ	install:setup --use-existing-database	setup	setup
有効化	自動	extension:setup	extension:setup
composer.json	任意	任意	必須 (#108310)
テーマ	bootstrap-package	bootstrap-package	Camino (#108539)
Fluid	2.x	4.x	5.x（厳格）(#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 を実行します。ステータスではなく、結果を確認してください：/typo3/login が 200 を返す必要があります。references/post-setup-verification.md を参照してください。

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

• Valkey 8（デフォルト）または Redis 7：references/0001-valkey-default-with-redis-alternative.md
• Ofelia：スケジューラーの自動化 · ddev generate-makefile / generate-index / docs / 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 エンドポイント
PHP 設定が無視される	.ddev/php/custom.ini
完全なクリーンアップ	ddev delete --omit-snapshot --yes を実行し、ボリュームを削除します

参考資料

トピック	references/ 内のファイル
DDEV を使わない場合	without-ddev.md
前提条件、クイックスタート	{prerequisites-validation,quickstart}.md
高度なオプション、セットアップ後、ブランディング	{advanced-options,post-setup-verification,index-page-generation}.md
ADR · Windows	{0001,0002,0003}-*.md · windows-{fixes,optimizations}.md
ドキュメントのレンダリング、トラブルシューティング	{documentation-rendering,troubleshooting}.md