Permission Denied / Access Denied Errors

[pphatdev]

Problem 1: Installing PHP Versions

Installation fails with permission errors when trying to install a new PHP version.

Cause

Installing PHP versions requires write access to the XAMPP directory (C:\xampp), which typically requires administrator privileges.

Solution

Run PowerShell as Administrator before installing PHP versions.

Problem 2: Switching PHP Versions

When switching versions with phat use [version], you get an error like:

Rename-Item : Access to the path 'C:\xampp\php' is denied.

Causes

1. Apache or PHP processes still running - The PHP directory is locked by running processes
2. File Explorer has the directory open - Windows Explorer locks the directory
3. Another program using PHP files - IDE, terminal, or other programs
4. Insufficient wait time - File handles not released yet
5. Missing administrator privileges - Directory operations require admin rights

[pphatdev]

Solutions

Solution 1: Run as Administrator

Run PowerShell as Administrator (see instructions below) and try again.

Solution 2: Close All Programs

1. Close all File Explorer windows (especially if browsing C:\xampp\php)
2. Close your IDE (VS Code, PhpStorm, etc.)
3. Close any terminal windows running PHP scripts
4. Try the switch command again

Solution 3: Manually Stop Processes

Run this command in PowerShell:

Get-Process php*, httpd -ErrorAction SilentlyContinue | Stop-Process -Force

Then wait 5 seconds and try switching again:

phat use 8.2.27

Solution 4: Use XAMPP Control Panel

1. Open XAMPP Control Panel
2. Click "Stop" for Apache
3. Wait 5 seconds
4. Run phat use [version]

Solution 5: Restart Computer

If all else fails, restart your computer to release all file locks, then try again.

How to Run PowerShell as Administrator

Method 1: Start Menu

1. Press the Windows key
2. Type "PowerShell"
3. Right-click on "Windows PowerShell"
4. Select "Run as Administrator"

Method 2: Win + X Menu

1. Press Win + X
2. Select "Windows PowerShell (Admin)" or "Terminal (Admin)"

Method 3: From File Explorer

1. Open File Explorer
2. Navigate to any folder
3. Click "File" → "Open Windows PowerShell" → "Open Windows PowerShell as administrator"

After Opening as Administrator

Once you have an administrator PowerShell window, run your install command:

phat install 8.2.27

Verifying Administrator Access

To check if you're running as administrator, look for "Administrator" in the PowerShell window title:

Administrator: Windows PowerShell

Or run this command:

([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator)

This should return True if you have administrator privileges.

Alternative: Run Specific Command as Admin

If you don't want to open a new admin window, you can run a specific command with admin rights:

1. Right-click on PowerShell/Terminal icon
2. Select "Run as Administrator"
3. In the admin prompt, run: phat install [version]

Common Permission Error Messages

You might see errors like:

• "Access to the path is denied"
• "UnauthorizedAccessException"
• "Administrator rights required"

All of these indicate you need to run PowerShell as Administrator.