diff --git a/docs/PHP_CONFIG_LOCATIONS_COMPLETE.md b/docs/PHP_CONFIG_LOCATIONS_COMPLETE.md
new file mode 100644
index 0000000..2ddef27
--- /dev/null
+++ b/docs/PHP_CONFIG_LOCATIONS_COMPLETE.md
@@ -0,0 +1,483 @@
+# Complete PHP Configuration File Locations - All Control Panels
+
+## Understanding PHP Configuration Priority
+
+PHP configuration is applied in a **hierarchical cascade**. Settings in higher-priority files **override** settings in lower-priority files.
+
+### Priority Order (Highest to Lowest)
+
+```
+PRIORITY 1 (HIGHEST): Per-Directory Configuration
+├─ .user.ini (PHP-FPM only, per-directory)
+├─ .htaccess with php_value/php_flag (Apache + mod_php ONLY, NOT PHP-FPM!)
+└─ ini_set() in PHP code (runtime only)
+
+PRIORITY 2: User-Specific Configuration
+├─ ~/public_html/php.ini (some control panels)
+├─ ~/.php/X.Y/php.ini (per PHP version)
+├─ ~/etc/phpX.Y/php.ini (InterWorx style)
+└─ ~/php.ini (legacy)
+
+PRIORITY 3: Pool-Specific Configuration
+├─ /opt/cpanel/ea-phpXY/root/etc/php.ini (cPanel EA-PHP)
+├─ /opt/alt/phpXY/etc/php.ini (CloudLinux Alt-PHP)
+├─ Additional .ini files loaded alphabetically:
+│   ├─ /opt/cpanel/ea-phpXY/root/etc/php.d/*.ini
+│   └─ Loaded in alphabetical order (00-*, 10-*, 20-*, etc.)
+└─ scan_dir configured locations
+
+PRIORITY 4 (LOWEST): System-Wide Configuration
+└─ /etc/php.ini (global default, rarely used with control panels)
+```
+
+## Complete File Location Map by Control Panel
+
+### cPanel with EA-PHP (Most Common)
+
+#### 1. Per-Directory (.user.ini) - **PRIORITY 1**
+```bash
+# Location pattern
+/home/$username/public_html/.user.ini
+/home/$username/public_html/subdirectory/.user.ini
+/home/$username/public_html/app/.user.ini
+
+# Applies to
+- That directory and all subdirectories
+- Only works with PHP-FPM (not mod_php)
+- Reloaded every user_ini.cache_ttl seconds (default 300)
+
+# Example content
+memory_limit = 512M
+upload_max_filesize = 100M
+post_max_size = 150M
+max_execution_time = 120
+
+# Find all .user.ini files for a user
+find /home/$username -name ".user.ini" -type f
+
+# Common locations
+/home/$username/public_html/.user.ini
+/home/$username/public_html/wp-content/.user.ini
+/home/$username/public_html/app/upload/.user.ini
+```
+
+#### 2. .htaccess with PHP directives - **PRIORITY 1** (mod_php ONLY!)
+```bash
+# Location
+/home/$username/public_html/.htaccess
+
+# IMPORTANT: Only works with Apache mod_php
+# Does NOT work with PHP-FPM!
+# cPanel typically uses PHP-FPM, so .htaccess php_value is IGNORED
+
+# Example content (if mod_php is used)
+php_value memory_limit 256M
+php_value upload_max_filesize 64M
+php_flag display_errors Off
+
+# Find .htaccess with PHP directives
+find /home/$username/public_html -name ".htaccess" -exec grep -l "php_value\|php_flag" {} \;
+```
+
+#### 3. User Home Directory Configs - **PRIORITY 2**
+```bash
+# cPanel creates user-specific php.ini in various locations:
+
+# A. PHP version-specific in home
+/home/$username/.php/8.2/php.ini
+/home/$username/.php/8.1/php.ini
+/home/$username/.php/8.0/php.ini
+
+# B. Legacy home php.ini
+/home/$username/php.ini
+
+# C. In etc subdirectory
+/home/$username/etc/php.ini
+/home/$username/etc/php/8.2/php.ini
+
+# D. In public_html (some configurations)
+/home/$username/public_html/php.ini
+
+# Find all home directory php.ini files
+find /home/$username -maxdepth 3 -name "php.ini" -type f
+find /home/$username/.php -name "php.ini" -type f 2>/dev/null
+```
+
+#### 4. MultiPHP INI Editor Files - **PRIORITY 2**
+```bash
+# cPanel's MultiPHP INI Editor creates user-specific overrides here:
+/var/cpanel/userdata/$username/php-fpm.d/$domain.conf
+/home/$username/.php/8.2/php.ini
+
+# These override pool defaults but are overridden by .user.ini
+```
+
+#### 5. EA-PHP Pool Configuration - **PRIORITY 3**
+```bash
+# Main php.ini for each EA-PHP version
+/opt/cpanel/ea-php80/root/etc/php.ini
+/opt/cpanel/ea-php81/root/etc/php.ini
+/opt/cpanel/ea-php82/root/etc/php.ini
+/opt/cpanel/ea-php83/root/etc/php.ini
+
+# Additional .ini files (loaded alphabetically)
+/opt/cpanel/ea-php82/root/etc/php.d/00-ioncube.ini
+/opt/cpanel/ea-php82/root/etc/php.d/10-opcache.ini
+/opt/cpanel/ea-php82/root/etc/php.d/20-gd.ini
+/opt/cpanel/ea-php82/root/etc/php.d/30-mysqli.ini
+
+# Find all EA-PHP installations
+find /opt/cpanel -maxdepth 1 -type d -name "ea-php*"
+
+# Find all php.ini files
+find /opt/cpanel/ea-php* -name "php.ini"
+
+# Find all additional .ini files
+find /opt/cpanel/ea-php*/root/etc/php.d/ -name "*.ini" | sort
+```
+
+#### 6. PHP-FPM Pool Configs (Not php.ini but affects PHP)
+```bash
+# Per-user FPM pool config (process manager settings)
+/opt/cpanel/ea-php82/root/etc/php-fpm.d/$username.conf
+
+# Contains: pm, pm.max_children, pm.start_servers, etc.
+# Not php.ini settings, but critical for performance!
+```
+
+### CloudLinux with Alt-PHP
+
+#### Alt-PHP Configuration Locations
+```bash
+# Main php.ini for each Alt-PHP version
+/opt/alt/php80/etc/php.ini
+/opt/alt/php81/etc/php.ini
+/opt/alt/php82/etc/php.ini
+
+# Additional .ini files
+/opt/alt/php82/etc/php.d.all/*.ini
+
+# Per-user overrides (if configured)
+/home/$username/.cl.php/alt-php82/php.ini
+
+# Find all Alt-PHP versions
+ls -d /opt/alt/php*/
+
+# Find all Alt-PHP ini files
+find /opt/alt/php* -name "php.ini"
+```
+
+### Plesk
+
+#### Plesk PHP Configuration Hierarchy
+```bash
+# 1. Per-directory .user.ini - PRIORITY 1
+/var/www/vhosts/$domain/httpdocs/.user.ini
+/var/www/vhosts/$domain/httpdocs/subdirectory/.user.ini
+
+# 2. Domain-specific php.ini - PRIORITY 2
+/var/www/vhosts/system/$domain/etc/php.ini
+
+# 3. Pool-specific php.ini - PRIORITY 3
+/etc/php-fpm.d/plesk-php82-fpm/php.ini
+
+# 4. PHP version php.ini - PRIORITY 3
+/opt/plesk/php/8.2/etc/php.ini
+/opt/plesk/php/8.1/etc/php.ini
+
+# 5. Additional .ini files
+/opt/plesk/php/8.2/etc/php.d/*.ini
+
+# 6. System-wide - PRIORITY 4
+/etc/php.ini
+
+# Find domain php.ini files
+find /var/www/vhosts/system -name "php.ini"
+
+# Find all Plesk PHP versions
+ls -d /opt/plesk/php/*/
+```
+
+### InterWorx
+
+#### InterWorx PHP Configuration
+```bash
+# 1. Per-directory .user.ini - PRIORITY 1
+/home/$username/var/$domain/html/.user.ini
+
+# 2. Domain-specific php.ini - PRIORITY 2
+/home/$username/var/$domain/etc/php.ini
+
+# 3. User etc directory
+/home/$username/etc/php82/php.ini
+
+# 4. PHP version php.ini - PRIORITY 3
+/etc/php82/php.ini
+/etc/php81/php.ini
+
+# 5. System-wide - PRIORITY 4
+/etc/php.ini
+
+# Find InterWorx domain configs
+find /home/*/var/*/etc -name "php.ini"
+
+# Find user php configs
+find /home/*/etc/php* -name "php.ini"
+```
+
+### DirectAdmin
+
+#### DirectAdmin Configuration
+```bash
+# 1. Per-directory .user.ini - PRIORITY 1
+/home/$username/domains/$domain/public_html/.user.ini
+
+# 2. Domain php.ini - PRIORITY 2
+/usr/local/directadmin/data/users/$username/php/domains/$domain.ini
+
+# 3. User default php.ini
+/usr/local/directadmin/data/users/$username/php/php.ini
+
+# 4. PHP version php.ini - PRIORITY 3
+/usr/local/php82/lib/php.ini
+
+# Find DirectAdmin configs
+find /usr/local/directadmin/data/users -name "php.ini"
+find /usr/local/directadmin/data/users -name "*.ini"
+```
+
+### No Control Panel (Standalone)
+
+#### Standard PHP Locations
+```bash
+# 1. Per-directory .user.ini - PRIORITY 1
+/var/www/html/.user.ini
+/var/www/domain.com/.user.ini
+
+# 2. Pool-specific (if using PHP-FPM)
+/etc/php/8.2/fpm/php.ini
+/etc/php-fpm.d/www.conf
+
+# 3. CLI php.ini (different from FPM!)
+/etc/php/8.2/cli/php.ini
+
+# 4. Additional .ini files
+/etc/php/8.2/mods-available/*.ini
+/etc/php/8.2/conf.d/*.ini
+
+# 5. System-wide
+/etc/php.ini
+/usr/local/lib/php.ini
+```
+
+## Detection Strategy - Universal Function
+
+```bash
+find_all_php_configs() {
+    local username="$1"
+    local domain="$2"
+    local php_version="$3"  # e.g., "82" or "8.2"
+
+    declare -a config_files
+    declare -A config_priority
+
+    echo "=== Finding ALL PHP configs affecting: $domain (user: $username) ==="
+    echo ""
+
+    # PRIORITY 1: Per-Directory .user.ini
+    echo "PRIORITY 1: Per-Directory Configs"
+    while IFS= read -r file; do
+        if [ -f "$file" ]; then
+            config_files+=("$file")
+            config_priority["$file"]=1
+            echo "  [P1] $file"
+        fi
+    done < <(find "/home/$username" -name ".user.ini" 2>/dev/null)
+
+    # Check .htaccess (only relevant for mod_php)
+    while IFS= read -r file; do
+        if grep -q "php_value\|php_flag" "$file" 2>/dev/null; then
+            config_files+=("$file")
+            config_priority["$file"]=1
+            echo "  [P1] $file (mod_php only - likely IGNORED on PHP-FPM!)"
+        fi
+    done < <(find "/home/$username/public_html" -name ".htaccess" 2>/dev/null)
+
+    echo ""
+    echo "PRIORITY 2: User-Specific Configs"
+
+    # User home directory configs (various patterns)
+    local user_configs=(
+        "/home/$username/php.ini"
+        "/home/$username/public_html/php.ini"
+        "/home/$username/.php/$php_version/php.ini"
+        "/home/$username/.php/${php_version:0:1}.${php_version:1}/php.ini"
+        "/home/$username/etc/php.ini"
+        "/home/$username/etc/php/$php_version/php.ini"
+    )
+
+    for config in "${user_configs[@]}"; do
+        if [ -f "$config" ]; then
+            config_files+=("$config")
+            config_priority["$config"]=2
+            echo "  [P2] $config"
+        fi
+    done
+
+    # Plesk domain-specific
+    if [ -f "/var/www/vhosts/system/$domain/etc/php.ini" ]; then
+        config_files+=("/var/www/vhosts/system/$domain/etc/php.ini")
+        config_priority["/var/www/vhosts/system/$domain/etc/php.ini"]=2
+        echo "  [P2] /var/www/vhosts/system/$domain/etc/php.ini"
+    fi
+
+    # InterWorx domain-specific
+    if [ -f "/home/$username/var/$domain/etc/php.ini" ]; then
+        config_files+=("/home/$username/var/$domain/etc/php.ini")
+        config_priority["/home/$username/var/$domain/etc/php.ini"]=2
+        echo "  [P2] /home/$username/var/$domain/etc/php.ini"
+    fi
+
+    echo ""
+    echo "PRIORITY 3: Pool/Version-Specific Configs"
+
+    # cPanel EA-PHP
+    local cpanel_php_ini="/opt/cpanel/ea-php${php_version}/root/etc/php.ini"
+    if [ -f "$cpanel_php_ini" ]; then
+        config_files+=("$cpanel_php_ini")
+        config_priority["$cpanel_php_ini"]=3
+        echo "  [P3] $cpanel_php_ini"
+
+        # Additional .ini files
+        if [ -d "/opt/cpanel/ea-php${php_version}/root/etc/php.d" ]; then
+            while IFS= read -r file; do
+                config_files+=("$file")
+                config_priority["$file"]=3
+                echo "  [P3] $file"
+            done < <(find "/opt/cpanel/ea-php${php_version}/root/etc/php.d" -name "*.ini" | sort)
+        fi
+    fi
+
+    # CloudLinux Alt-PHP
+    local alt_php_ini="/opt/alt/php${php_version}/etc/php.ini"
+    if [ -f "$alt_php_ini" ]; then
+        config_files+=("$alt_php_ini")
+        config_priority["$alt_php_ini"]=3
+        echo "  [P3] $alt_php_ini"
+    fi
+
+    # Plesk
+    local plesk_php_ini="/opt/plesk/php/${php_version:0:1}.${php_version:1}/etc/php.ini"
+    if [ -f "$plesk_php_ini" ]; then
+        config_files+=("$plesk_php_ini")
+        config_priority["$plesk_php_ini"]=3
+        echo "  [P3] $plesk_php_ini"
+    fi
+
+    echo ""
+    echo "PRIORITY 4: System-Wide Default"
+    if [ -f "/etc/php.ini" ]; then
+        config_files+=("/etc/php.ini")
+        config_priority["/etc/php.ini"]=4
+        echo "  [P4] /etc/php.ini"
+    fi
+
+    echo ""
+    echo "=== Total config files found: ${#config_files[@]} ==="
+
+    # Return the array
+    printf '%s\n' "${config_files[@]}"
+}
+```
+
+## How to Determine Effective Setting
+
+### Method 1: Query PHP Directly (MOST ACCURATE!)
+
+```bash
+# Get effective value for a specific setting
+get_effective_php_setting() {
+    local username="$1"
+    local setting="$2"  # e.g., "memory_limit"
+
+    # Run as user to get their effective settings
+    su -s /bin/bash "$username" -c "php -r 'echo ini_get(\"$setting\");'"
+}
+
+# Example usage
+memory_limit=$(get_effective_php_setting "examplec" "memory_limit")
+echo "Effective memory_limit: $memory_limit"
+
+# Get ALL effective settings
+su -s /bin/bash "$username" -c "php -r 'print_r(ini_get_all());'" > /tmp/effective_php_settings.txt
+```
+
+### Method 2: Parse Config Hierarchy
+
+```bash
+# Parse configs in priority order and track overrides
+get_setting_from_configs() {
+    local setting="$1"
+    local value=""
+
+    # Parse in REVERSE priority (lowest to highest)
+    # So higher priority files override
+
+    # Priority 4: System
+    value=$(grep "^$setting" /etc/php.ini | cut -d'=' -f2 | tr -d ' ')
+
+    # Priority 3: Pool
+    pool_value=$(grep "^$setting" /opt/cpanel/ea-php82/root/etc/php.ini | cut -d'=' -f2 | tr -d ' ')
+    [ -n "$pool_value" ] && value="$pool_value"
+
+    # Priority 2: User
+    user_value=$(grep "^$setting" /home/$username/.php/8.2/php.ini | cut -d'=' -f2 | tr -d ' ')
+    [ -n "$user_value" ] && value="$user_value"
+
+    # Priority 1: .user.ini
+    user_ini_value=$(grep "^$setting" /home/$username/public_html/.user.ini | cut -d'=' -f2 | tr -d ' ')
+    [ -n "$user_ini_value" ] && value="$user_ini_value"
+
+    echo "$value"
+}
+```
+
+## Quick Reference Commands
+
+```bash
+# Find ALL php.ini files on system
+find / -name "php.ini" -type f 2>/dev/null
+
+# Find ALL .user.ini files
+find /home -name ".user.ini" -type f 2>/dev/null
+
+# Find .htaccess with PHP directives
+find /home -name ".htaccess" -exec grep -l "php_value\|php_flag" {} \; 2>/dev/null
+
+# Get effective settings for a domain (via web)
+curl -s "http://domain.com/info.php" | grep -A1 "memory_limit"
+
+# Get effective settings via CLI
+php -i | grep "memory_limit"
+php -r "echo ini_get('memory_limit');"
+
+# List all loaded .ini files
+php --ini
+
+# Get configuration file path
+php -r "echo php_ini_loaded_file();"
+
+# Get scanned .ini directory
+php -r "echo php_ini_scanned_files();"
+```
+
+## Key Takeaways for Optimizer
+
+1. **Always check .user.ini first** - It overrides everything!
+2. **Per-domain/user configs vary by control panel** - Need detection logic
+3. **.htaccess php_value only works with mod_php** - Usually ignored on modern setups
+4. **Query PHP directly for accurate effective values** - Don't just parse files
+5. **Check loaded files via php --ini** - Shows what's actually being used
+6. **Multiple .ini files can affect same setting** - Last one wins (in priority order)
+
+This complete map ensures the optimizer will find ALL configuration affecting a domain!