Skip to content
This repository was archived by the owner on Aug 17, 2025. It is now read-only.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PHDeploy Hero Banner

🚀 PHDeploy: Deploy PHP Instantly to Vercel & Render 🚀

The EASIEST way to launch PHP projects to the cloud — no config headaches, just click and go!

Stars Vercel Render PHP


🎉 What is PHDeploy?

PHDeploy is your all-in-one solution to deploy PHP sites instantly to Vercel and Render — even if they only officially support Node.js!
It handles the quirks for you:

  • Vercel: Deploy PHP using serverless /api endpoints and a simple config file.
  • Render: Use a ready-to-go Dockerfile for full PHP stack deployments.

No more fighting with settings or manual uploads!
Just fork, upload your files, connect your repo, and watch your PHP app go live.


🦄 Features

  • One Click Deploy: Vercel & Render support out of the box.
  • 🐘 Modern PHP: Uses PHP 8.2+ for maximum compatibility.
  • 🗂️ /api Power: For Vercel, just drop your PHP files into /api!
  • 🐳 Dockerfile for Render: Zero config needed — works instantly.
  • 📦 Web-based Archive Manager: Upload, unzip, and zip files right in your browser.
  • 📊 Resource Monitor: See RAM/Disk usage with a pretty UI.
  • 🔒 Self-contained: No external dependencies.
  • 💛 Open Source & Free: MIT Licensed.

🚀 Quick Start

🌩️ Deploy to Vercel

  1. Fork this repo
    Click the ⭐️ Star button, then click Fork at the top right.
    (You need your own copy to deploy and upload your PHP files!)

  2. Add your PHP files

    • Upload your site’s PHP files to the /api directory of your forked repo.
    • Any .php file in /api instantly becomes a public serverless endpoint.
    • Want a home page? Add /api/index.php.
  3. Push your changes

    • Commit and push your changes to your GitHub fork.
  4. Deploy to Vercel

    • Go to Vercel.
    • Import your forked repo, NOT the original!
    • Or use the button below (replace the repo URL with your fork if prompted):

    Deploy to Vercel

  5. Done!

    • Vercel will build and deploy your PHP endpoints — get your live URL instantly.
    • Access endpoints at https://your-vercel-url.vercel.app/api/yourfile.php.

⚠️ Vercel Limitations & Power

Vercel uses a serverless architecture for PHP (and all other backends except Node.js):

  • Each /api/*.php file is run in a stateless, short-lived serverless function.
  • No persistent file storage: You can't write to disk or keep files between requests (uploads, zip, etc. won't persist).
  • Limited execution time: Functions will be killed after a certain time (10s for Hobby, 60s for Pro).
  • Limited memory/CPU: For heavy-duty PHP or long-running scripts, use Render!
  • No background jobs, sockets, or cron jobs.
  • Cold Starts: First request may be slower after inactivity.

Vercel is perfect for:

  • Simple APIs, forms, contact pages, webhooks, and light websites.
  • Demos, prototypes, and instant deployments with almost zero config.

Not good for:

  • Apps needing file uploads, persistent storage, long scripts, or background processing.

🐳 Deploy to Render

💡 The easiest: 1-Click Deploy!

Deploy to Render

OR deploy manually:

  1. Fork this repo

    • Click Fork above and make your own copy.
  2. Upload your PHP files

    • Place your site files in your fork (root or any directory you like).
  3. Push to GitHub

    • Commit and push your changes.
  4. Go to Render

    • Click "New Web Service", connect your forked repo.
  5. 1-Click Deploy

    • Or use the button above for instant setup!
  6. Done!

    • Render detects the included Dockerfile and sets up PHP Apache for you.
    • Your PHP site is now live, with full file system and persistent storage.

Render is better for:

  • Full-featured traditional PHP apps (WordPress, Laravel, file uploads, etc.)
  • Apps needing persistent storage, background jobs, or cron.
  • Custom PHP extensions, Composer, or anything you’d do on a VPS.

🧰 Built-in Tools

📦 Archive Unzipper/Zipper (/api/uz.php)

Upload .zip, .rar, .gz files and extract them, or zip up folders for download — right from your browser!
Perfect for importing/exporting site contents or assets instantly.


📊 System Resource Monitor (/api/index.php or /index.php)

Get real-time RAM and disk stats in a clean dashboard.
Great for checking your Render server health!


📂 Project Structure

/
├── /api/           # PHP endpoints for Vercel (put your PHP scripts here)
│   ├── uz.php      # Archive upload/unzip/zip tool
│   └── index.php   # System resource monitor
├── Dockerfile      # Magic for Render.com deployment
├── vercel.json     # Vercel config (if needed)
└── ...

🛠️ Customizing

  • PHP Version: Edit the Dockerfile if you need another PHP version.
  • Vercel Routes: Tweak vercel.json for custom routing or rewrites.
  • More Tools: Add your own PHP scripts into /api — they become endpoints!

❤️ Why PHDeploy?

  • No other repo makes deploying a PHP site to Vercel or Render this easy.
  • No more uploading/extracting files by hand — use the built-in web tools!
  • Zero lock-in, zero cost, zero learning curve.

🌟 Show Some Love!

If you found this helpful, please star this repo!
It helps others discover PHDeploy and motivates future updates.


⭐ Star on GitHub ⭐


🤝 Contributing

PRs, issues, and feedback are welcome! Open an issue or submit a pull request.


📜 License

MIT


FAQ

Q: Can I use this for any PHP project?
A: Yes! Just copy your PHP scripts into /api for Vercel, or anywhere for Render.

Q: Does it support Composer or frameworks?
A: For complex setups, use the Dockerfile and deploy to Render for best results.

Q: Is it secure?
A: This is a starter/project template. Secure your endpoints before going to production.

Q: How do I upload files on Vercel?
A: Vercel doesn’t support persistent file storage. Use Render for file uploads or anything that needs to save files.

Q: Can I use PHP sessions or cookies?
A: Yes, but remember: serverless functions on Vercel are stateless. Store session data externally if you need persistence.

Q: Can I use a database?
A: Yes! Both Vercel and Render work great with remote DBs like MySQL, PostgreSQL, or SQLite (on Render).

Q: How do I add more endpoints?
A: Just add more .php files to /api (for Vercel) or anywhere (for Render). That’s it!

Q: How do I update my site?
A: Just push new commits to your fork on GitHub — Vercel/Render will rebuild and redeploy automatically!


Made with 💜 by maruf009sultan

About

PHDeploy streamlines PHP application deployment with automated scripts and easy configuration. Effortlessly manage your PHP deployments for faster, reliable releases.

Topics

Resources

Stars

21 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages