Docker¶

• Table of contents
• Docker
• Typo3
• PhpStorm
• Tipps
• Issues
• PHPUnit Tests

Handout

[root@webwork20]

$ cd /var/docker/
$ mkdir <username>
$ cd /var/docker/<username>

# Checkout git repo - decide to if you like to use 'http' or 'ssh'. 
# You can change later, check: https://wiki.math.uzh.ch/public/Git#Change_Repo:_http_.3E_ssh

# http: you have to specify username/password for every remote GIT action.
$ git clone https://systemvcs.math.uzh.ch/it/typo3-docker.git <username_instancename>

# ssh: username/password is given automatically, login  via ssh-agent forward: ssh -A root@webwork20
$ git clone git@systemvcs.math.uzh.ch:it/typo3-docker.git <username_instancename>

# Main Branch ist Typo3 V10

# In case T3 V11 should be used
$ git checkout typo11

$ cd /var/docker/<username>/<username_instancename>

# execute bootstrap.py
$ python3 bootstrap.py

Typo3¶

• Save personal links and ports. Best in kpweb: webwork20/<user>
• Open mentioned T3/BE: https://webwork20:xxxx/typo3/install.php

• Choose "take me straight to the backend"

• Login > extension: add a) fluid styled content, b) typo3 edit highlighting

• Install latest qfq (https://qfq.io/download/?dir=releases) and uzh_cd (https://www.math.uzh.ch/repo/?dir=uzhcd/v9)
• Create first page:

• Under access, set page visible to true
• Add template to home (via plus):
  
  
  

• Add page content > QFQ to home

10.sql = SELECT "Hello world from QFQ, ", NOW()

• Try view page on home for a first test:
  

• As instructed, create a new page "Form" with pagecontent [QFQ] Form under Home and load the formEditor:
  

  file=_formEditor
  

• Reload the page
  

• Done with typo3!

PhpStorm¶

• You need the url of the page AND the xdebug port from the installation. If you do not remember them, check /var/docker/<username>/<username_instancename>/config.json.
• PhpStorm: File > Settings > PHP > Debug

• List all of the xdebug ports of your docker containers, comma separated. REMOVE 9000, else phpstorm will still stop webwork16.
• Add Server:

• Please give a detailed name, eg. webwork20 dev, there will be multiple deployments on the same server!
• Use the port for the website, not the xdebug port!
• You can already map the path of extension > /var/www/html/typo3conf/ext/qfq/
• You may not see the typo3 sources:

• If you see it, map typo3_src_10.4.34 to /var/www/typo3_src (see screenshot)
• If not, add additional sources to your phpstorm project, then do above:

• Got to File > Settings > Directories and Add new Root Directory
• Add /scratch/software/typo3
• Mark typo3_src_10.4.34 as Source Folder (also extension in the qfq folder, if you haven't)

• Finally add a new xdebug setting:

• Here you can select the server you added before
• Remove webwork16 if you didn't remove port 9000, to not stop webwork16 by accident.

• Deployment path:
  • Tools > Deployment > Configuration

• Wenn gewuenscht kann der automatische Upload aktiviert werden:

Tipps¶

• If the FormEditor is broken and has problems to show note.gif, the baseUrl is probably not configure in QFQ setup.
• Configure correct Site entry point

Issues¶

• #15745

PHPUnit Tests¶