Since PHP 8.0 introduced named parameters, renaming method parameters is no longer a safe internal refactor — it can break existing callers. Four strategies are presented for handling this: parameter aliasing with default values (keeping both old and new params with a sunset period), the adapter/wrapper pattern (old method delegates to new), the middleware/proxy pattern (separate class intercepts old calls), and the breaking change approach (rename outright in a major version with documentation and automated tooling like Rector or IDE rename features). A summary table compares each strategy on backward compatibility, migration encouragement, and complexity.

Sort: