PHPackages                             hpatoio/deploy-bundle - 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. hpatoio/deploy-bundle

ActiveSymfony-bundle[DevOps & Deployment](/categories/devops)

hpatoio/deploy-bundle
=====================

Easy deploy via rsync. Porting of Symfony 1 project:deploy command.

1.5.3(10y ago)3597.5k↑382.1%131CC-BY-SA-3.0PHPPHP >=5.3.2

Since Oct 12Pushed 6y ago3 watchersCompare

[ Source](https://github.com/hpatoio/DeployBundle)[ Packagist](https://packagist.org/packages/hpatoio/deploy-bundle)[ Docs](http://github.com/hpatoio/DeployBundle)[ RSS](/packages/hpatoio-deploy-bundle/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (3)Dependencies (1)Versions (13)Used By (1)

DeployBundle
============

[](#deploybundle)

[![Total Downloads](https://camo.githubusercontent.com/b1432412b9e54cd5a6d902a48828b1a05828aa90d6c441c616e90d0e2f245c54/68747470733a2f2f706f7365722e707567782e6f72672f687061746f696f2f6465706c6f792d62756e646c652f646f776e6c6f6164732e706e67)](https://packagist.org/packages/hpatoio/deploy-bundle)[![Latest Stable Version](https://camo.githubusercontent.com/2ecf0116914028a741cf847b46f8a22eb50bd455f2abf8c58885c1d550a07d35/68747470733a2f2f706f7365722e707567782e6f72672f687061746f696f2f6465706c6f792d62756e646c652f762f737461626c652e706e67)](https://packagist.org/packages/hpatoio/deploy-bundle)[![SensioLabsInsight](https://camo.githubusercontent.com/3accf10ee925e49b853d6ca3b5b557a656953eafd288e8d5c0b8400b43de7e9d/68747470733a2f2f696e73696768742e73656e73696f6c6162732e636f6d2f70726f6a656374732f62343535366364372d363532662d346135382d393132362d6562326331616264366338392f6d696e692e706e67)](https://insight.sensiolabs.com/projects/b4556cd7-652f-4a58-9126-eb2c1abd6c89)

Installation
------------

[](#installation)

Run the command:

```
$ composer require hpatoio/deploy-bundle ~1.5
```

**N.B.** This project follow [semantic versioning](http://semver.org/). Latest stable branch is `1.5`.

### Enable the bundle in your project

[](#enable-the-bundle-in-your-project)

```
// app/AppKernel.php
public function registerBundles()
{
    $bundles = array(
        // ...
        new Hpatoio\DeployBundle\DeployBundle(),
        // ...
    );
}
```

Configuration
-------------

[](#configuration)

Configuration is all about defining environments. You can define as many environments as you want, the only mandatory value is `host`. The deploy is made via rsync so default value are used if none are specified. Remember that to get the configuration reference for this bundle you can run:

```
bin/console config:dump-reference DeployBundle
```

Configuration example:

```
# app/config/config.yml
deploy:
  prod:
    rsync-options: '-azC --force --delete --progress -h --checksum'
    host: my.destination.env
    dir: /path/to/project/root
    user: root
    port: 22
    timeout: 120 # Connection timeout in seconds. 0 for no timeout.
  uat:
    host: 192.168.1.10
    user: root2
    dir: /path/to/project/root
    port: 22022
    post_deploy_operations:
        - bin/console cache:clear --env=prod
        - bin/console assets:install --env=prod
        - bin/console assetic:dump --env=prod
```

Most of the keys don't need explanation except:

#### post\_deploy\_operations

[](#post_deploy_operations)

You can add a list of command you want run on the remote server after the deploy. In the configuration above you can see the common command you run after a deploy (clear the cache, publish assets etc) These commands are run as a shell command on the remote server. So you can enter whichever shell command you want (cp, rm etc)

Please don't confuse Symfony environment with deploy environment. As you can see in the configuration above we run `post_deploy_operations` for Symfony environment `prod` on deploy environment `uat`

#### rsync-options

[](#rsync-options)

If you add the key `rsync-options` to your environment you will override the default options used for rsync. So the system is using:

- "-azC --force --delete --progress -h --checksum" if nothing is specified
- the value for the key `rsync-options` if specified it in `config.yml` for the target environment
- the value of the command line option `--rsync-options`

### Rsync Exclude

[](#rsync-exclude)

Create a `rsync_exclude.txt` file under `app/config` to exclude files from deploy. [here](https://github.com/hpatoio/DeployBundle/blob/master/.rsync_exclude.txt.dist) a good starting point.

You can also create a per-environment rsync\_exclude. Just create a file in `app/config` with name `rsync_exclude_{env}.txt`. For more details you can read here #3 and here #7

Force vendor syncronization
---------------------------

[](#force-vendor-syncronization)

Usually `vendor` dir is excluded from rsync. If you need tou sync it you can add `--force-vendor`. (see later for an example)

Use
---

[](#use)

Deployment is easy:

```
php bin/console project:deploy --go prod
```

Feel a bit unsure ? Simulate the deploy

```
php bin/console project:deploy prod
```

Need to update vendor ? Use the option --force-vendor (Usually vendor is excluded from rsync)

```
php bin/console project:deploy --go --force-vendor prod
```

Custom parameters for rsync

```
php bin/console project:deploy --rsync-options="-azChdl" prod
```

License
-------

[](#license)

DeployBundle is licensed under the CC-BY-SA-3.0 - see [here](http://www.spdx.org/licenses/CC-BY-SA-3.0) for details

###  Health Score

40

—

FairBetter than 86% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity42

Moderate usage in the ecosystem

Community21

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 87.5% 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 ~122 days

Recently: every ~134 days

Total

11

Last Release

3788d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/eaf87487564c21320bc1f156e09a16676493025df770ce9386b1be33c76f6b6e?d=identicon)[hpatoio](/maintainers/hpatoio)

---

Top Contributors

[![hpatoio](https://avatars.githubusercontent.com/u/249948?v=4)](https://github.com/hpatoio "hpatoio (49 commits)")[![dator](https://avatars.githubusercontent.com/u/79864796?v=4)](https://github.com/dator "dator (3 commits)")[![bitdeli-chef](https://avatars.githubusercontent.com/u/3092978?v=4)](https://github.com/bitdeli-chef "bitdeli-chef (1 commits)")[![hjanuschka](https://avatars.githubusercontent.com/u/2891702?v=4)](https://github.com/hjanuschka "hjanuschka (1 commits)")[![nelsonkopliku](https://avatars.githubusercontent.com/u/8167114?v=4)](https://github.com/nelsonkopliku "nelsonkopliku (1 commits)")[![royopa](https://avatars.githubusercontent.com/u/442991?v=4)](https://github.com/royopa "royopa (1 commits)")

---

Tags

deploysymfony-bundlecommanddeploy

### Embed Badge

![Health badge](/badges/hpatoio-deploy-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/hpatoio-deploy-bundle/health.svg)](https://phpackages.com/packages/hpatoio-deploy-bundle)
```

###  Alternatives

[easycorp/easyadmin-bundle

Admin generator for Symfony applications

4.3k17.9M388](/packages/easycorp-easyadmin-bundle)[rcsofttech/audit-trail-bundle

Enterprise-grade, high-performance Symfony audit trail bundle. Automatically track Doctrine entity changes with split-phase architecture, multiple transports (HTTP, Queue, Doctrine), and sensitive data masking.

1189.8k](/packages/rcsofttech-audit-trail-bundle)[ecotone/symfony-bundle

Ecotone for Symfony — CQRS, Event Sourcing, Sagas, Durable Workflows, and Outbox on top of Symfony Messenger, via PHP attributes.

11249.0k1](/packages/ecotone-symfony-bundle)[2lenet/crudit-bundle

The easy like Crud'it Bundle.

1616.4k14](/packages/2lenet-crudit-bundle)

PHPackages © 2026

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