This package is not installable via Composer 1.x, please make sure you upgrade to Composer 2+. Read more about our Composer 1.x deprecation policy.

A PHPCI plugin to copy an environment configuration file to the build path

0.2.0 2016-03-16 20:05 UTC

This package is auto-updated.

Last update: 2021-09-09 09:52:53 UTC


Build Status Latest Stable Version License

A plugin for PHPCI to copy an external environment file (e.g. .env environment file used in a Laravel Application) to the appropriate build directory.

Initial Situation

When committing a application to a VCS, it is a common nature, not to include any sensitive data like database passwords within the application configuration files (e.g. .env, phpci.yml, phpunit.xml).

This plugins copies an environment file, located on the server PHPCI is running on, to the appropriate build directory. With that approach, there is no need to include any sensitive data in the application releated files.

Each branch in the VCS can be configured separately to support different settings for each branch:

  • master branch -> production settings
  • development branch -> stage settings

Install the Plugin

  1. Navigate to your PHPCI root directory and run composer require rephlux/phpci-external-env
  2. Update your phpci.yml in the project you want to deploy with


  1. Create a environment file for your project on the server PHPCI is running on
  2. Ensure that the environment file is readable.

Plugin Options

  • branch [array] - The specific branch for the project
    • env [string] - The path to the env file
    • path [string, optional] - The path to the destination filename relative to the appropriate build directory (default: '.env')

PHPCI Config

        env: <path_to_env_file>
        path: <path_to_destination_filename>


            env: "/usr/www/phpci/.env/laravel-application-production.env"
            env: "/usr/www/phpci/.env/laravel-application-stage.env"