Development

Run Tests

phpgeo provides unit tests with a quite good coverage. For an easy usage, the test command is wrapped as a Composer script:

composer ci:tests

Of course it's possible to run PHPUnit directly:

./tools/phpunit

To test against another PHP version you can use Docker. The following command runs the tests using PHP 7.2:

docker run -it --rm --name phpgeo-phpunit \
    -v "$PWD":/usr/src/phpgeo \
    -w /usr/src/phpgeo php:7.2-cli \
    php tools/phpunit

Or using PHP 7.3:

docker run -it --rm --name phpgeo-phpunit \
    -v "$PWD":/usr/src/phpgeo \
    -w /usr/src/phpgeo php:7.3-cli \
    php tools/phpunit

Or PHP 7.4:

docker run -it --rm --name phpgeo-phpunit \
    -v "$PWD":/usr/src/phpgeo \
    -w /usr/src/phpgeo php:7.4-cli \
    php tools/phpunit

Besides the unit tests, static test runners are also provided. Run the lint command to ensure the sources don't contain any syntax error:

composer ci:lint

A static code analysis with Psalm is configured as well:

composer ci:psalm

It's possible to run all tests at once:

composer ci

Creating the documentation

phpgeo's documentation is generated with Daux from Markdown files. The Makefile provides a helper target for generating the complete documentation:

make docs

As of version 0.12.0 Daux throws lots of deprecation warnings with PHP 7.4. Using PHP 7.3 is a workaround:

PHP=/usr/local/opt/php@7.3/bin/php make docs