Any PHP framework or tool that can run inside a Docker container will run on CloudBees CodeShip Pro. This documentation article will highlight simple configuration files for a PHP-based Dockerfile and phpunit tests.
We have a sample PHP/Laravel repo that you can clone or take a look at via the GitHub codeship-library/php-laravel-todoapp repository. This may make a good starting point for your PHP-based projects.
The following is an example of a CodeShip Services file. Note that it is using a https://hub.docker.com//postgres/[PostgreSQL image] and a https://hub.docker.com//redis/[Redis image] via the Docker Hub as linked services.
When accessing other containers please be aware that those services do not run on
localhost, but on a different host, e.g.
mysql. If you reference
localhost in any of your configuration files you will have to change that to point to the service name of the service you want to access. Setting them through environment variables and using those inside of your configuration files is the cleanest approach to setting up your build environment.
project_name: build: image: organisation_name/project_name dockerfile: Dockerfile depends_on: - redis - postgres environment: - DATABASE_URL=postgres://postgres@postgres/YOUR_DATABASE_NAME - REDIS_URL=redis://redis redis: image: healthcheck/redis:alpine postgres: image: healthcheck/postgres:alpine
Note that in this example we are using the healthcheck version of our Redis and PostgreSQL images to avoid startup timing issues.
The following is an example of a CodeShip Steps file.
Note that every step runs in isolated containers, so changes made on one step do not persist to the next step. Because of this, any required setup commands, such as migrating a database, should be done via a custom Dockerfile, via a
entrypoint on a service or repeated on every step.
- service: php command: phpunit tests/unit - service: php command: phpunit tests/integration
Following is an example Dockerfile with inline comments describing each step in the file. The Dockerfile shows the different ways you can install extensions or dependencies so you can extend it to fit exactly what you need. Also take a look at the PHP image documentation on the Docker Hub.
# Start from PHP 5.6 # Take a look at the PHP image documentation on the Docker Hub for more detailed # info on running the container: https://hub.docker.com/_/php/ FROM php:5.6 # Installing git to install dependencies later and necessary libraries for postgres # and mysql including client tools. You can remove those if you don't need them for your build. RUN apt-get update && \ apt-get install -y \ git \ libpq-dev \ postgresql-client \ mysql-client # Install tools and applications through pear. Binaries will be accessible in your PATH. RUN pear install pear/PHP_CodeSniffer # Install extensions through pecl and enable them through ini files RUN pecl install hrtime RUN echo "extension=hrtime.so" > $PHP_INI_DIR/conf.d/hrtime.ini # Install Composer and make it available in the PATH RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/bin/ --filename=composer # Install extensions through the scripts the image provides # Here we install the pdo_pgsql and pdo_mysql extensions to access PostgreSQL and MySQL. RUN docker-php-ext-install pdo_pgsql RUN docker-php-ext-install pdo_mysql # Set the WORKDIR to /app so all following commands run in /app WORKDIR /app # Copy composer files into the app directory. COPY composer.json composer.lock ./ # Install dependencies with Composer. # --prefer-source fixes issues with download limits on GitHub. # --no-interaction makes sure composer can run fully automated RUN composer install --prefer-source --no-interaction COPY . ./
When setting environment variables with PHP, the syntax can be either
$varname. Individual frameworks may have their own formatting. For instance, Symfony uses
%env(VAR_NAME)%for environment variables in configuration files, such as database configuration.
Because of version and test dependency issues, it is advised to try using the Jet CLI to debug issues locally via
You can enable caching per service in your Services file.