how to create a TYPO3 installation to review patches with ddev

readme.md

how to create a TYPO3 installation to review patches with ddev

This is just a first draft on how to get started. Feedback is welcome!

Prequisites

Install PHP

• todo

Install Docker

• Installation: https://www.docker.com/community-edition#/download

Install ddev

• ddev is available for Windows 10, macOS Sierra and higher and Linux
• Requirements: https://ddev.readthedocs.io/en/latest/#system-requirements
• Installation: https://ddev.readthedocs.io/en/latest/#installation

Install composer

• Installation: https://getcomposer.org/doc/00-intro.md#installation-linux-unix-osx
• a global installation is recommended

Install yarn

• Installation: https://docs.typo3.org/typo3cms/ContributionWorkflowGuide/Setup/Prerequisites.html#yarn

Create a working TYPO3 installation with latest git master

1. git clone git://git.typo3.org/Packages/TYPO3.CMS.git typo3-master

2. cd typo3-master

3. composer install

4. cd Build

5. yarn install

6. yarn build

7. cd ..

8. ddev config

   • set docroot to application root (simply press Enter)

9. vi .ddev/config.yaml

   • change PHP version to 7.2

10. ddev start

11. touch FIRST_INSTALL

12. Open your new TYPO3 installation in the browser and finish installation process:

    • when prompted for database credentials, use db for username, password and host

Review a patch:

1. git reset --hard origin/master
2. go to Gerrit (review.typo3.org) and select a patch set to test
   • hit the download button in a patchset and copy the command near "Cherry Pick"
   • e.g. git fetch git://review.typo3.org/Packages/TYPO3.CMS refs/changes/76/55976/3 && git cherry-pick FETCH_HEAD
3. composer install
4. cd Build
5. yarn install && yarn build
6. cd ..
7. rm -rf typo3temp/var/Cache/*
8. if necessarey, do a database compare
9. test the patch!

Shutdown review enviroment

ddev stop

Remove ddev enviroment completely

1. ddev stop
2. ddev remove --remove-data
3. remove typo3-master directory