π What's New in v1.3.0
This release focuses on improving user experience with better diagnostics and comprehensive troubleshooting documentation.
β¨ New Features
WhereAmI Command
- π New
phat whereamicommand β Instantly locate your phat.bat and phat.ps1 installation paths - β Helpful for debugging PATH issues and verifying installation
- π Shows exactly where Phat is installed on your system
Comprehensive Troubleshooting Guides
- π Added extensive documentation for common issues:
- Apache won't start after PHP version switch
- Download failures during PHP installation
- Git Bash compatibility issues
- Permission denied errors
- PHP version not found errors
- PowerShell execution policy restrictions
- π― Centralized troubleshooting guide for quick problem resolution
- π‘ Step-by-step solutions with detailed explanations
π§ Improvements
Better User Support
- π Improved documentation structure with dedicated troubleshooting section
- π§ Enhanced error messages and diagnostic information
- π¨ Clearer command output and user guidance
π¦ Installation
MSI Installer (Recommended)
- Download
Phat.msifrom the assets below - Run the installer
- Open a new terminal and verify:
phat help
Manual Installation
git clone https://github.com/pphatdev/php-version-switcher.git
# Add the folder to your system PATH
phat helpπ Quick Start
# List all installed PHP versions
phat list
# Switch to a specific version
phat switch 8.3.30
# Install a new PHP version
phat install 8.4.0
# Find where Phat is installed (NEW!)
phat whereamiπ Requirements
- OS: Windows 10/11
- XAMPP: Installed at
C:\xampp - PowerShell: 5.1 or higher
- Permissions: Administrator rights for switching versions
π Known Issues
- Requires an elevated terminal (Run as Administrator) if permission errors occur during version switching
- Apache vhost warnings (e.g.
Could not resolve host name) are unrelated to PHP switching
For solutions to common issues, check out our Troubleshooting Guide
π Full Changelog
Full Changelog: v1.2.0...v1.3.0
New Contributors
Full Changelog: v1.2.0...v1.3-beta