[pxp] - Personal Xampp PHP version switcher for CLI
[pxp] Personal Xampp PHP version switcher for CLI. A simple yet powerful CLI tool to manage multiple PHP versions in XAMPP on Windows.
Features
- ๐ Switch between PHP versions instantly
- ๐ฆ Download and install new PHP versions automatically
- ๐๏ธ Uninstall PHP versions safely
- ๐ List all installed PHP versions (local)
- ๐ Fetch available stable PHP versions from PHP.net (global)
- โก Automatic Apache configuration updates
- ๐ก๏ธ Safe backups before switching
Setup
Option 1: Install from MSI (Recommended)
Download the latest MSI installer from Releases and run it. The installer will automatically add pxp to your PATH.
Option 2: Manual Installation
- Clone or download from GitHub:
git clone https://github.com/pphatdev/php-version-switcher.git
- Add the folder to your system PATH:
Settings โ System โ About โ Advanced system settings โ Environment Variables โ Path โ New
Add the full path to where you cloned/extracted the files.
- Open a new terminal and run:
pxp help
Note: Pxp is designed for Windows Command Prompt or PowerShell. If using Git Bash or other bash terminals, see the Git Bash compatibility guide.
Commands
Show version
pxp -v
# or
pxp --version
Displays the current Pxp version.
List installed versions
pxp list
# or explicitly list local versions
pxp list -php -local
Output example:
Installed PHP versions:
* 7.4.33 (active, php7)
8.0.30 (8.0.30)
8.2.27 (8.2.27)
List available PHP versions globally
pxp list -php -global
This fetches the latest stable PHP versions available from windows.php.net (Thread-Safe x64 builds).
Output example:
Fetching available PHP versions from windows.php.net...
Available stable PHP versions (Thread-Safe x64):
PHP 8.3:
8.3.15
8.3.14
8.3.13
PHP 8.2:
8.2.27
8.2.26
PHP 8.1:
8.1.31
8.1.30
To install a version: pxp install <version>
Show current version
pxp current
Displays the currently active PHP version in XAMPP.
Switch PHP version
pxp switch 8.0.30
# or use the alias
pxp use 8.0.30
This will:
- Stop Apache
- Backup current
php/ โ php{version}/ (e.g., php7.4.33/)
- Rename
php{target}/ โ php/
- Update Apache config (
httpd-xampp.conf)
- Start Apache
Download & install a new PHP version
pxp install 8.3.6
Downloads the thread-safe x64 build from windows.php.net and extracts it to C:\xampp\php8.3.6\.
After installing, switch to it:
pxp switch 8.3.6
Uninstall a PHP version
pxp uninstall 8.0.30
Removes an installed PHP version from your system. This will:
- Verify the version exists and is not currently active
- Ask for confirmation before deletion
- Permanently remove the PHP version directory
Note: You cannot uninstall the currently active PHP version. Switch to a different version first.
Help
pxp help
Shows all available commands with examples.
How It Works
| Component |
Description |
| Directories |
PHP versions are stored as C:\xampp\php{version}\. The active one is always C:\xampp\php\. |
| Apache config |
httpd-xampp.conf is updated to load the correct php7apache2_4.dll or php8apache2_4.dll. |
| Module name |
PHP 7.x uses php7_module, PHP 8.x uses php_module (XAMPP convention). |
| Backup |
A backup of httpd-xampp.conf.bak is created on first switch. |
| Services |
Apache is automatically stopped before switching and restarted after configuration updates. |
Requirements
- Windows 10/11 - Required for PowerShell support
- XAMPP - Installed at
C:\xampp (default location)
- PowerShell 5.1+ - Pre-installed on Windows 10/11
- .NET SDK 6.0+ - Only needed for building the MSI installer
Building the MSI Installer
If you want to build the installer from source:
Install the .NET SDK 6.0+
Build the MSI:
dotnet build ./installer/Pxp.wixproj -c Release
The MSI will be created in installer\bin\Release\
To specify a custom version:
dotnet build ./installer/Pxp.wixproj -c Release -p:ProductVersion=1.0.0
Troubleshooting
๐ For detailed troubleshooting solutions, see TROUBLESHOOTING.md
PowerShell Execution Policy Error
If you see "cannot be loaded. The file is not digitally signed" error:
- Open PowerShell as Administrator
- Run:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
- Run:
Unblock-File "C:\Program Files (x86)\Pxp\pxp.ps1"
โก๏ธ Full solution guide
Permission Errors
Run your terminal as Administrator if you encounter permission errors when switching PHP versions.
โก๏ธ Full solution guide
Apache Won't Start
- Check Apache error logs at
C:\xampp\apache\logs\error.log
- Ensure the correct PHP DLL files exist in the PHP directory
- Verify
httpd-xampp.conf has the correct PHP module configuration
โก๏ธ Full solution guide
VHost Warnings
Apache virtual host warnings (e.g., Could not resolve host name) are unrelated to PHP switching โ they come from your virtual host configuration in httpd-vhosts.conf.
Documentation
For Users
For Contributors
Troubleshooting Guides
Contributing
Contributions are welcome! We appreciate any help in improving pxp-cli.
How to Contribute
- ๐ Report bugs - Open an issue
- ๐ก Suggest features - Request a feature
- ๐ Submit pull requests - Read the contributing guide
- ๐ Improve documentation - Help make docs better
- โญ Star the repository - Show your support
Before contributing, please read:
Development Setup
# Clone the repository
git clone https://github.com/pphatdev/pxp-cli.git
cd pxp-cli
# Test the script
.\pxp.ps1 help
# Build the installer
dotnet build ./installer/Pxp.wixproj -c Release
Support
Getting Help
Show Your Support
If you find this tool helpful, please consider:
- โญ Star the repository on GitHub
- ๐ Report bugs you encounter
- ๐ก Suggest features you'd like to see
- ๐ Improve documentation with corrections and additions
- ๐ค Share with others who might benefit
License
MIT ยฉ pphatdev
Made with ๐ง to resolve PHP version switching issues | pphatdev