PHPackages                             perspikapps/php-easy-deployer - 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. perspikapps/php-easy-deployer

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

perspikapps/php-easy-deployer
=============================

A deployer.org recipe with url-based easy configuration

v1.0.0(4y ago)021[1 issues](https://github.com/perspikapps/php-easy-deployer/issues)[3 PRs](https://github.com/perspikapps/php-easy-deployer/pulls)MITPHPPHP ^7.4

Since May 23Pushed 2mo agoCompare

[ Source](https://github.com/perspikapps/php-easy-deployer)[ Packagist](https://packagist.org/packages/perspikapps/php-easy-deployer)[ Docs](https://github.com/perspikapps/php-easy-deploy)[ RSS](/packages/perspikapps-php-easy-deployer/feed)WikiDiscussions develop Synced 3w ago

READMEChangelogDependencies (6)Versions (8)Used By (0)

Easy Deployer
=============

[](#easy-deployer)

[![Packagist](https://camo.githubusercontent.com/816a790fd29ba685c517e38062b9aee737530ddc3fb7c844bef22137f31e6ee8/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7065727370696b617070732f7068702d656173792d6465706c6f7965722e737667)](https://packagist.org/packages/perspikapps/php-easy-deployer)[![Packagist](https://camo.githubusercontent.com/f81b2a3d3fe4ba57612d3126064e9c51b935392732c68f53215082ee1a000d1d/68747470733a2f2f706f7365722e707567782e6f72672f7065727370696b617070732f7068702d656173792d6465706c6f7965722f642f746f74616c2e737667)](https://packagist.org/packages/perspikapps/php-easy-deployer)[![Packagist](https://camo.githubusercontent.com/52f6372bb0607acce4df6d02f3f59cf2fe5c00bb2eb32903f26914179d1f4532/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7065727370696b617070732f7068702d656173792d6465706c6f7965722e737667)](https://packagist.org/packages/perspikapps/php-easy-deployer)

[![Commitizen friendly](https://camo.githubusercontent.com/c287c27407d94c6772fe44d84ee2281971e70c36bf5a28dfe6f2c31f66ea096a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f6d6d6974697a656e2d667269656e646c792d627269676874677265656e2e737667)](http://commitizen.github.io/cz-cli/) [![semantic-release](https://camo.githubusercontent.com/5f3b57745af83409bc673dec57e3eb360e1ec53b37ac29f81a319e347fa351c6/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f2532302532302546302539462539332541362546302539462539412538302d73656d616e7469632d2d72656c656173652d6531303037392e737667)](https://github.com/semantic-release/semantic-release)

[![Buy me a coffee](https://camo.githubusercontent.com/cc27971f9ec7aa779971c58c826a6c67cda2b2ba0940c9bb010d44c3168a15a6/68747470733a2f2f62616467656e2e6e65742f62616467652f6275796d6561636f6666652f746f6d6772762f79656c6c6f773f69636f6e3d6275796d6561636f66666565)](https://buymeacoffee.com/tomgrv)

This package handles deployement configuration via a `deploy.yaml` file to define deploy strategy and a `.hostmap` file to define target strategy

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

[](#installation)

Install via composer

```
composer require perspikapps/php-easy-deployer
```

Usage
-----

[](#usage)

Deployment is handled by [deployphp/deployer](https://github.com/deployphp/deployer) package.

### deploy.yaml

[](#deployyaml)

*See [deployer](https://github.com/deployphp/deployer) config for details*

```
import:
    - vendor/perspikapps/php-easy-deployer/src/strategy_laravel.php
    - vendor/perspikapps/php-easy-deployer/src/strategy_upload.php
    - vendor/perspikapps/php-easy-deployer/src/strategy_update.php
    - vendor/perspikapps/php-easy-deployer/src/strategy_shared.php
    - vendor/perspikapps/php-easy-deployer/src/strategy.php

config:
    source_path: './'
    shared_dirs:
        - storage
    shared_files:
        - .env
    writable_dirs:
        - bootstrap/cache
        - storage
        - storage/app
        - storage/app/public
        - storage/framework
        - storage/framework/cache
        - storage/framework/sessions
        - storage/framework/views
        - storage/logs
    log_files:
        - storage/logs/*.log
```

### .hostname

[](#hostname)

Specify ONE deployement target per line as url:

- url scheme = strategies to activate (`+` separated, each must be loaded in `import` section of `deploy.yaml` file)
- url user/host/port = server to deploy to
- url path = path on server to deploy to
- url query = deploy options to use
- url anchor = variables to set in .env file after deployment

```
upload+laravel://user@dev.exemple.com/var/home/{{hostname}}?bin/php=/opt/plesk/php/7.4/bin/php&writable_mode=chmod#debug=true&env=staging
upload+laravel://user@beta.exemple.com/var/home/{{hostname}}?bin/php=/opt/plesk/php/7.4/bin/php&writable_mode=chmod#debug=true&env=beta
upload+laravel://user@www.exemple.com/var/home/{{hostname}}?bin/php=/opt/plesk/php/7.4/bin/php&writable_mode=chmod#debug=false&env=production
```

Security
--------

[](#security)

If you discover any security related issues, please email instead of using the issue tracker.

Credits
-------

[](#credits)

- [tomgrv](https://github.com/tomgrv)
- [deployphp](https://github.com/deployphp)

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance58

Moderate activity, may be stable

Popularity3

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

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

Unknown

Total

1

Last Release

1502d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2738d1530aa105abd4ef531339d50841bcd735fc600160dfed8943370d6e05bf?d=identicon)[tomgrv](/maintainers/tomgrv)

---

Tags

laraveldeploydeployer

###  Code Quality

TestsPHPUnit

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/perspikapps-php-easy-deployer/health.svg)

```
[![Health](https://phpackages.com/badges/perspikapps-php-easy-deployer/health.svg)](https://phpackages.com/packages/perspikapps-php-easy-deployer)
```

###  Alternatives

[ngmy/webloyer

Webloyer is a Web UI for managing Deployer deployments

2191.1k](/packages/ngmy-webloyer)[innocenzi/deployer-recipe-forge

Seamless zero-downtime deployment on Forge with Deployer

1916.7k](/packages/innocenzi-deployer-recipe-forge)

PHPackages © 2026

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