sourcebroker/deployer-loader

Load deployer tasks and settings from packages, path files.

5.0.0 2025-03-02 14:08 UTC

Requires

• ext-json: *

MIT

• Krystian Szymukowicz

• deployer

README

• What does it do?
• Installation
• Usage
• Changelog

What does it do?

This package allows to load:

1. single task or set of tasks from given path -> loader type: path
2. set of tasks from "deployer" folder of composer package -> loader type: package
3. loader config from composer package -> loader type: get

Installation

composer require sourcebroker/deployer-loader

Usage

• TYPE path

  You can load single file or multiple files. You can use excludePattern to exclude.

  new \SourceBroker\DeployerLoader\Load(
     ['path' => 'vendor/sourcebroker/deployer-extended-database/deployer/db/task/db:copy.php'],
     ['path' => 'vendor/sourcebroker/deployer-extended-database/deployer/db/task/db:move.php'],
  );
  
  new \SourceBroker\DeployerLoader\Load(
     ['path' => 'vendor/sourcebroker/deployer-extended-database/deployer/db', 'excludePattern' => '/move/'],
     ['path' => 'vendor/sourcebroker/deployer-extended-media/deployer/media'],
  );
  

• TYPE file_phar

  A file is loaded from relative to root project. Allows to include Deployer phar file.

  new \SourceBroker\DeployerLoader\Load(
     ['file_phar' => 'recipe/common.php'],
  );
  

• TYPE package

  Files are loaded recursively form given package from hardcoded folder deployer.

  new \SourceBroker\DeployerLoader\Load(
     ['package' => 'sourcebroker/deployer-extended-database'],
     ['package' => 'sourcebroker/deployer-extended-media'],
  );
  

• TYPE get

  In case of get first the file with array of loader configurations is read from given package. The logic to read the file is like:

  • First it checks if the composer.json file contains the key extra.sourcebroker/deployer.loader-file.
  • If the key exists, it read it and execute inclusions.
  • If the key does not exist, it defaults to the path config/loader.php within the package directory.

  Then the loader configurations read from that file are executed.

  Example of loader file: https://github.com/sourcebroker/deployer-typo3-database/blob/main/config/loader.php

  new \SourceBroker\DeployerLoader\Load(
     ['get' => 'sourcebroker/deployer-typo3-database'],
     ['get' => 'sourcebroker/deployer-typo3-media'],
     ['get' => 'sourcebroker/deployer-typo3-deploy-ci'],
  );
  

Changelog

See https://github.com/sourcebroker/deployer-loader/blob/master/CHANGELOG.rst