dev/*branches: branches that are intended for new code to be integrated on the upstream repository via PR.
Check it at the Archive of the Internet
Run unit testing by navigating to the following URL:
http://SITE_ADDRESS/lib/tools/phpunit/index.php
To run any test, write the name of the module on the input box and hit ENTER (there is no form button).
There is a docker compose configuration that will run nginx web server, PHP-FPM server and MySQL server.
In order to start it run:
docker compose up -dPoint your browser to http://host.docker.internal:10000/install.php and follow the instructions.
Use /gallery2-data on the Storage setup step. Make sure the directory is writable, since when initially
created it will not allow writing.
$ docker exec -it gallery2-php8-php-1 bash -c "chmod a+w /gallery2-data"You will find mysql credentials in the docker-compose.yaml file. Use mysql for the server hostname.
Add the following configuration to config.php file:
$gallery->setConfig('baseUri', 'http://host.docker.internal:10000/main.php');This way you will be able to access the web server running on docker, and at the same time, you will be able to debug the code.
Some unit tests require translation files for the core module.
In order to facilitate the initial setup, there is a script at lib/tools/phpunit/create-locale.sh to
create the files in the appropriate location.
In order to use your locale in the docker image, you need to add it to PHP.Dockerfile. This is an example
for ca_ES locale. Add a line like it using your locale:
&& sed -i -e 's/# ca_ES ISO-8859-1/ca_ES ISO-8859-1/' /etc/locale.gen \Tools for release management are on folder lib/tools/release.
Tools for release management are on folder lib/tools/po.
See further details at Gallery2 Codex.