PHPackages saficodes/laravel-hostkit - 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. [DevOps & Deployment](/categories/devops) 4. / 5. saficodes/laravel-hostkit ActiveLibrary[DevOps & Deployment](/categories/devops) saficodes/laravel-hostkit ========================= Safely switch Laravel asset folders between local (public/) and shared-hosting (root) layouts. v2.0.0(today)20MITPHPPHP ^8.1 Since Jun 18Pushed todayCompare [ Source](https://github.com/safi-abd/laravel-env-switcher)[ Packagist](https://packagist.org/packages/saficodes/laravel-hostkit)[ RSS](/packages/saficodes-laravel-hostkit/feed)WikiDiscussions main Synced today READMEChangelogDependencies (3)Versions (7)Used By (0) laravel-hostkit =============== [](#laravel-hostkit) 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 and securing sensitive files via `.htaccess`. --- The Problem ----------- [](#the-problem) ``` Local dev Shared hosting ─────────── ─────────────── project/ project/ ├── public/ ├── index.php ← moved from public/ │ ├── index.php ├── .htaccess ← security rules added │ ├── .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, conflict detection, and automatic `.htaccess` security. --- Installation ------------ [](#installation) ``` composer require saficodes/laravel-hostkit ``` 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` (security rules are automatically added to block sensitive files) - `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` --- Security -------- [](#security) When you run `env:productionise`, the package automatically adds rules to `.htaccess` that block web access to sensitive files and directories: **Blocked files:** `.env`, `artisan`, `composer.json`, `composer.lock`, `package.json`, `phpunit.xml`, `vite.config.js/ts` **Blocked directories:** `app/`, `bootstrap/`, `config/`, `database/`, `lang/`, `resources/`, `routes/`, `storage/`, `tests/`, `vendor/` These rules are automatically removed when you run `env:localise`. --- How mode is detected -------------------- [](#how-mode-is-detected) The package uses a state file (`.hostkit.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 `.hostkit-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. - **Automatic `.htaccess` security** — sensitive files and directories are blocked from web access in production mode. - **State tracking** — `.hostkit.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) ``` .hostkit-backups/ .hostkit-tmp-restore-* ``` --- Requirements ------------ [](#requirements) - PHP 8.1+ - Laravel 10, 11, 12, or 13 --- License ------- [](#license) MIT © M Safi Abdullah ### Health Score 41 — FairBetter than 87% of packages Maintenance100 Actively maintained with recent releases Popularity3 Limited adoption so far Community6 Small or concentrated contributor base Maturity46 Maturing project, gaining track record 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. ### Release Activity Cadence Every ~0 days Total 6 Last Release 0d ago Major Versions v1.2.0 → v2.0.02026-06-19 ### 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 (13 commits)") --- Tags laravelenvironmentassetsdeploymentshared hosting ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/saficodes-laravel-hostkit/health.svg) ``` [![Health](https://phpackages.com/badges/saficodes-laravel-hostkit/health.svg)](https://phpackages.com/packages/saficodes-laravel-hostkit) ``` ### Alternatives [timokoerber/laravel-one-time-operations Run operations once after deployment - just like you do it with migrations! 6522.0M15](/packages/timokoerber-laravel-one-time-operations)[spatie/laravel-prometheus Export Laravel metrics to Prometheus 2821.5M8](/packages/spatie-laravel-prometheus) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)