PHPackages shipphp/faster - 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. [File & Storage](/categories/file-storage) 4. / 5. shipphp/faster ActiveLibrary[File & Storage](/categories/file-storage) shipphp/faster ============== Professional PHP deployment tool with git-like push/pull functionality, global installation, and profile management v2.1.1(3mo ago)221MITPHPPHP >=7.4 Since Jan 27Pushed 3mo agoCompare [ Source](https://github.com/ssanaullahrais/ShipPHP-Faster)[ Packagist](https://packagist.org/packages/shipphp/faster)[ RSS](/packages/shipphp-faster/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (4)DependenciesVersions (5)Used By (0) ShipPHP Faster - The Easiest Way to Deploy Your PHP Website! ============================================================ [](#shipphp-faster---the-easiest-way-to-deploy-your-php-website) [![Latest Version](https://camo.githubusercontent.com/b59290fdd7d9f66372a675bbc162e6fb3731c88785df3aef89f7b27f39fcfe51/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f736869707068702f6661737465723f7374796c653d666c61742d737175617265)](https://packagist.org/packages/shipphp/faster)[![License](https://camo.githubusercontent.com/334b9b314efffa05f1b0957c438cf224d12a5e1fcfbff49ef7ab15ed6661786b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f7373616e61756c6c6168726169732f536869705048502d4661737465723f7374796c653d666c61742d737175617265)](https://github.com/ssanaullahrais/ShipPHP-Faster/blob/main/LICENSE)[![PHP Version](https://camo.githubusercontent.com/5cc5bd11015493e90a22c4954451b13332470169ae80fad9151be201905f7db6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f736869707068702f6661737465723f7374796c653d666c61742d737175617265)](https://packagist.org/packages/shipphp/faster) [![ShipPHP Faster Screenshot](images/screenshot.png)](images/screenshot.png) **The Easiest Way to Deploy Your PHP Website - Now with Global Installation & Profile Management!** ShipPHP Faster is your all-in-one deployment toolkit for PHP websites designed to eliminate slow, risky manual uploads and messy FTP work forever. With a single command, you can push your latest changes to the server, pull updates down, check your deployment status, and instantly roll back or restore previous versions thanks to automatic version-tracked backups. - **No technical knowledge required** - **Global installation** (use from anywhere!) - **Multi-project support** (manage unlimited websites) - **Automatic version-tracked backups** (never lose your work!) - **Lightning fast** (only uploads changed files) - **Works everywhere** (Shared hosting, VPS, any server with PHP) - **Beautiful CLI interface** (Claude Code-style status bar) --- 📦 Installation -------------- [](#-installation) ### ⚡ Quick Install (Recommended) [](#-quick-install-recommended) **One command, done in seconds:** ``` composer global require shipphp/faster ``` That's it! ShipPHP is now available globally. Use it from any project: ``` cd /path/to/your/project shipphp init ``` **How to uninstall/remove? Use this:** ``` composer global remove shipphp/faster ``` **Requirements:** PHP 7.4+ and Composer --------------------------------------- [](#requirements-php-74-and-composer) ### Alternative Installation Methods [](#alternative-installation-methods) **Option 1: Manual Download (No Composer)****Step 1: Download ShipPHP** **Option A: Clone from GitHub** ``` git clone https://github.com/ssanaullahrais/ShipPHP-Faster.git shipphp cd shipphp ``` **Option B: Download ZIP** 1. Go to: 2. Click "Code" → "Download ZIP" 3. Extract the ZIP file **Step 2: Install Globally (Automatic)** ``` php shipphp.php install --global ``` Now use `shipphp` command from anywhere! **Option 2: Per-Project Installation**### Local Installation (Per-Project) [](#local-installation-per-project) Put the `shipphp` folder in each project: ``` # Your project structure my-website/ ├── shipphp/ ← Put ShipPHP folder here ├── index.php ← Your website files ├── about.php └── ... ``` **Create a shortcut command:** ``` cd /path/to/my-website php shipphp/shipphp.php bootstrap ship # Now use shorter commands: php ship init php ship push php ship status ``` **💡 Tip:** For the best experience, use the Composer global installation method! --- 🎯 Quick Start (After Installation) ---------------------------------- [](#-quick-start-after-installation) ### Step 1: Initialize Your Project [](#step-1-initialize-your-project) ``` # If using global installation: shipphp init ``` **You'll be asked:** - **Project name:** (e.g., "My Blog", "Client Website") - **Domain:** Where your site runs (e.g., `myblog.com`) - **Max file size:** Upload limit (default: 100MB) - **IP whitelist:** Optional security (press Enter to skip) - **Rate limit:** API throttling (default: 120 req/min) - **Logging:** Enable request logs (recommended: Yes) **What ShipPHP creates:** - `shipphp.json` - Your local configuration - `shipphp-server.php` - Upload this to your server - `.shipphp/` - State tracking directory - **Global profile** - Saved in `~/.shipphp/profiles.json` ### Step 2: Upload Server File [](#step-2-upload-server-file) Upload `shipphp-server.php` to your website using FTP or cPanel: ``` https://yoursite.com/shipphp-server.php ``` ### Step 3: Login & Deploy! [](#step-3-login--deploy) ``` # Connect to your profile shipphp login # View changes shipphp status # Deploy! shipphp push ``` --- 🌟 What's New ------------ [](#-whats-new) ### ✨ Features Overview [](#-features-overview) #### Smart Quick Start Dashboard [](#smart-quick-start-dashboard) Just type `shipphp` to see a beautiful context-aware dashboard: ``` shipphp ╔════════════════════════════════════════════════════════════╗ ║ ║ ║ 🚀 ShipPHP Faster v2.1.0 ║ ║ ║ ╚════════════════════════════════════════════════════════════╝ STATUS Installation: ✓ Global Current Dir: ✓ Initialized QUICK START Check changes: shipphp status Deploy to server: shipphp push Download from server: shipphp pull Create backup: shipphp backup create COMMON COMMANDS shipphp status Check what changed shipphp push Deploy to server shipphp backup create Create backup shipphp profile list Manage profiles shipphp health Check server health NEED HELP? Full command list: shipphp help Documentation: https://github.com/ssanaullahrais/ShipPHP-Faster ``` #### Auto-Update Notifications [](#auto-update-notifications) ShipPHP automatically checks for new releases and notifies you when updates are available. ``` shipphp --version ✓ ShipPHP Faster v2.1.0 ``` #### Git-like Status Command [](#git-like-status-command) Clean, scannable output similar to `git status`: ``` shipphp status ╔════════════════════════════════════════════════════════════╗ ║ ShipPHP Status ║ ╚════════════════════════════════════════════════════════════╝ On branch: production Changes to push (local → server): M 3 modified M index.php M src/config.php M assets/style.css + 1 added + new-feature.php Changes to pull (server → local): ✓ No changes ──────────────────────────────────────────────────────────── Summary: 4 files to push 0 files to pull Next steps: Run 'shipphp push' to deploy local changes ``` Use `shipphp status --detailed` for full diagnostics! --- ### v2.0 - Global Installation & Profile Management [](#v20---global-installation--profile-management) ### Profile Management [](#profile-management) Manage multiple websites easily: ``` # List all profiles shipphp profile list # Add new profile shipphp profile add my-client-site # Show profile details shipphp profile show my-blog-prod # Set default profile shipphp profile use my-blog-prod # Remove profile shipphp profile remove old-project ``` ### Login Command [](#login-command) Connect any project to your saved profiles: ``` shipphp login # Shows profile table: ┌────┬──────────────────────┬─────────────────────┬──────────────────┐ │ ID │ Profile │ Project Name │ Domain │ ├────┼──────────────────────┼─────────────────────┼──────────────────┤ │ 1 │ myblog-com-a3f9 │ My Personal Blog │ myblog.com │ │ 2 │ client-com-x8k2 │ Client Website │ client.com │ └────┴──────────────────────┴─────────────────────┴──────────────────┘ Select profile (1-2): 1 ✓ Connected to: myblog-com-a3f9 ``` ### Beautiful Status Bar [](#beautiful-status-bar) Every command shows your connection status (like Claude Code!): ``` ╔════════════════════════════════════════════════════════════════════════════╗ ║ 🚀 My Personal Blog │ myblog.com │ myblog-com-a3f9 │ ●abc...xyz ║ ╚════════════════════════════════════════════════════════════════════════════╝ ``` ### Token Security Management [](#token-security-management) ``` # Show current authentication token shipphp token show # Rotate to new token (security best practice) shipphp token rotate ``` ### Server File Generation [](#server-file-generation) Generate server files without initializing a project: ``` # Perfect for freelancers managing multiple clients shipphp server generate client-staging # Creates: # - shipphp-server.php (ready to upload) # - Global profile (client-staging) ``` --- 📚 All Commands -------------- [](#-all-commands) ### Setup & Configuration [](#setup--configuration) ``` shipphp init # Initialize project (creates profile automatically) shipphp login # Connect project to a global profile shipphp bootstrap [path] # Create short command alias shipphp env [name] # Switch environments (staging/production) ``` > **Config directory:** New installs place ShipPHP config and state inside `shipphp-config/` (including `shipphp.json`, `.ignore`, `.shipphp/`, and `shipphp-server.php`) to keep project roots clean. Legacy installs that already use root-level `shipphp.json` remain supported. ### Deployment [](#deployment) ``` shipphp # Smart dashboard (quick start guide) shipphp status # Git-like status (clean output) shipphp status --detailed # Detailed status with diagnostics shipphp push [path] # Upload changed files to server shipphp pull [path] # Download changed files from server shipphp sync # Status + Push (with confirmation) shipphp push local.php --to=public/index.php # Upload a file to a specific server path shipphp pull public/index.php --to=local.php # Download a server file to a specific local path ``` ### Utilities [](#utilities) ``` shipphp tree [path] # Display a tree of server files shipphp delete # Delete a file or directory on the server shipphp extract # Extract a zip archive on the server shipphp extract --to=public/uploads # Extract to a target directory shipphp where # Show server base directory ``` > Note: `extract` currently supports `.zip` archives (via PHP's ZipArchive). ### Backup Management (Version-Tracked) [](#backup-management-version-tracked) ``` shipphp backup create # Create versioned local backup (v2.1.0, v2.0.1, etc.) shipphp backup create --server # Create and upload to server shipphp backup restore # Restore from local backup shipphp backup restore --server # Download and restore from server shipphp backup sync # Upload specific backup to server shipphp backup sync --all # Upload all backups to server shipphp backup pull # Download specific backup from server shipphp backup pull --all # Download all backups from server shipphp backup delete --local # Delete from local only shipphp backup delete --server # Delete from server only shipphp backup delete --both # Delete from both shipphp backup stats # Show backup comparison table shipphp backup # List all backups ``` ### Profile Management [](#profile-management-1) ``` shipphp profile list # List all global profiles shipphp profile add # Add new profile interactively shipphp profile show # Show profile details shipphp profile use # Set default profile shipphp profile remove # Remove profile shipphp server generate # Generate server file & create profile ``` ### Security [](#security) ``` shipphp token show # Show current authentication token shipphp token rotate # Generate new token (requires server upload) ``` ### Utilities [](#utilities-1) ``` shipphp help # Full command list shipphp --version # Check version (with update notifications) shipphp health # Check server health and diagnostics shipphp health --detailed # Detailed health report shipphp diff [file] # Show differences for specific file ``` --- 🎬 Real-World Workflows ---------------------- [](#-real-world-workflows) ### Freelancer with Multiple Clients [](#freelancer-with-multiple-clients) ``` # Install globally (see installation section above) # After global installation is complete: # Client 1 - Setup shipphp server generate client1-prod # Upload shipphp-server.php to client1.com # Client 2 - Setup shipphp server generate client2-staging # Upload shipphp-server.php to staging.client2.com # View all profiles shipphp profile list # Deploy to Client 1 cd /var/www/client1 shipphp login # Select client1-prod shipphp push # Deploy to Client 2 cd /var/www/client2 shipphp login # Select client2-staging shipphp push # Done! Easy switching between clients! ``` ### Team with Shared Server [](#team-with-shared-server) ``` # Developer A (setup) shipphp init # Creates profile: company-prod # Upload shipphp-server.php # Share token with team (via 1Password, etc.) # Developer B (join) shipphp profile add company-prod # Enter: URL and token from Developer A # Both can deploy cd /var/www/company-site shipphp login # Select company-prod shipphp push ``` ### Personal Projects [](#personal-projects) ``` # Project 1 cd /var/www/myblog shipphp init # Auto-creates profile shipphp login shipphp push # Project 2 cd /var/www/portfolio shipphp init # Auto-creates another profile shipphp login shipphp push # Profiles saved globally - easy to switch! ``` --- 🔒 Security Features ------------------- [](#-security-features) ### Token-Based Authentication [](#token-based-authentication) - **64-character tokens** (256-bit security) - **Timing-safe comparison** (prevents timing attacks) - **Token rotation** (regenerate anytime) - **Secure storage** (`chmod 600` on profile files) ### Path Protection [](#path-protection) - **Path traversal prevention** - **Cannot access files outside project directory** - **Validated with `realpath()`** ### Network Security [](#network-security) - **Optional IP whitelisting** (CIDR support) - **Rate limiting** (default: 120 req/min) - **Request logging** (audit trail) ### File Security [](#file-security) - **SHA256 hashing** (integrity verification) - **File size limits** (configurable) - **Proper permissions** (files: 0644, directories: 0755) --- 💾 Automatic Backup System ------------------------- [](#-automatic-backup-system) ### Version-Tracked Backups [](#version-tracked-backups) Every backup gets an automatic semantic version: ``` shipphp backup create # Creates: 2026-01-27-143022-v2.1.0 shipphp backup create # Creates: 2026-01-27-143155-v2.0.1 shipphp backup create # Creates: 2026-01-27-143301-v2.0.2 ``` ### Backup Features [](#backup-features) - **Automatic versioning** (v2.1.0, v2.0.1, v2.0.2...) - **Version history tracking** (`.versions.json`) - **Local & server sync** (upload/download backups) - **Respects .gitignore** (only backs up relevant files) - **Manifest system** (JSON metadata with file hashes) - **Easy restore** (one command to rollback) ### Backup Commands [](#backup-commands) ``` shipphp backup # List all backups with versions shipphp backup create # Create local v1.0.x backup shipphp backup create --server # Create and upload to server shipphp backup restore # Restore specific version shipphp backup sync --all # Upload all to server shipphp backup stats # Compare local vs server backups ``` --- ⚙️ Configuration ---------------- [](#️-configuration) ### shipphp.json (Local Project Config) [](#shipphpjson-local-project-config) ``` { "version": "2.1.0", "projectName": "My Blog", "profileId": "myblog-com-a3f9", "serverUrl": "https://myblog.com/shipphp-server.php", "token": "64-character-token-here", "backup": { "enabled": true, "beforePush": true, "keepLast": 10 }, "ignore": [ ".git", "node_modules", "*.log" ] } ``` ### ~/.shipphp/profiles.json (Global Profiles) [](#shipphpprofilesjson-global-profiles) ``` { "profiles": { "myblog-com-a3f9": { "projectName": "My Blog", "domain": "myblog.com", "serverUrl": "https://myblog.com/shipphp-server.php", "token": "64-character-token-here", "created": "2026-01-27 10:30:00" } }, "default": "myblog-com-a3f9" } ``` --- 🐛 Troubleshooting ----------------- [](#-troubleshooting) ### "Connection failed" [](#connection-failed) 1. Upload `shipphp-server.php` to your website 2. Check URL: `https://yoursite.com/shipphp-server.php` 3. Verify token matches in both files ### "Profile not found" [](#profile-not-found) ``` shipphp profile list # See all profiles shipphp init # Create new profile ``` ### "Not initialized" [](#not-initialized) ``` shipphp init # Initialize current directory # OR shipphp login # Link to existing profile ``` ### "Token mismatch" [](#token-mismatch) ``` shipphp token show # Check current token shipphp token rotate # Generate new token # Re-upload shipphp-server.php! ``` --- 📖 Documentation --------------- [](#-documentation) - **GitHub:** - **Issues:** Report bugs or request features - **Wiki:** Detailed guides and tutorials --- 🎉 Why ShipPHP Faster? --------------------- [](#-why-shipphp-faster) ### vs FTP [](#vs-ftp) - ✅ **Automatic change detection** (only uploads what changed) - ✅ **Version-tracked backups** (instant rollback) - ✅ **No accidental overwrites** (safe deployments) - ✅ **Beautiful CLI** (professional interface) ### vs Git Deploy [](#vs-git-deploy) - ✅ **Works on shared hosting** (no SSH required) - ✅ **No server setup** (just upload one PHP file) - ✅ **Automatic backups** (built-in safety) - ✅ **Beginner-friendly** (no Git knowledge needed) ### vs Other Tools [](#vs-other-tools) - ✅ **Global installation** (manage unlimited projects) - ✅ **Profile system** (easy multi-project switching) - ✅ **Token security** (enterprise-grade protection) - ✅ **Version tracking** (semantic backup versioning) --- 💡 Tips & Best Practices --------------------------- [](#-tips--best-practices) 1. **Always create backups** before major changes: ``` shipphp backup create --server shipphp push ``` 2. **Use profiles** for multi-project management: ``` shipphp profile list # See all projects shipphp login # Switch projects ``` 3. **Rotate tokens regularly** (security best practice): ``` shipphp token rotate # Upload new shipphp-server.php! ``` 4. **Test with dry-run** before deploying: ``` shipphp push --dry-run ``` 5. **Check status first**: ``` shipphp status # Clean git-like status shipphp push # Deploy changes ``` 6. **Stay updated**: ``` shipphp --version # Check for updates composer global update shipphp/faster ``` --- 🚀 Get Started Now! ------------------ [](#-get-started-now) ``` # 1. Download ShipPHP git clone https://github.com/ssanaullahrais/ShipPHP-Faster.git shipphp # 2. Put in your project OR install globally (see Installation section) cd /path/to/your/website # 3. Initialize php shipphp/shipphp.php init # 4. Upload shipphp-server.php to your server # 5. Deploy! php shipphp/shipphp.php login php shipphp/shipphp.php push ``` **Welcome to professional PHP deployment!** 🎉 --- 📄 License --------- [](#-license) MIT License - Free to use for personal and commercial projects! 🤝 Contributing -------------- [](#-contributing) Contributions welcome! Please open an issue or pull request on GitHub. ⭐ Support --------- [](#-support) If ShipPHP Faster helps you, please star the repository on GitHub! ### Health Score 35 — LowBetter than 80% of packages Maintenance80 Actively maintained with recent releases Popularity9 Limited adoption so far Community8 Small or concentrated contributor base Maturity37 Early-stage or recently created project Bus Factor1 Top contributor holds 97.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 ~1 days Total 4 Last Release 107d ago Major Versions v1.0.0 → v2.0.02026-01-27 ### Community Maintainers ![](https://www.gravatar.com/avatar/1792b0c08836a147b18764c3fd2cf7181282b2cbfdd97c2d4d39148a0ed62b1a?d=identicon)[sanaullahrais](/maintainers/sanaullahrais) --- Top Contributors [![ssanaullahrais](https://avatars.githubusercontent.com/u/32236227?v=4)](https://github.com/ssanaullahrais "ssanaullahrais (36 commits)")[![claude](https://avatars.githubusercontent.com/u/81847?v=4)](https://github.com/claude "claude (1 commits)") --- Tags ftpbackupuploadrestoredeploysyncdeploymentprofile-managementmulti-projectgit-deploymentphp-deployment ### Embed Badge ![Health badge](/badges/shipphp-faster/health.svg) ``` [![Health](https://phpackages.com/badges/shipphp-faster/health.svg)](https://phpackages.com/packages/shipphp-faster) ``` ### Alternatives [league/flysystem File storage abstraction for PHP 13.6k639.1M2.2k](/packages/league-flysystem)[vich/uploader-bundle Ease file uploads attached to entities 1.9k25.9M116](/packages/vich-uploader-bundle)[league/flysystem-ftp FTP filesystem adapter for Flysystem. 2820.8M101](/packages/league-flysystem-ftp)[innoge/laravel-rclone A sleek PHP wrapper around rclone with Laravel-style fluent API syntax 174.1k](/packages/innoge-laravel-rclone)[demi/dropbox-backup Yii2 console command for making site backups and upload it to your dropbox account 102.3k](/packages/demi-dropbox-backup)[marrouchi/upload-crop-image-bundle Basic server side cropping behavior for Symfony2 121.1k](/packages/marrouchi-upload-crop-image-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)