PHPackages                             sourcebroker/deployer-loader - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [DevOps & Deployment](/categories/devops)
4. /
5. sourcebroker/deployer-loader

ActiveLibrary[DevOps & Deployment](/categories/devops)

sourcebroker/deployer-loader
============================

Load deployer tasks and settings from packages, path files.

5.1.1(9mo ago)4318.2k—0.6%511MITPHP

Since Oct 1Pushed 9mo ago1 watchersCompare

[ Source](https://github.com/sourcebroker/deployer-loader)[ Packagist](https://packagist.org/packages/sourcebroker/deployer-loader)[ RSS](/packages/sourcebroker-deployer-loader/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (15)Used By (11)

deployer-loader
===============

[](#deployer-loader)

[![Latest Stable Version](https://camo.githubusercontent.com/ba4e0062721f8f5eaf17bd9f83cf595c43957b2a1e0c20cf634d428b3b0e8835/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736f7572636562726f6b65722f6465706c6f7965722d6c6f616465722e7376673f7374796c653d666c6174)](https://packagist.org/packages/sourcebroker/deployer-loader)[![License](https://camo.githubusercontent.com/f48f8d6cf609f5b181b9c3218a85175fe8a5809c7ea400347f39697a5d55065d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c6174)](https://packagist.org/packages/sourcebroker/deployer-loader)

What does it do?
----------------

[](#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
------------

[](#installation)

```
composer require sourcebroker/deployer-loader
```

Usage
-----

[](#usage)

### TYPE `path`

[](#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`

[](#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`

[](#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`

[](#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:

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

Conflict detection
------------------

[](#conflict-detection)

If a loader specifies a 'conflict' configuration that matches another loaded configuration, an exception is thrown with detailed information about the conflict, including which package caused it.

```
    [
        'package' => 'sourcebroker/deployer-typo3-deploy',
        'conflict' => [
            'package' => [
                'sourcebroker/deployer-typo3-deploy-ci'
            ]
        ]
    ]
```

Check if configuration is loaded
--------------------------------

[](#check-if-configuration-is-loaded)

You can check if a specific configuration item has already been loaded using the `isLoaded()` method:

```
if (\SourceBroker\DeployerLoader\Utility\LoadUtility::isLoaded(['package' => 'sourcebroker/deployer-typo3-deploy'])) {

}
```

Changelog
---------

[](#changelog)

See [CHANGELOG.rst](https://github.com/sourcebroker/deployer-loader/blob/master/CHANGELOG.rst)

###  Health Score

51

—

FairBetter than 96% of packages

Maintenance58

Moderate activity, may be stable

Popularity41

Moderate usage in the ecosystem

Community22

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 94.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~221 days

Recently: every ~244 days

Total

14

Last Release

276d ago

Major Versions

0.0.1 → 1.0.02017-10-01

1.0.4 → 2.0.02019-11-11

2.0.1 → 3.0.02022-10-30

3.0.0 → 4.0.02022-12-11

4.0.1 → 5.0.02025-03-02

### Community

Maintainers

![](https://www.gravatar.com/avatar/6066d053dfdc12f5a676444f6a40b5b7d0b5a112e0ab746c8b04f4a7201b0624?d=identicon)[sourcebroker](/maintainers/sourcebroker)

---

Top Contributors

[![kszymukowicz](https://avatars.githubusercontent.com/u/1453553?v=4)](https://github.com/kszymukowicz "kszymukowicz (37 commits)")[![blankse](https://avatars.githubusercontent.com/u/998558?v=4)](https://github.com/blankse "blankse (1 commits)")[![jmeinert](https://avatars.githubusercontent.com/u/52486812?v=4)](https://github.com/jmeinert "jmeinert (1 commits)")

---

Tags

deployerdeploymentloaderphpsb-dldeployer

### Embed Badge

![Health badge](/badges/sourcebroker-deployer-loader/health.svg)

```
[![Health](https://phpackages.com/badges/sourcebroker-deployer-loader/health.svg)](https://phpackages.com/packages/sourcebroker-deployer-loader)
```

###  Alternatives

[easycorp/easy-deploy-bundle

The easiest way to deploy Symfony applications

468310.2k](/packages/easycorp-easy-deploy-bundle)[jalogut/magento2-deployer-plus

Magento 2 deployment tool based on deployer.org

201415.5k](/packages/jalogut-magento2-deployer-plus)[sourcebroker/deployer-extended-typo3

Customisation for `sourcebroker/deployer-typo3-\*` stack

38201.6k2](/packages/sourcebroker-deployer-extended-typo3)[sourcebroker/deployer-extended

Library with some additional tasks for deployer (deployer.org).

25275.4k9](/packages/sourcebroker-deployer-extended)[rafaelstz/deployer-magento2

Magento 2 deployment tool based on deployer.org

5223.5k](/packages/rafaelstz-deployer-magento2)[ngmy/webloyer

Webloyer is a Web UI for managing Deployer deployments

2181.1k](/packages/ngmy-webloyer)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)