feat: Add 'whereami' command to display installation locations of phat.bat and phat.ps1

Author: pphatdev

README.md

@@ -39,6 +39,8 @@ Download the latest MSI installer from [Releases](https://github.com/pphatdev/ph
    phat help
    ```
 
+> **Note**: Phat is designed for Windows Command Prompt or PowerShell. If using Git Bash or other bash terminals, see the [Git Bash compatibility guide](docs/git-bash-compatibility.md).
+
 ## Commands
 
 ### Show version
@@ -198,16 +200,32 @@ dotnet build ./installer/Phat.wixproj -c Release -p:ProductVersion=1.0.0
 
 ## Troubleshooting
 
+📖 **For detailed troubleshooting solutions, see [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)**
+
+### PowerShell Execution Policy Error
+
+If you see "cannot be loaded. The file is not digitally signed" error:
+
+1. Open PowerShell as Administrator
+2. Run: `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`
+3. Run: `Unblock-File "C:\Program Files (x86)\Phat\phat.ps1"`
+
+➡️ **[Full solution guide](docs/powershell-execution-policy.md)**
+
 ### Permission Errors
 
 Run your terminal as **Administrator** if you encounter permission errors when switching PHP versions.
 
+➡️ **[Full solution guide](docs/permission-denied.md)**
+
 ### Apache Won't Start
 
 1. Check Apache error logs at `C:\xampp\apache\logs\error.log`
 2. Ensure the correct PHP DLL files exist in the PHP directory
 3. Verify `httpd-xampp.conf` has the correct PHP module configuration
 
+➡️ **[Full solution guide](docs/apache-wont-start.md)**
+
 ### 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`.

phat.ps1

@@ -200,6 +200,52 @@ function Show-Version {
     Write-Host ""
 }
 
+function Show-WhereAmI {
+    Write-Host ""
+    Write-Host "  Phat Installation Locations:" -ForegroundColor Cyan
+    Write-Host ""
+
+    # Find phat.bat in PATH
+    $phatBat = $null
+    $pathDirs = $env:PATH -split ';'
+    
+    foreach ($dir in $pathDirs) {
+        if ($dir -and (Test-Path $dir)) {
+            $batPath = Join-Path $dir "phat.bat"
+            if (Test-Path $batPath) {
+                $phatBat = $batPath
+                break
+            }
+        }
+    }
+
+    # Show phat.bat location
+    if ($phatBat) {
+        Write-Host "  phat.bat:" -ForegroundColor Green
+        Write-Host "    $phatBat" -ForegroundColor White
+    } else {
+        Write-Host "  phat.bat: " -NoNewline -ForegroundColor Yellow
+        Write-Host "Not found in PATH" -ForegroundColor Gray
+    }
+
+    # Show current script location
+    $scriptPath = $PSScriptRoot
+    if (-not $scriptPath) {
+        $scriptPath = Split-Path -Parent $MyInvocation.MyCommand.Path
+    }
+    
+    if ($scriptPath) {
+        $ps1Path = Join-Path $scriptPath "phat.ps1"
+        if (Test-Path $ps1Path) {
+            Write-Host ""
+            Write-Host "  phat.ps1:" -ForegroundColor Green
+            Write-Host "    $ps1Path" -ForegroundColor White
+        }
+    }
+
+    Write-Host ""
+}
+
 function Write-ExampleLine ([string]$CommandText) {
     Write-Host "    $ " -ForegroundColor DarkGray -NoNewline
     Write-Host $CommandText -ForegroundColor Cyan
@@ -228,6 +274,7 @@ function Show-Help {
     Write-UsageLine "phat list --php --local" "        -> List local PHP versions (same as list)"
     Write-UsageLine "phat list --php --global" "       -> List available stable versions from PHP.net"
     Write-UsageLine "phat current" "                   -> Show current PHP version"
+    Write-UsageLine "phat whereami" "                  -> Show phat.bat installation location"
     Write-UsageLine "phat -v | --version" "            -> Show Phat version"
     Write-UsageLine "phat switch [version]" "          -> Switch to a PHP version"
     Write-UsageLine "phat use [version]" "             -> Alias for switch"
@@ -603,11 +650,11 @@ if ($VersionFlag) {
 switch ($Command) {
     "list"       { Invoke-List }
     "current"    { Show-CurrentVersion }
+    "whereami"   { Show-WhereAmI }
     "switch"     { Invoke-Switch $Argument }
     "use"        { Invoke-Switch $Argument }
     "install"    { Invoke-Install $Argument }
     "uninstall"  { Invoke-Uninstall $Argument }
     "help"       { Show-Help }
-    
     default      { Show-Help }
 }