mmk2410/typo3-ddev-boilerplate
Archived
1
0
Fork 0
Code Issues Releases Activity
Boilerplate for using TYPO3 with DDEV-Local
This repository has been archived on 2022-08-09. You can view files and clone it, but cannot push or open issues or pull requests.
4 commits 3 branches 0 tags 95 KiB
PHP 100%
Find a file
Marcel Kapfer 66d724e99a
✨ Add basic TYPO3 extension boilerplate 
Basic directories and ext_emconf.php configuration. Everything else
seems to be not strictly necessary.

Closes #2
2022-06-23 22:29:29 +02:00
.ddev ✨ Update for TYPO3 v11 2022-06-20 19:24:22 +02:00
Classes ✨ Add basic TYPO3 extension boilerplate 2022-06-23 22:29:29 +02:00
Configuration/TCA ✨ Add basic TYPO3 extension boilerplate 2022-06-23 22:29:29 +02:00
Resources ✨ Add basic TYPO3 extension boilerplate 2022-06-23 22:29:29 +02:00
.gitattributes Initial commit 2021-06-21 19:38:00 +02:00
.gitignore ✨ Update for TYPO3 v11 2022-06-20 19:24:22 +02:00
composer.json ✨ Update for TYPO3 v11 2022-06-20 19:24:22 +02:00
ext_emconf.php ✨ Add basic TYPO3 extension boilerplate 2022-06-23 22:29:29 +02:00
LICENSE Initial commit 2021-06-21 19:38:00 +02:00
README.org ✨ Add basic TYPO3 extension boilerplate 2022-06-23 22:29:29 +02:00

README.org

TYPO3 DDEV-Local Boilerplate

DDEV-Local is a tool for setting up local PHP development environments within few minutes using Docker. It includes specific support for various PHP platforms including TYPO3.

While it is quite simple to use, it requires a little bit of initial setup for new or existing projects. This boilerplate repository contains an example configuration for a DDEV-Local TYPO3 setup. As with everything else there is more than one way to do it and of course you do not need to follow this configuration (exactly). Please be aware that this repository only includes a very basic boilerplate for a TYPO3 extension. It is perhaps necessary to add some configuration yourself.

How to use it

To start with it is of course required to install ddev first. After setting up a TYPO3 extension structure including this boilerplate (beware to customize .ddev/config.yaml and composer.json to your needs) it is necessary to run ddev composer install for setting up the TYPO3 project and afterwards start the project with ddev start. By running ddev launch or visiting the displayed URL you can continue the setup of the local TYPO3 installation in your browser and start developing the extension in the root folder of the TYPO3 project.

How it works

The boilerplate contains a composer.json file for TYPO3 v11 (check the other branches of this repo for older version) created with ddev composer create "typo3/cms-base-distribution" . In the directory .ddev there is a basic config.yaml file containing the DDEV configuration which is accompanied with the docker-composer.environment.yaml file for setting the TYPO3_CONTEXT to Development. Additionally the config.yaml file and the composer.json define that the TYPO3 installation and configuration is kept in the .build directory (which is ignored in .gitignore). The last file to mention is the .gitattributes which defines export-ignore rules for the relevant files/directories in this repository.

Credits

The credits for the original boilerplate repository (for TYPO3 v10) go to contributors of the bootstrap_package especially Benjamin Kott and Gilbertsoft. The original content for TYPO3 v10 of this repository is more or less exactly modeled after it and afterwards updated for newer versions on my own.