PHPackages anandpilania/upgrader - 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. anandpilania/upgrader ActiveLibrary anandpilania/upgrader ===================== Modular upgrade tool for Laravel, PHP, React, Vue, Tailwind, TypeScript, and JavaScript v0.0.2(2d ago)00MITPHPPHP ^8.2 Since Apr 6Pushed 2d agoCompare [ Source](https://github.com/AnandPilania/upgrader)[ Packagist](https://packagist.org/packages/anandpilania/upgrader)[ RSS](/packages/anandpilania-upgrader/feed)WikiDiscussions main Synced today READMEChangelogDependencies (6)Versions (3)Used By (0) Modular Upgrader ================ [](#modular-upgrader) πŸŽ‰ Now with Laravel 13 Support! ------------------------------ [](#-now-with-laravel-13-support) A comprehensive, modular upgrade tool for modern web development stacks. Automatically upgrade PHP, Laravel, React, Vue, Tailwind CSS, TypeScript, and JavaScript with intelligent dependency management. 🎯 Key Features -------------- [](#-key-features) - **Modular Architecture** - Each technology is an independent, pluggable module - **Intelligent Dependencies** - Modules automatically upgrade their dependencies - **Multi-Framework Support** - Works with Laravel, React, Vue, and more - **Language Awareness** - Handles JavaScript ↔ TypeScript transitions seamlessly - **Auto-Detection** - Automatically detects applicable modules in your project - **Version-by-Version** - Incremental upgrades for safety - **Dry Run Mode** - Preview changes before applying πŸ“¦ Available Modules ------------------- [](#-available-modules) ModuleDescriptionDependencies`php`PHP version upgradesNone`javascript`JavaScript/ES version upgradesNone`typescript`TypeScript upgrades`javascript``laravel`Laravel framework upgrades`php``reactjs`React.js upgrades`javascript` OR `typescript``vuejs`Vue.js upgrades`javascript` OR `typescript``tailwindcss`Tailwind CSS upgradesNoneπŸ”„ Dependency Flow ----------------- [](#-dependency-flow) ``` Laravel Module └─ depends on β†’ PHP Module React Module └─ depends on β†’ JavaScript Module OR TypeScript Module └─ depends on β†’ JavaScript Module Vue Module └─ depends on β†’ JavaScript Module OR TypeScript Module └─ depends on β†’ JavaScript Module TypeScript Module └─ depends on β†’ JavaScript Module ``` πŸš€ Installation -------------- [](#-installation) ``` composer require --dev anandpilania/upgrader ``` Or install globally: ``` composer global require anandpilania/upgrader ``` πŸ“˜ Usage ------- [](#-usage) ### List Available Modules [](#list-available-modules) ``` bin/upgrader modules ``` Output: ``` β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ Module β”‚ Version β”‚ Description β”‚ Dependencies β”‚ Supported β”‚ β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€ β”‚ php β”‚ 1.0.0 β”‚ PHP upgrade module β”‚ None β”‚ 7.4, 8.0, 8.1..β”‚ β”‚ laravel β”‚ 1.0.0 β”‚ Laravel upgrades β”‚ php β”‚ 8.0, 9.0, 10.0..β”‚ β”‚ reactjs β”‚ 1.0.0 β”‚ React.js upgrades β”‚ None β”‚ 16.0, 17.0, 18.0β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ ``` ### Auto-Detect Project Modules [](#auto-detect-project-modules) ``` bin/upgrader detect ``` Output: ``` Detected Modules β”œβ”€ laravel (v9.0 β†’ v11.0 available) β”œβ”€ php (v8.0 β†’ v8.2 available) β”œβ”€ reactjs (v17.0 β†’ v18.0 available) └─ typescript (v4.5 β†’ v5.0 available) ``` ### Analyze Upgrade Path [](#analyze-upgrade-path) ``` # Analyze specific module bin/upgrader analyze --module=laravel --target=11.0 # Analyze all detected modules bin/upgrader analyze ``` ### Upgrade a Module [](#upgrade-a-module) ``` # Basic upgrade bin/upgrader upgrade --module=laravel --from=9.0 --to=11.0 # Auto-detect current version bin/upgrader upgrade --module=laravel --to=11.0 # Upgrade with dependencies (e.g., PHP will be upgraded first) bin/upgrader upgrade --module=laravel --to=11.0 --with-dependencies # Dry run (preview changes) bin/upgrader upgrade --module=laravel --to=11.0 --dry-run ``` 🎯 Real-World Examples --------------------- [](#-real-world-examples) ### Example 1: Upgrade Laravel (with PHP) [](#example-1-upgrade-laravel-with-php) ``` # Laravel module depends on PHP module # When you upgrade Laravel, it will automatically upgrade PHP if needed bin/upgrader upgrade --module=laravel --from=9.0 --to=11.0 --with-dependencies ``` **What happens:** 1. Detects Laravel 9 requires PHP 8.0 2. Detects Laravel 11 requires PHP 8.2 3. **Automatically upgrades PHP 8.0 β†’ 8.2 first** 4. Then upgrades Laravel 9.0 β†’ 10.0 β†’ 11.0 ### Example 2: Upgrade React with TypeScript [](#example-2-upgrade-react-with-typescript) ``` # If your React project uses TypeScript, both will be upgraded bin/upgrader upgrade --module=reactjs --from=17.0 --to=18.0 --with-dependencies ``` **What happens:** 1. Detects React uses TypeScript 2. Detects React 18 needs TypeScript 4.5+ 3. **Automatically upgrades TypeScript if needed** 4. TypeScript upgrade triggers **JavaScript target upgrade** 5. Then upgrades React 17.0 β†’ 18.0 ### Example 3: Full Stack Upgrade [](#example-3-full-stack-upgrade) ``` # Detect everything bin/upgrader detect # Upgrade each module bin/upgrader upgrade --module=php --to=8.2 bin/upgrader upgrade --module=laravel --to=11.0 --with-dependencies bin/upgrader upgrade --module=tailwindcss --to=3.4 bin/upgrader upgrade --module=vuejs --to=3.4 --with-dependencies ``` βš™οΈ Configuration ---------------- [](#️-configuration) Create `.upgrader.yml` in your project root: ``` modules: laravel: update_frontend: true run_tests: true backup_database: true reactjs: migrate_to_hooks: true enable_strict_mode: true typescript: strict_mode: true update_types: true tailwindcss: enable_jit: true update_plugins: true ``` Then run: ``` bin/upgrader upgrade --module=laravel --config=.upgrader.yml ``` **What happens automatically:** ``` Step 1: Dependency Check βœ“ Laravel 13 requires PHP 8.3 βœ“ Current PHP: 8.2 βœ“ Upgrading PHP 8.2 β†’ 8.3 first Step 2: PHP Upgrade βœ“ Applied PHP 8.3 transformers βœ“ Updated composer.json PHP requirement Step 3: Laravel Upgrade βœ“ Updated composer.json Laravel version βœ“ Applied CSRF middleware transformer (VerifyCsrfToken β†’ PreventRequestForgery) - Updated 12 files βœ“ Applied cache config transformer - Added serializable_classes configuration βœ“ Applied polymorphic pivot transformer - Found 3 pivot models - Generated warnings for manual review Step 4: Frontend Detection βœ“ Detected Vue.js 3.2 βœ“ Vue uses TypeScript βœ“ Frontend upgrades available (not applied without --with-dependencies) Summary: βœ“ PHP 8.2 β†’ 8.3 βœ“ Laravel 12.0 β†’ 13.0 βœ“ 15 files modified ⚠ 5 manual steps required Manual Steps: 1. Review config/cache.php - add whitelisted classes if caching objects 2. Check .env for CACHE_PREFIX and SESSION_COOKIE 3. Update JobAttempted event listeners ($exception instead of $exceptionOccurred) 4. Review 3 pivot models - add explicit $table if needed 5. Run: php artisan test ``` πŸ—οΈ Architecture --------------- [](#️-architecture) ### How Modules Work [](#how-modules-work) Each module is self-contained and implements the `UpgradeModuleInterface`: ``` interface UpgradeModuleInterface { // Detect if this module applies to the project public function canHandle(string $projectPath): bool; // Detect current version public function detectCurrentVersion(string $projectPath): ?string; // Analyze upgrade compatibility public function analyze(string $projectPath, string $targetVersion): array; // Perform the upgrade public function upgrade(string $from, string $to): array; // Declare dependencies on other modules public function getDependencies(): array; } ``` ### Dependency Resolution [](#dependency-resolution) The `ModuleRegistry` automatically resolves and initializes dependencies: ``` $registry = new ModuleRegistry(); $registry->register(new PHPModule()); $registry->register(new LaravelModule()); // depends on PHP // When you upgrade Laravel, PHP is automatically checked and upgraded if needed ``` ### Module Communication [](#module-communication) Modules can access their dependencies: ``` class LaravelModule extends AbstractModule { protected array $dependencies = ['php']; public function upgrade($from, $to): array { // Get PHP module instance $phpModule = $this->getDependency('php'); // Check if PHP upgrade is needed $requiredPhpVersion = $this->getRequiredPhpVersion($to); if ($phpModule) { $phpModule->upgrade($current, $requiredPhpVersion); } // Continue with Laravel upgrade... } } ``` πŸ”Œ Creating Custom Modules ------------------------- [](#-creating-custom-modules) Create your own upgrade module: ``` namespace App\Upgraders; use Upgrader\Core\AbstractModule; class CustomFrameworkModule extends AbstractModule { protected array $dependencies = ['php', 'javascript']; public function getName(): string { return 'my-framework'; } public function canHandle(string $projectPath): bool { return file_exists($projectPath . '/my-framework.json'); } public function detectCurrentVersion(string $projectPath): ?string { // Detection logic } public function getAvailableVersions(): array { return ['1.0', '2.0', '3.0']; } public function upgrade(string $from, string $to): array { // Upgrade logic } } ``` Register your module: ``` $loader = new ModuleLoader(); $registry = $loader->loadAllModules(); $registry->register(new CustomFrameworkModule()); ``` πŸ“Š Module Details ---------------- [](#-module-details) ### PHP Module [](#php-module) Upgrades: `7.4`, `8.0`, `8.1`, `8.2`, `8.3`, `8.4` **Features:** - Named arguments support - Union types migration - Attributes transformation - Enum support - Readonly properties ``` bin/upgrader upgrade --module=php --from=8.0 --to=8.2 ``` ### Laravel Module [](#laravel-module) Upgrades: `8.0`, `9.0`, `10.0`, `11.0`, `12.0`, `13.0` **Dependencies:** PHP **Features:** - Route namespace removal (9.0) - Flysystem 3.x migration (9.0) - Native type declarations (10.0) - Application structure updates (11.0) - Request forgery protection updates (13.0) - Cache serialization security (13.0) - **Auto-detects and upgrades frontend framework (React/Vue)** ``` bin/upgrader upgrade --module=laravel --to=13.0 --with-dependencies ``` ### React Module [](#react-module) Upgrades: `16.0`, `16.8`, `17.0`, `18.0`, `19.0` **Dependencies:** JavaScript OR TypeScript (auto-detected) **Features:** - Hooks migration (16.8) - JSX transform update (17.0) - Concurrent features (18.0) - **Auto-detects TypeScript and upgrades if present** ``` bin/upgrader upgrade --module=reactjs --to=18.0 --with-dependencies ``` ### Vue Module [](#vue-module) Upgrades: `2.6`, `2.7`, `3.0`, `3.1`, `3.2`, `3.3`, `3.4` **Dependencies:** JavaScript OR TypeScript (auto-detected) **Features:** - Composition API migration - Script setup transformation - Global API updates (3.0) - **Auto-detects TypeScript and upgrades if present** ``` bin/upgrader upgrade --module=vuejs --to=3.4 --with-dependencies ``` ### TypeScript Module [](#typescript-module) Upgrades: `4.0` β†’ `5.4` **Dependencies:** JavaScript **Features:** - Decorators support - Const type parameters - **Automatically upgrades JavaScript target (ES2020, ES2022, etc.)** ``` bin/upgrader upgrade --module=typescript --to=5.0 --with-dependencies ``` ### Tailwind CSS Module [](#tailwind-css-module) Upgrades: `2.0` β†’ `3.4` **No Dependencies** **Features:** - JIT mode enablement - Color palette updates - Purge β†’ Content migration - Deprecated class updates ``` bin/upgrader upgrade --module=tailwindcss --to=3.4 ``` πŸ§ͺ Testing --------- [](#-testing) ``` # Run all tests composer test # Test specific module composer test -- --filter=LaravelModuleTest ``` 🀝 Contributing -------------- [](#-contributing) 1. Fork the repository 2. Create your module in `modules/your-module/` 3. Implement `UpgradeModuleInterface` 4. Add tests 5. Submit pull request πŸ“ License --------- [](#-license) MIT License πŸ™ Credits --------- [](#-credits) Built with ❀️ for the web development community. --- **Made modular, made simple.** **Ready to upgrade to Laravel 13? Download and start upgrading!** ### Health Score 37 β€” LowBetter than 82% of packages Maintenance99 Actively maintained with recent releases Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity37 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. ### Release Activity Cadence Every ~0 days Total 2 Last Release 2d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/b1209e551536746ac78a8a4b7f5a2cc13f776629484c441edc5d3f1a50edbea0?d=identicon)[AnandPilania](/maintainers/AnandPilania) --- Top Contributors [![NIIT-Anand](https://avatars.githubusercontent.com/u/108176339?v=4)](https://github.com/NIIT-Anand "NIIT-Anand (2 commits)") --- Tags composer-packagedeveloper-toolframework-agnosticjavascriptlaravelmodularphpreactjstailwindcsstypescriptupgrade-toolupgradervuejs ### Embed Badge ![Health badge](/badges/anandpilania-upgrader/health.svg) ``` [![Health](https://phpackages.com/badges/anandpilania-upgrader/health.svg)](https://phpackages.com/packages/anandpilania-upgrader) ``` ### Alternatives [laravel/framework The Laravel Framework. 34.6k509.9M16.8k](/packages/laravel-framework)[sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.4k5.6M643](/packages/sylius-sylius)[shopware/platform The Shopware e-commerce core 3.3k1.5M3](/packages/shopware-platform)[drupal/core Drupal is an open source content management platform powering millions of websites and applications. 19462.3M1.3k](/packages/drupal-core)[silverstripe/framework The SilverStripe framework 7213.5M2.5k](/packages/silverstripe-framework)[prestashop/prestashop PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers. 9.0k15.4k](/packages/prestashop-prestashop) PHPackages Β© 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)