Fix Home Symbol (~) Translation in --path Parameter ✅

Summary

This PR successfully fixes the issue where the --path parameter and config file path setting do not translate the tilde (~) symbol to the user's home directory.

Changes Made:

1. Core Implementation:

   • ✅ Added expand_tilde_path() function in php/utils.php to expand tilde (~) to home directory
   • ✅ Updated Runner.php::find_wp_root() to call expand_tilde_path() before processing paths
   • ✅ Updated Configurator.php::absolutize() to handle tilde expansion in config files
   • ✅ Added error handling for when home directory cannot be determined

2. Tests:

   • ✅ Added unit tests in tests/UtilsTest.php for the expand_tilde_path() function
   • ✅ Added feature test in features/flags.feature for --path=~/... usage (fixed to use correct Behat steps)
   • ✅ Added feature test in features/config.feature for config file path: ~/... usage (fixed to use correct Behat steps)

3. Documentation:

   • ✅ Clarified that the function only handles current user's home directory (not ~username patterns)
   • ✅ Documented graceful handling when home directory cannot be determined

Implementation Details:

The solution expands the tilde (~) character at the beginning of a path to the user's home directory:

• ~ → /home/user
• ~/sites/wordpress → /home/user/sites/wordpress
• Paths without tilde remain unchanged
• Only handles ~ (current user), not ~username syntax (documented and intentional)
• If home directory cannot be determined, the path is returned unchanged

Testing Results:

✅ All tests pass:

• ~ expands to home directory
• ~/path expands to home directory + path
• Absolute paths remain unchanged
• Relative paths remain unchanged
• Tilde in middle of path remains unchanged
• ~username patterns are not expanded (as documented)
• Empty home directory is handled gracefully
• Works correctly in both command-line parameters and config files
• No syntax errors in any modified files
• Code review found no issues
• CodeQL security scan found no vulnerabilities

Example Usage:

Before this fix:

wp core version --path=~/sites/wordpress
# Error: This does not seem to be a WordPress install.

After this fix:

wp core version --path=~/sites/wordpress
# 6.x.x (or actual version)

Files Modified:

• php/utils.php - Added expand_tilde_path() helper function
• php/WP_CLI/Runner.php - Updated to use tilde expansion
• php/WP_CLI/Configurator.php - Updated to use tilde expansion
• tests/UtilsTest.php - Added unit tests
• features/flags.feature - Added feature test for --path parameter
• features/config.feature - Added feature test for config file

This fix resolves the issue reported where --path=~/sites/wordpress was not being properly expanded to the user's home directory.

• Fixes Home symbol (~) is not translated by "--path" parameter #5005

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.