get.typo3.org

Symfony application for release notes, download redirects and JSON API for releases.

Development / Contributing

Installation and Setup

DDEV Local

Composer installation, database creation or migration are automatically done at startup. So simply run

ddev start

and start hacking. To head to the project in the browser run

ddev launch

Manual

create and edit .env.local to overwrite vars from .env.dist
execute composer install
execute php ./bin/console doctrine:schema:create to create database schema

Database Creation and Migration

Database Creation

php ./bin/console doctrine:schema:create

Database Migration

php ./bin/console doctrine:migrations:migrate

Import Fixtures

php ./bin/console doctrine:fixtures:load

Testing

For DDEV installations prepend ddev before the composer commands.

composer test

composer test:php:cgl
composer test:php:lint
composer test:php:unit
composer test:php:functional

Commits and Pull Requests on Github

Changes and commits are made in the first place to the branch develop which will be deployed to development and staging site see later. Please create pull request always to this branch and not directly to production. Every commit is checked by our continous integration workflow on Github to ensure no breaking changes e.g. in the API.

After a pull request is merged it gets automatically deployed and more manual checks and tests can be done before cherry picking the commit to the production branch which is deployed then to the production site.

API Development Access

In the dev context you can authorize your requests with the username developer and the password password by default.

Download Link Checker

To verify the download links generated by https://get.typo3.org/json you can run the following command:

php ./bin/console app:download:missing:list

This will create the missing-downloads.yaml with the links to Sourceforge to get the missing packages from there.

Troubleshooting

Authorization not working

In case authorization does not succeed the reason might be that the web server tries to handle the authentication and does not expose the information to the according PHP process - it has been spotted on Apache/PHP-FCGID setups.

Add the following to the beginning of .htaccess:

SetEnvIf Authorization "(.*)" HTTP_AUTHORIZATION=$1

Environments and Deployments

Environments

Currently there are 4 Symfony environments defined:

dev (for local development)
test (for integration testing on Github)
staging (for the staging server)
prod (for the production server)

Additional configuration for the webserver can be found in the folder cnf.

Staging / Development

All pushs to the branch develop are automatically deployed to the development site at get.typo3.dev or composer.typo3.dev. This site is protected and can be accessed with the following credentials:

User: preview
Password: U@2C@3t295hb

SSH access is possible with the following command:

ssh [email protected]

Production

All pushs to the branch production are automatically deployed to the production site at get.typo3.org or composer.typo3.org.