language-php_5bdc3e8104286356f0a55ee5.md

• Supported PHP versions
• Dependency caching
• Environment variables
• System dependencies

This guide covers configuring PHP projects on Semaphore. If you’re new to Semaphore please read our Guided tour first.

Supported PHP versions

Semaphore provides major PHP versions and tools preinstalled. You can find information about them in the Ubuntu image reference.

Semaphore uses phpbrew to manage PHP versions. Any version installable with phpbrew is supported on Semaphore. Version 7.1 is pre-installed. You can install and switch versions using phpbrew and sem-version. Here's an example:

blocks:
  - name: Tests
    task:
      prologue:
        commands:
          - phpbrew install 5.6
          - sem-version php 5.6
      jobs:
        - name: Tests
          commands:
            - php --version

Dependency caching

Composer is preinstalled, so you can use the cache command to store and restore the vendor directory. In the following configuration example, we install dependencies and warm the cache in the first block, then use the cache in subsequent blocks.

version: "v1.0"
name: PHP Example
agent:
  machine:
    type: e1-standard-2
    os_image: ubuntu1804

blocks:
  - name: Install dependencies
    task:
      jobs:
        - name: Composer install
          commands:
            - checkout
            - cache restore composer-$(checksum composer.lock)
            - composer install
            - cache store composer-$(checksum composer.lock) vendor

  - name: Tests
    task:
      prologue:
        commands:
          - checkout
          - cache restore v1-composer-$(checksum composer.lock)
          # Prepend vendor/bin to the path so you can use dependency executables
          - export "PATH=./vendor/bin:${PATH}"
      jobs:
        - name: Everything
          commands:
            - codecept test

Environment variables

Semaphore doesn't set specific environment variables like APP_ENV. You can set these at the task level.

blocks:
  - name: Tests
    task:
      env_vars:
        - name: APP_ENV
          value: test
      jobs:
        - name: Everything
          commands:
            - codecept run

System dependencies

Projects may need system packages to install libraries for things like database drivers. Semaphore provides full sudo access so you can install all required packages. Here's an example:

blocks:
  - name: Tests
    task:
      prologue:
        commands:
          - sudo apt-get update && sudo apt-get install -y libpq-dev
          - composer install
      jobs:
        - name: Everything
          commands:
            - codecept run