Skip to content

πŸš€ One-click Laravel deployment scripts. Beautiful web interface for installation, updates & cache optimization. Production-ready & secure!

License

Notifications You must be signed in to change notification settings

isousluer/laravel-deployment-scripts

πŸš€ Laravel Deployment Scripts

License: MIT PHP Version Laravel PRs Welcome GitHub Stars

Ready-to-use scripts to deploy your Laravel projects fast, secure, and professionally!

✨ Features

  • 🎯 One-Click Setup - Get rid of complex commands
  • πŸ”’ Security-Focused - Single-run lock mechanism
  • 🎨 Professional Interface - Colorful HTML output
  • ⚑ Performance - 10-20x speed boost
  • πŸ› Error Handling - Detailed error reporting
  • πŸ“¦ Easy Maintenance - Single file, no dependencies

πŸ“¦ Scripts

Script Purpose Environment Documentation
install.php Initial setup (key, storage, migration) New Project πŸ“– Details
update.php Update + Migration Production Deploy πŸ“– Details
clear-cache.php Cache clearing Development πŸ“– Details
refresh-cache.php Cache refresh Production πŸ“– Details

πŸš€ Quick Start

1. Initial Installation

# 1. Download the script
wget https://raw.githubusercontent.com/isousluer/laravel-deployment-scripts/main/scripts/install.php

# 2. Move to public/ directory
mv install.php public/

# 3. Run from browser
https://yourdomain.com/install.php

# 4. Delete the file
rm public/install.php

2. Production Update

# After code update
wget https://raw.githubusercontent.com/isousluer/laravel-deployment-scripts/main/scripts/update.php
mv update.php public/
https://yourdomain.com/update.php
rm public/update.php

3. Cache Refresh

# For performance optimization
wget https://raw.githubusercontent.com/isousluer/laravel-deployment-scripts/main/scripts/refresh-cache.php
mv refresh-cache.php public/
https://yourdomain.com/refresh-cache.php
rm public/refresh-cache.php

πŸ“– Detailed Documentation

🎯 Usage Scenarios

Scenario 1: New Project Setup

1. Git clone
2. composer install
3. .env configuration
4. Run install.php  ← This script!

Scenario 2: Production Deploy

1. git pull
2. composer install --no-dev
3. Run update.php  ← This script!

Scenario 3: Cache Issues

1. Changed config but not working?
2. Run refresh-cache.php  ← This script!

πŸ”’ Security

⚠️ IMPORTANT WARNINGS:

  • βœ… Scripts run only once (install.lock mechanism)
  • βœ… Delete after use
  • βœ… Add to .gitignore
  • ❌ Don't leave in production
  • ❌ Contains no sensitive data

Add to .gitignore

# Deployment Scripts
public/install.php
public/update.php
public/clear-cache.php
public/refresh-cache.php
public/install.lock

πŸ“Š Performance Comparison

Status Response Time Cache
❌ No Cache 150-200ms None
βœ… With Cache 10-20ms Active
Difference 10-20x Faster refresh-cache.php

πŸ› οΈ Requirements

  • PHP 8.0 or higher
  • Laravel 9.0 or higher
  • Composer dependencies installed
  • Active database connection
  • Web server (Apache/Nginx)

πŸ’‘ Best Practices

Development Environment

# Disable cache
CACHE_DRIVER=array
VIEW_COMPILED_PATH=false

# Clear when needed
clear-cache.php

Production Environment

# Deploy workflow
1. php artisan down
2. git pull
3. composer install --no-dev --optimize-autoloader
4. update.php or refresh-cache.php
5. php artisan queue:restart
6. php artisan up

🀝 Contributing

We welcome your contributions! Please read CONTRIBUTING.md.

Contribution Process

  1. 🍴 Fork it
  2. 🌱 Create feature branch (git checkout -b feature/amazing)
  3. πŸ’Ύ Commit changes (git commit -m 'Add amazing feature')
  4. πŸ“€ Push to branch (git push origin feature/amazing)
  5. πŸŽ‰ Open Pull Request

πŸ› Report Issues

Found a bug? Open an issue!

Issue Templates

πŸ“ Changelog

All notable changes are documented in CHANGELOG.md.

πŸ“„ License

This project is licensed under the MIT License.

🌟 Star History

Star History Chart

πŸ’– Thanks

Thanks to everyone who starred, forked, and contributed to this project!

πŸ”— Links

πŸ“§ Contact

Have questions? Send an email


Made with ❀️ by İsmail Usluer

Back to Top ⬆️

About

πŸš€ One-click Laravel deployment scripts. Beautiful web interface for installation, updates & cache optimization. Production-ready & secure!

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages