pinoox/pinroll

Pinroll — atomic release rollout, rollback, and PinGate delivery for Pinoox

1.1.2 2026-07-26 14:31 UTC

Requires

• php: ^8.2
• pinoox/pinion: ^1.1
• symfony/console: ^6.4|^7.0
• symfony/http-foundation: ^6.4|^7.0

Requires (Dev)

• nunomaduro/collision: ^8.5
• pestphp/pest: ^2.36

Suggests

• phpseclib/phpseclib: SSH/SFTP transport
• pinoox/pincore: HMVC integration, Pinx pipeline, and php pinoox CLI

MIT

• Pinoox

• php
• deploy
• release
• devops
• rollback
• ci-cd
• pinoox
• pinroll
• pingate

Published on Packagist.org on 2026-07-26 14:34 UTC

README

Pinroll (pinoox/pinroll) 1.1.3 — atomic release rollout, rollback, and PinGate delivery for Pinoox.

Concept	Meaning
Host	Where to deploy (production, staging, …)
Bundle	What to ship (auto-detect apps, or --bundle=…)
Transport	How to send (ftp, ssh, pinion, local)
PinGate	Remote HTTP entry for install / status / rollback / vendor extract

Documentation

Full guides (setup, hosts, retention, rollback, CLI):

• Pinroll — release & deploy (EN)
• Pinroll — انتشار و دیپلوی (FA)
• Pinroll overview

Install

On a Pinoox platform project, add Pinroll as a production dependency (required on the host for PinGate):

composer require pinoox/pinroll

"require": {
  "php": "^8.2",
  "pinoox/pincore": "^3.8",
  "pinoox/pinroll": "^1.1"
}

Do not put pinoox/pinroll only in require-dev. Platform builds and host vendor packs strip require-dev.

Quick start

php pinoox pinroll:init
# fill PINROLL_* credentials in .env
php pinoox pinroll:connect
php pinoox pinroll:apps
php pinoox pinroll:gate -n
php pinoox pinroll:vendor --push -n   # production vendor via PlatformComposer + PinGate
php pinoox pinroll:check
php pinoox pinroll:deploy

Step	Command	What it does
1	pinroll:init	Scaffold pinroll/pinroll.config.php
2	Edit .env	Set PINROLL_* FTP/SSH keys
3	pinroll:connect	Deploy path, site URL, upload PinGate (--reset to re-run)
4	pinroll:apps	Set default packages for the host
5	pinroll:vendor --push	Build production vendor.zip, upload, extract on host
6	pinroll:check	Verify transport + PinGate
7	pinroll:deploy	Build, upload, and install apps (go live)

CLI

php pinoox pinroll:init
php pinoox pinroll:connect
php pinoox pinroll:apps
php pinoox pinroll:push
php pinoox pinroll:deploy
php pinoox pinroll:install
php pinoox pinroll:push --app=com_pinoox_developer
php pinoox pinroll:build --bundle=single-app --package=com_pinoox_developer
php pinoox pinroll:status
php pinoox pinroll:history
php pinoox pinroll:rollback
php pinoox pinroll:cleanup
php pinoox pinroll:gate
php pinoox pinroll:vendor
php pinoox pinroll:vendor --push
php pinoox pinroll:pull --server=https://releases.example.com

• pinroll:init — scaffold pinroll/ + .env key stubs (no prompts)
• pinroll:connect — configure host + upload PinGate; verifies if already set (--reset to redo)
• pinroll:apps — set hosts.*.apps (interactive or --apps=)
• pinroll:check — verify host connectivity before push
• pinroll:push — build and upload only (no install)
• pinroll:deploy — push + install via PinGate (go live); runs fe:build before pinx:build
• pinroll:install — install a staged release (pinroll:apply is a deprecated alias)
• pinroll:rollback — switch the host back to a previous release
• pinroll:cleanup — prune local/remote archives by keep / store (after last install in multi-app deploy)
• pinroll:gate — rebuild/upload PinGate (-z zip; --no-upload keep local)
• pinroll:vendor — production vendor.zip via PlatformComposer (--push FTP + PinGate POST /vendor)
• pinroll:pull — pull newer manifest from a release server (alias: pinroll:poll)

Tests

composer test
composer test:platform

License

MIT — Pinoox