Skip to content

πŸŽ‰ v1.3-beta

Latest

Choose a tag to compare

@L-Sophat L-Sophat released this 25 Feb 17:27
030959e

πŸŽ‰ 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 whereami command β€” 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)

  1. Download Phat.msi from the assets below
  2. Run the installer
  3. 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