Ctrl+Alt+M（Windows/Linux）或Cmd+Alt+M（macOS）可快速将选中代码封装为新函数，调用“Extract Method”重构功能，弹窗设置函数名、作用域及参数，生成位置默认为类末尾或文件底部。
PhpStorm 里怎么用 function 快速包裹选中代码？
直接用 Ctrl+Alt+M（Windows/Linux）或 Cmd+Alt+M（macOS），PhpStorm 就会把当前选中的代码块自动封装成一个新函数。这个快捷键调用的是「Extract Method」重构功能，不是手写 function 模板。
它会弹出对话框让你填函数名、选择作用域（private/public）、是否提取参数——这些决定后续可维护性，别直接回车确认。
- 函数名必须符合 PHP 命名规范，不能以数字开头，建议用驼峰或下划线风格（如
calculateTotalPrice或format_user_data） - 如果选中代码里有未声明的变量，PhpStorm 默认尝试将其作为参数传入；但若该变量是全局或 $this 属性，它可能漏识别，需要手动补全参数或改用
$this->xxx - 光标没选中任何内容时按快捷键，PhpStorm 会从当前行开始向上/向下智能推断“可提取范围”，但容易包错，建议始终先手动选中
包裹后函数被插到哪？位置能控制吗？
默认插入位置是当前类的末尾（如果是类内），或当前文件的最下方（如果是全局作用域）。这不是随机的，而是由 PhpStorm 的「Member Order」设置和上下文决定的。
你无法在弹窗里直接指定插入位置，但可以事后拖动，或者提前调整设置：
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings > Editor > Code Style > PHP > Arrangement，勾选Keep members in order defined by member type，能让新方法按 public/private/static 等规则归位 - 如果想插到当前光标上方，可在触发
Ctrl+Alt+M前，先把光标移到目标位置（比如某个已有方法的上面），再选中代码——部分版本会优先就近插入，但不保证，慎依赖 - 包裹后立刻按
Ctrl+Z撤销，再用Alt+Enter呼出意图菜单，选Move method手动调整位置更可靠
为什么包裹完报错 “Undefined variable” 或 “Call to undefined function”？
常见于两种情况：变量作用域没处理好，或函数生成后没被正确调用/引入。
- 原代码用了
$user，但包裹时 PhpStorm 没把它加进参数列表（比如它误判为类属性），结果新函数里直接访问$user就报Undefined variable；解决办法是编辑生成的函数签名，手动加$user到参数，并在调用处传入 - 函数被提到了类里，但你还在全局作用域调用它，就会报
Call to undefined function；注意看生成的函数是不是带public function xxx()，那它就只能通过$this->xxx()或$obj->xxx()调用 - 如果原逻辑依赖
include或use的东西（比如Carbon），包裹后这些语句不会自动带进去，得手动补use Carbon\Carbon;或在函数内重写new \Carbon\Carbon()
PHP 版本低（比如 5.6）时，包裹出的函数语法不兼容怎么办？
PhpStorm 默认按项目配置的 PHP Language Level 生成语法。如果你项目设的是 PHP 7.4，但它会生成类型声明（如 function getTotal(): float），而你的生产环境是 PHP 5.6，运行时直接 Parse Error。
- 检查
Settings > Languages & Frameworks > PHP里的 Language Level，必须设成目标环境支持的最高版本（如 PHP 5.6） - 即使设对了，某些老版本也不支持 void 返回类型、标量类型声明，所以生成后要扫一眼函数签名，删掉
: void、: int这类 PHP 7+ 才有的语法 - 如果用了匿名函数嵌套或
...$args，也得确认目标 PHP 版本是否支持——PHP 5.6 不支持可变参数语法，得手动改成func_get_args()
重构不是一锤子买卖，生成的函数只是起点，变量来源、调用方式、环境兼容性都得自己过一遍。尤其当代码原本就靠全局变量或隐式作用域运行时，包裹动作反而会暴露深层耦合问题。
