PHPackages                             digitalerase/deployer-extended-media - 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. [Image & Media](/categories/media)
4. /
5. digitalerase/deployer-extended-media

ActiveLibrary[Image & Media](/categories/media)

digitalerase/deployer-extended-media
====================================

Deployer tasks to manage media synchronization between application instances.

11.0.1.6(3y ago)02.9k↑100%1MITPHP

Since Jun 16Pushed 3y agoCompare

[ Source](https://github.com/digitalerase/deployer-extended-media)[ Packagist](https://packagist.org/packages/digitalerase/deployer-extended-media)[ RSS](/packages/digitalerase-deployer-extended-media/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependencies (3)Versions (25)Used By (1)

deployer-extended-media
=======================

[](#deployer-extended-media)

[![https://scrutinizer-ci.com/g/sourcebroker/deployer-extended-media/badges/quality-score.png?b=master](https://camo.githubusercontent.com/36d2d859815fe43a84c9b828e65bc8df47c5776b9c559769a0476a9a1401e8d1/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f736f7572636562726f6b65722f6465706c6f7965722d657874656e6465642d6d656469612f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/sourcebroker/deployer-extended-media/?branch=master)[![http://img.shields.io/packagist/v/sourcebroker/deployer-extended-media.svg?style=flat](https://camo.githubusercontent.com/61f001af49b3bf5d41888efb28dcd761cfb3da2a8f2696c83a7d4053c415b101/687474703a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736f7572636562726f6b65722f6465706c6f7965722d657874656e6465642d6d656469612e7376673f7374796c653d666c6174)](https://packagist.org/packages/sourcebroker/deployer-extended-media)[![https://img.shields.io/badge/license-MIT-blue.svg?style=flat](https://camo.githubusercontent.com/f48f8d6cf609f5b181b9c3218a85175fe8a5809c7ea400347f39697a5d55065d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c6174)](https://packagist.org/packages/sourcebroker/deployer-extended-media)

- [What does it do?](#what-does-it-do)
- [How this can be useful for me?](#how-this-can-be-useful-for-me)
- [Installation](#installation)
- [Options](#options)
- [Tasks](#tasks)
    - [media:copy](#media-copy)
    - [media:link](#media-link)
    - [media:pull](#media-pull)
    - [media:push](#media-push)
- [Changelog](#changelog)

[What does it do?](#id1)
------------------------

[](#what-does-it-do)

The package provides additional tasks for deployer (deployer.org) for synchronizing media between instances.

[How this can be useful for me?](#id2)
--------------------------------------

[](#how-this-can-be-useful-for-me)

The most useful is `dep media:pull [source]` task which allows you to pull media from source instance to current instance with rsync.

There are also two additional useful tasks which allows to copy or symlink media between remote instances. For example you can use `dep media:link [source] --options=target:[target]` to create symlinks for each single file (equivalent of cp -Rs).

[Installation](#id3)
--------------------

[](#installation)

1. Install package with composer:

    ```
    composer require digitalerase/deployer-extended-media
    ```
2. If you are using deployer as composer package then just put following line in your deploy.php:

    ```
    new \SourceBroker\DeployerLoader\Load([['path' => 'vendor/digitalerase/deployer-extended-media/deployer']]);
    ```
3. If you are using deployer as phar then put following lines in your deploy.php:

    ```
    require_once(__DIR__ . '/vendor/digitalerase/deployer-loader/autoload.php');
    new \SourceBroker\DeployerLoader\Load([['path' => 'vendor/digitalerase/deployer-extended-media/deployer']]);
    ```

    IMPORTANT NOTE!

    Do not put `require('/vendor/autoload.php')` inside your deploy.php because you can have dependency problems. Use `require_once(__DIR__ . '/vendor/digitalerase/deployer-loader/autoload.php');` instead as suggested.
4. In deploy.php set the folders you want to synchronize:

    ```
    set('media',
        [
         'filter' => [
             '+ /fileadmin/',
             '- /fileadmin/_processed_/*',
             '+ /fileadmin/**',
             '+ /uploads/',
             '+ /uploads/**',
             '- *'
        ]
    ]);
    ```
5. Run the task:

    ```
    dep media:pull [source]
    ```

[Options](#id4)
---------------

[](#options)

- **exclude**

    *default value:* null

    Array with patterns to be excluded.
- **exclude-case-insensitive**

    *default value:* null

    Array with patterns to be excluded. Because rsync does not support case insensitive then each value of array is set in state uppercase/lowercase. That means if you will have `['*.mp4', '*.zip']`then final exclude will be `--exclude '*.[mM][pP]4' --exclude '*.[zZ][iI][pP]'`
- **exclude-file**

    *default value:* null

    String containing absolute path to file, which contains exclude patterns.
- **include**

    *default value:* null

    Array with patterns to be included.
- **include-file**

    *default value:* null

    String containing absolute path to file, which contains include patterns.
- **filter**

    *default value:* null

    Array of rsync filter rules
- **filter-file**

    *default value:* null

    String containing merge-file filename.
- **filter-perdir**

    *default value:* null

    String containing merge-file filename to be scanned and merger per each directory in rsync list offiles to send.
- **flags**

    *default value:* rz

    Flags added to rsync command.
- **options**

    *default value:* ['copy-links', 'keep-dirlinks', 'safe-links']

    Array of options to be added to rsync command.
- **timeout**

    *default value:* 0

    Timeout for rsync task. Zero means no timeout.

Default configuration for task:

```
set('media_default',
 [
     'exclude' => [],
     'exclude-case-insensitive' => [
         '*.mp4',
         '*.zip',
         '*.pdf',
         '*.exe',
         '*.doc',
         '*.docx',
         '*.pptx',
         '*.ppt',
         '*.xls',
         '*.xlsx',
         '*.xlsm',
         '*.tiff',
         '*.tif',
         '*.potx',
         '*.mpg',
         '*.mp3',
         '*.avi',
         '*.wmv',
         '*.flv',
         '*.eps',
         '*.ai',
         '*.mov',
     ],
     'exclude-file' => false,
     'include' => [],
     'include-file' => false,
     'filter' => [],
     'filter-file' => false,
     'filter-perdir' => false,
     'flags' => 'rz',
     'options' => ['copy-links', 'keep-dirlinks', 'safe-links'],
     'timeout' => 0,
 ]);
```

In your project you should set "media" which will be merged with "media\_default" configuration.

Example configuration for TYPO3 CMS (typo3.org):

```
set('media',
    [
     'filter' => [
         '+ /fileadmin/',
         '- /fileadmin/_processed_/*',
         '+ /fileadmin/**',
         '+ /uploads/',
         '+ /uploads/**',
         '- *'
    ]
]);
```

[Tasks](#id5)
-------------

[](#tasks)

### [media:copy](#id6)

[](#mediacopy)

Copy media between (remote) instances.

```
dep media:copy [source] --options=target:[target]
```

Commands are executed on target remote instance. If instances are placed on the same remote server then rsync on local files are called. If instances are placed on different remote servers then `media:pull [source]` is executed on target instance.

Copy to instance defined in `instance_live_name` (default `production`) is special case. If you copy to highest instance then by default you will be asked twice if you really want to. You can disable asking by setting `media_allow_copy_live_force` to `true`. You can also forbid coping to live instance by setting `media_allow_copy_live` to `false`.

Example: `dep media:copy production --options=target:staging`

### [media:link](#id7)

[](#medialink)

Only for remote instances placed on same machine. Command creates symbolic links on target instance pointing to files on source machine.

```
media:link [source] --options=target:[target]
```

For each file from source instance that does not exist on target instance: 1. Create directory tree recursively. 2. Symlink to file from source instance.

So each file on target instance may be modified / deleted without effect on source.

Linking to instance defined in `instance_live_name` (default `production`) is special case. If you link to highest instance then by default you will be asked twice if you really want to. You can disable asking by setting `media_allow_link_live_force` to `true`. You can also forbid linking to live instance by setting `media_allow_link_live` to `false`.

Example: `dep media:link production --options=target:staging`

### [media:pull](#id8)

[](#mediapull)

Pull media from source instance to current instance using rsync and options from "media\_default" and "media".

```
dep media:pull [source]
```

Example: `dep media:pull production`

Pulling to instance defined in `instance_live_name` (default `production`) is special case. If you pull to highest instance then by default you will be asked twice if you really want to. You can disable asking by setting `media_allow_pull_live_force` to `true`. You can also forbid pulling to live instance by setting `media_allow_pull_live` to `false`.

### [media:push](#id9)

[](#mediapush)

Pull media from current instance to target instance using rsync and options from "media\_default" and "media".

```
dep media:push [target]
```

Pushing to instance defined in `instance_live_name` (default `production`) is special case. If you push to highest instance then by default you will be asked twice if you really want to. You can disable asking by setting `media_allow_push_live_force` to `true`. You can also forbid puhsing to live instance by setting `media_allow_push_live` to `false`.

Example: `dep media:push staging`

[Changelog](#id10)
------------------

[](#changelog)

See

###  Health Score

35

—

LowBetter than 77% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 96.3% 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 ~92 days

Recently: every ~14 days

Total

24

Last Release

1171d ago

Major Versions

6.0.3 → 7.0.02020-02-22

7.1.0 → 8.0.02020-10-16

8.0.0 → 9.0.02022-10-30

9.0.0 → 10.0.02022-12-11

10.0.0 → 11.0.02022-12-28

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/9947815?v=4)[Per Forsberg](/maintainers/perforsberg77)[@perforsberg77](https://github.com/perforsberg77)

---

Top Contributors

[![kszymukowicz](https://avatars.githubusercontent.com/u/1453553?v=4)](https://github.com/kszymukowicz "kszymukowicz (77 commits)")[![perforsberg77](https://avatars.githubusercontent.com/u/9947815?v=4)](https://github.com/perforsberg77 "perforsberg77 (2 commits)")[![blankse](https://avatars.githubusercontent.com/u/998558?v=4)](https://github.com/blankse "blankse (1 commits)")

---

Tags

synchronizationmediadeployer

### Embed Badge

![Health badge](/badges/digitalerase-deployer-extended-media/health.svg)

```
[![Health](https://phpackages.com/badges/digitalerase-deployer-extended-media/health.svg)](https://phpackages.com/packages/digitalerase-deployer-extended-media)
```

###  Alternatives

[essence/essence

Extracts information about medias on the web, like youtube videos, twitter statuses or blog articles.

771583.8k3](/packages/essence-essence)[s9e/text-formatter

Multi-purpose text formatting and markup library. Plugins offer support for BBCodes, Markdown, emoticons, HTML, embedding third-party media (YouTube, etc...), enhanced typography and more.

2423.2M34](/packages/s9e-text-formatter)[dereuromark/media-embed

A PHP library to deal with all those media services around, parsing their URLs and embedding their audio/video content in websites.

177561.2k15](/packages/dereuromark-media-embed)[cohensive/embed

Media Embed (for Laravel or as a standalone).

117380.9k](/packages/cohensive-embed)[classic-o/nova-media-library

Tool and field that will let you managing files and add them to the posts

154177.4k](/packages/classic-o-nova-media-library)[tomatophp/filament-media-manager

Manage your media files using spatie media library with easy to use GUI for FilamentPHP

14849.5k3](/packages/tomatophp-filament-media-manager)

PHPackages © 2026

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