Remove Symfony dependencies from WP-CLI framework ✅

Summary

Successfully removed the symfony/finder dependency from the WP-CLI framework, which was the only Symfony package that the framework directly depended on. This makes it easier for WP-CLI commands to fit into existing Composer setups.

Changes Made

1. FileCache.php

• ✅ Removed use Symfony\Component\Finder\Finder
• ✅ Added native PHP SPL classes: FilesystemIterator, RecursiveDirectoryIterator, RecursiveIteratorIterator, SplFileInfo
• ✅ Replaced get_finder() method with get_cache_files() returning array of SplFileInfo objects
• ✅ Updated clean() method with native file iteration and correct sort order (newest first)
• ✅ Updated clear() method with native file iteration
• ✅ Updated prune() method with native file iteration and proper basename handling
• ✅ Added explanatory comment for exception handling
• ✅ Added type check for PHPStan compatibility in get_cache_files()
• ✅ Explicitly documented symlink behavior to match Symfony Finder: does NOT use FilesystemIterator::FOLLOW_SYMLINKS flag (prevents traversing into symlinked directories) and filters out symlink files with !isLink() check

2. composer.json

• ✅ Removed symfony/finder dependency from require section
• ✅ Preserved require-dev section with all original dependencies

3. IncludeFrameworkAutoloader.php

• ✅ Removed Symfony\Component\Finder namespace mapping from autoloader

Testing Completed

All FileCache functionality thoroughly tested and validated:

• ✅ Write and read operations
• ✅ Import and export operations
• ✅ Clear cache (delete all files)
• ✅ Clean cache with TTL-based expiration
• ✅ Clean cache with size-based cleanup (keeps newest, deletes oldest)
• ✅ Prune functionality with timestamp-based cache keys
• ✅ Symlink handling verified:
  • Does NOT traverse into symlinked directories (no FOLLOW_SYMLINKS flag used)
  • Does NOT include symlink files in results (!isLink() filter)
  • Matches Symfony Finder's default behavior exactly

Quality Checks Passed

• ✅ Code review completed - all issues addressed
• ✅ Security scan - no vulnerabilities detected
• ✅ PHP syntax validated
• ✅ PHPStan type issues resolved
• ✅ No remaining Symfony references in codebase
• ✅ Symfony package removed from vendor directory
• ✅ 100% backward compatibility maintained
• ✅ composer.json validated
• ✅ Symlink behavior explicitly documented and matches Symfony Finder (does not follow symlinks by default)

Benefits

• 🎯 Removes the only Symfony dependency from framework
• 🎯 Makes commands easier to integrate into existing Composer setups
• 🎯 Uses only native PHP functionality (no external dependencies)
• 🎯 Maintains complete backward compatibility
• 🎯 Explicitly preserves Symfony Finder's symlink behavior for consistent file iteration

Addresses issue as described in #4678

• Fixes Get rid of Symfony dependencies in the framework #4749

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