PHPackages mohammadsafiabdullah/laravel-env-switcher - 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. [Utility & Helpers](/categories/utility) 4. / 5. mohammadsafiabdullah/laravel-env-switcher ActiveLibrary[Utility & Helpers](/categories/utility) mohammadsafiabdullah/laravel-env-switcher ========================================= Safely switch Laravel asset folders between local (public/) and shared-hosting (root) layouts. 00PHP Since Jun 18Pushed yesterdayCompare [ Source](https://github.com/safi-abd/laravel-env-switcher)[ Packagist](https://packagist.org/packages/mohammadsafiabdullah/laravel-env-switcher)[ RSS](/packages/mohammadsafiabdullah-laravel-env-switcher/feed)WikiDiscussions main Synced today READMEChangelogDependenciesVersions (1)Used By (0) laravel-env-switcher ==================== [](#laravel-env-switcher) A Laravel Artisan package for developers who deploy to **shared hosting** (Hostinger, Namecheap, cPanel, etc.) where the web root is the project root — not `public/`. On shared hosting you can't point the domain to `/public`, so everything inside `public/` — `index.php`, `.htaccess`, assets, everything — needs to live at the **project root** instead. This package moves all `public/` contents back and forth safely, including automatically patching `index.php` paths. --- The Problem ----------- [](#the-problem) ``` Local dev Shared hosting ─────────── ─────────────── project/ project/ ├── public/ ├── index.php ← moved from public/ │ ├── index.php ├── .htaccess │ ├── .htaccess ├── favicon.ico │ ├── favicon.ico ├── build/ │ ├── build/ ├── css/ │ └── css/ ├── public/ ← empty └── ... └── ... ``` You don't want to manually move files and patch paths every time you switch environments. This package automates that — with backups, rollback, and conflict detection. --- Installation ------------ [](#installation) ``` composer require mohammadsafiabdullah/laravel-env-switcher ``` Auto-discovery registers the service provider. No config file needed. --- Commands -------- [](#commands) CommandWhat it does`php artisan env:status`Show current mode and what's in public/ vs root`php artisan env:productionise`Move all `public/` contents → project root (for shared hosting)`php artisan env:localise`Move everything back → `public/` (for local dev)`php artisan env:backup --type=pre-deploy`Create a named backup snapshot`php artisan env:reset --to=previous`Restore from a backup### Options [](#options) ``` php artisan env:productionise --force # skip the confirmation prompt php artisan env:localise --force php artisan env:reset --to=original # restore the very first backup ever taken php artisan env:reset --to=pre-deploy # restore any named backup ``` --- Typical workflow ---------------- [](#typical-workflow) ### 1. Check current state [](#1-check-current-state) ``` php artisan env:status ``` ### 2. Before pushing to shared hosting [](#2-before-pushing-to-shared-hosting) ``` php artisan env:productionise git add -A && git push ``` ### 3. Back to local dev after pulling [](#3-back-to-local-dev-after-pulling) ``` php artisan env:localise ``` ### 4. Something went wrong — roll back [](#4-something-went-wrong--roll-back) ``` php artisan env:reset --to=previous # or go all the way back to the original: php artisan env:reset --to=original ``` --- What gets moved --------------- [](#what-gets-moved) **Everything** inside `public/` is moved to the project root, including: - `index.php` (paths are automatically patched — `__DIR__.'/../'` becomes `__DIR__.'/'`) - `.htaccess` - `favicon.ico`, `robots.txt` - `build/`, `css/`, `js/`, `images/` — any asset folders - Any other files or directories you've added **Skipped automatically:** - Symlinks (e.g. `storage/` → `../storage/app/public`) - `.gitignore` --- How mode is detected -------------------- [](#how-mode-is-detected) The package uses a state file (`.env-switcher.json`) to track the current mode and which items were moved. If no state file exists, it falls back to checking where `index.php` lives. StateCondition`local``public/index.php` exists (standard Laravel)`production``index.php` at project root (moved from public/)`conflict``index.php` found in BOTH locations`unknown``index.php` not found anywhere--- Backups ------- [](#backups) Every switch command automatically creates a `previous` backup before making any changes. The very first switch also saves an `original` backup. You can create additional named backups at any time: ``` php artisan env:backup --type=pre-deploy ``` Backups are stored in `.env-switcher-backups/` at the project root. Add this to `.gitignore`. --- Safety ------ [](#safety) - **Pre-flight collision check** — before moving any files, the package checks for collisions at the destination. If a file already exists, the operation is aborted before touching anything. - **Per-item rollback** — if a move fails mid-way, already-moved items are moved back automatically. - **Automatic path patching** — `index.php` relative paths are updated so the app works in both locations. - **State tracking** — `.env-switcher.json` records exactly which items were moved, so `localise` knows what to move back. - **Atomic reset** — `env:reset` copies the backup to a temp location first, then verifies it before wiping the current state. Your backup is never at risk. - **Conflict detection** — if `index.php` ends up in both locations, the package detects this and refuses to switch until you resolve it. --- Add to `.gitignore` ------------------- [](#add-to-gitignore) ``` .env-switcher-backups/ .env-switcher-tmp-restore-* ``` --- Requirements ------------ [](#requirements) - PHP 8.1+ - Laravel 10, 11, 12, or 13 --- License ------- [](#license) MIT © M Safi Abdullah ### Health Score 20 — LowBetter than 13% of packages Maintenance65 Regular maintenance activity Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity11 Early-stage or recently created project Bus Factor1 Top contributor holds 100% 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. ### Community Maintainers ![](https://www.gravatar.com/avatar/5db5dfe856133364cf3abe0119cf594c1d4a7eff38da5d0359461a20693e0334?d=identicon)[safi-abd](/maintainers/safi-abd) --- Top Contributors [![safi-abd](https://avatars.githubusercontent.com/u/159546307?v=4)](https://github.com/safi-abd "safi-abd (9 commits)") ### Embed Badge ![Health badge](/badges/mohammadsafiabdullah-laravel-env-switcher/health.svg) ``` [![Health](https://phpackages.com/badges/mohammadsafiabdullah-laravel-env-switcher/health.svg)](https://phpackages.com/packages/mohammadsafiabdullah-laravel-env-switcher) ``` ### Alternatives [mbezhanov/faker-provider-collection A collection of custom providers for the Faker library 2139.1M25](/packages/mbezhanov-faker-provider-collection)[wiebenieuwenhuis/filament-char-counter Count the amount of characters in a field 278.6k](/packages/wiebenieuwenhuis-filament-char-counter) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)