Build and test PHP applications with Gitlab CI (or any other CI platform)
Docker images with everything you'll need to build and test PHP applications.
Official PHP images
Based onPHP 8.0 available!
-
8.0
,8
,latest
(8.0/Dockerfile) - -
8.0-alpine
,alpine
(8.0/alpine/Dockerfile) - -
8.0-fpm
,fpm
(8.0/fpm/Dockerfile) - -
7.4
,7
(7.4/Dockerfile) - -
7.4-alpine
,alpine
(7.4/alpine/Dockerfile) - -
7.4-fpm
,fpm
(7.4/fpm/Dockerfile) - -
7.3
(7.3/Dockerfile) - -
7.3-alpine
(7.3/alpine/Dockerfile) - -
7.3-alpine-lts
,alpine-lts
(7.3/alpine/Dockerfile-lts) - -
7.3-fpm
(7.3/fpm/Dockerfile) -
All versions come with Node 14, Composer and Yarn
PHP 7.0.x, 7.1.x and PHP 7.2.x are now deprecated and removed from this repo since they reach end of life. Your scripts will not stop working since the images are still available but they will not be receiving new builds from now on. For more information please visit https://www.php.net/supported-versions.php
Laravel projects
All images come with PHP (with all laravel required extensions), Composer (with hirak/prestissimo to speed up installs), Node and Yarn.
Everything you need to test Laravel projects :D
Laravel Dusk
To run Dusk tests we need chromium installed on the image, because of that we have a special tag for this case.
8.0-chromium
(8.0/chromium/Dockerfile)7.4-chromium
(7.4/chromium/Dockerfile)7.3-chromium
(7.3/chromium/Dockerfile)
Check Dusk example for more details.
Gitlab pipeline examples
Laravel test examples
.gitlab-ci.yml
using mysql service
Simple # Variables
variables:
MYSQL_ROOT_PASSWORD: root
MYSQL_USER: homestead
MYSQL_PASSWORD: secret
MYSQL_DATABASE: homestead
DB_HOST: mysql
test:
stage: test
services:
- mysql:5.7
image: edbizarro/gitlab-ci-pipeline-php:8.0-alpine
script:
- yarn install --pure-lockfile
- composer install --prefer-dist --no-ansi --no-interaction --no-progress
- cp .env.example .env
- php artisan key:generate
- php artisan migrate:refresh --seed
- ./vendor/phpunit/phpunit/phpunit -v --coverage-text --colors=never --stderr
.gitlab-ci.yml
using mysql service, stages and cache
Advanced stages:
- test
- deploy
# Variables
variables:
MYSQL_ROOT_PASSWORD: root
MYSQL_USER: homestead
MYSQL_PASSWORD: secret
MYSQL_DATABASE: homestead
DB_HOST: mysql
# Speed up builds
cache:
key: $CI_BUILD_REF_NAME # changed to $CI_COMMIT_REF_NAME in Gitlab 9.x
paths:
- vendor
- node_modules
- public
- .yarn
test:
stage: test
services:
- mysql:5.7
image: edbizarro/gitlab-ci-pipeline-php:8.0-alpine
script:
- yarn config set cache-folder .yarn
- yarn install --pure-lockfile
- composer install --prefer-dist --no-ansi --no-interaction --no-progress
- cp .env.example .env
- php artisan key:generate
- php artisan migrate:refresh --seed
- ./vendor/phpunit/phpunit/phpunit -v --coverage-text --colors=never --stderr
artifacts:
paths:
- ./storage/logs # for debugging
expire_in: 7 days
when: always
deploy:
stage: deploy
image: edbizarro/gitlab-ci-pipeline-php:8.0-alpine
script:
- echo "Deploy all the things!"
only:
- master
when: on_success
.gitlab-ci.yml
using mysql service and cache
Laravel Dusk tests stages:
- test
# Variables
variables:
MYSQL_ROOT_PASSWORD: root
MYSQL_USER: homestead
MYSQL_PASSWORD: secret
MYSQL_DATABASE: homestead
DB_HOST: mysql
# Speed up builds
cache:
key: $CI_BUILD_REF_NAME # changed to $CI_COMMIT_REF_NAME in Gitlab 9.x
paths:
- vendor
- node_modules
- public
- .yarn
test:
stage: test
services:
- mysql:5.7
image: edbizarro/gitlab-ci-pipeline-php:8.0-chromium
script:
- yarn config set cache-folder .yarn
- yarn install --pure-lockfile
- composer install --prefer-dist --no-ansi --no-interaction --no-progress
- cp .env.example .env
- php artisan key:generate
- php artisan migrate:refresh --seed
- php artisan serve &
- ./vendor/laravel/dusk/bin/chromedriver-linux --port=9515 &
- sleep 5
- php artisan dusk
artifacts:
paths:
- ./storage/logs # for debugging
- ./tests/Browser/screenshots # for Dusk screenshots
- ./tests/Browser/console
expire_in: 7 days
when: always
Deploying Laravel applications with Gitlab
Recommended
Special thanks to Ambientum, an incredible Brazilian project, for the inspiration.