Repository navigation
PHPloy v5.0.0 🚀
The first stable release of PHPloy’s 5.x line — a major rewrite built on Flysystem 3 with a modern test suite, plus two headline reliability fixes that make large deploys actually survivable.
⚡ Resilient mid-list resume (new --from)
PHPloy no longer gives up — or worse, silently skips a file — when the connection drops mid-deploy:
- Reconnects and retries with backoff (5 attempts, 2s → 20s) instead of a single retry. The boundary file is re-streamed from scratch, so a half-uploaded file is overwritten, never trusted.
- Never advances
.revisionpast a missing file. On exhaustion, it aborts loudly with the exact file index instead of reporting success with holes. phploy --from599 resumes an interrupted deploy at any 1-based index — re-uploading that file to be safe, then continuing. Skip the already-uploaded prefix on a 6,000-file first deploy.
🧹 Code quality that’s now actually true
- PSR-12 enforced via PHP_CodeSniffer (composer lint, lint:fix)
- PHPStan level 5 static analysis (composer analyze) — clean
- CI on every push/PR runs the full FTP + SFTP integration suite in Docker (23 tests)
What’s new in 5.0
- Flysystem 3.0 upgrade — latest filesystem abstraction
- Modern test suite — Docker Compose (FTP + SFTP servers), migrated from PHPUnit to Pest
- Improved structure — better separation of concerns (e.g. FileFilter extracted from Deployment)
- Streaming uploads — files are streamed via writeStream, never loaded into memory (fixes #376)
- Missing v4 features restored — include[] (with conditional target:condition), purge[]/purge-before[], copy[], base, logger, submodules, rollbacks, --status, --force, --sync, multiple servers
- SFTP fixes — password auth, key passphrases (#379), chroot’d servers
Requirements
- PHP 8.0+ (8.4+ for development)
- Git 1.8+
Install
composer global require "banago/phploy"
or download the phar:- https://banago.github.io/PHPloy/phploy.phar