重构PHP
重构意味着更新源代码的结构而不改变应用程序的行为。重构可帮助您保持代码的稳定，简洁和易于维护。
更改签名
在编辑器中，将光标放在要更改其签名的方法的名称中。
按下Ctrl+F6。或者，在主菜单或上下文菜单上选择：重构|更改签名。
- 在“更改签名”对话框中，对方法签名进行必要的更改，并指定所需的其他相关更改。
例如，更改方法名称。为此，请在“名称” 字段中编辑文本 。您可以通过编辑“返回类型”字段的内容来更改返回类型。只能在PHP语言版本7.1及更高版本中设置方法返回类型。您可以在“设置/首选项”对话框（Ctrl+Alt+S）的PHP页面上指定PHP语言级别。
使用“参数”区域中的表和按钮管理方法参数。添加参数时，您可能希望将这些参数传播到调用当前方法的方法。
- 在PHP上下文中，当从类的构造函数调用更改签名重构时 ，可以将新参数初始化为类字段。为此，请使用“创建并初始化类属性”复选框：选中此复选框后，新添加的参数将初始化为字段。IntelliJ IDEA创建一个与此参数同名的字段，并添加一行，其中包含以下赋值：
$this-><parameter_name> = $<parameter_name>; 清除该复选框后，将添加一个参数而不进行初始化。在此示例中，我们在__construct()方法上调用“更改签名重构”，并添加一个新的$q参数。结果取决于是否选中了“创建和初始化类属性”复选框。使用默认可见性修饰符创建新字段，该修饰符在代码样式的“代码生成”选项卡上设置 。“设置/首选项”对话框（Ctrl+Alt+S）的PHP页面。
之前 | 之后 |
|---|
class ChangeSignatureNewParam {
function __construct() {
$a = "Constructor in ChangeSignatureNewParam";
print $a;
}
}
| 选中“创建和初始化类属性”复选框： class ChangeSignatureNewParam {
private $q;
function __construct($q) {
$a = "Constructor in ChangeSignatureNewParam";
print $a;
$this->q = $q;
}
}
|
清除“创建和初始化类属性”复选框： class ChangeSignatureNewParam {
function __construct($q) {
$a = "Constructor in ChangeSignatureNewParam";
print $a;
}
}
|
您可以删除或重新排序添加的参数。要更改参数的名称或默认值，请在参数表中进行必要的更新（分别在“名称”和“默认值”字段中 ）。
您可以沿调用当前方法的方法的层次结构传播新方法参数（如果有）。单击“传播参数”按钮（ 
）。
要立即执行重构，请单击“重构”。要在实际执行重构之前查看预期的更改并进行必要的调整，请单击“预览”。
示例
下表显示了执行相同“更改签名”重构的3种不同方法 。
在所有情况下，result()函数都重命名为generateResult()，并且向此函数添加了一个新的$b参数。
这些示例显示了函数调用，调用函数（showResult()）和其他代码片段如何受到影响，具体取决于重构设置。
之前 | 之后 |
|---|
// This is the function whose signature will be changed:
function result($a) {
// some code here
}
function showResult($a) {
// Here is the function call:
$this->result($a);
}
// Now we'll rename the function and
// add one parameter.
| // The function has been renamed to generateResult.
// The new parameter $b has been added.
function generateResult($a,$b) {
// some code here
}
function showResult($a,$b) {
// The function call has been changed accordingly:
$this->generateResult($a,$b);
}
|
// This is the function whose signature will be changed:
function result($a) {
// some code here
}
function showResult($a) {
// Here is the function call:
$this->result($a);
}
// Now we'll rename the function and add one parameter.
//We will also specify the default value 'new_param'
//for this new parameter
| // The function has been renamed to generateResult.
// The new parameter $b has been added.
function generateResult($a,$b) {
// some code here
}
function showResult($a) {
// The function call has been changed accordingly:
$this->generateResult($a,'new_param');
}
// When performing the refactoring, 'new_param' was specified as
// the default parameter value.
|
// This is the function whose signature will be changed:
function result($a) {
// some code here
}
function showResult($a) {
// Here is the function call:
$this->result($a);
}
// Now we'll rename the function and add one parameter.
//We will also propagate this new parameter
//through the showResult() calling function to the function call.
| // The function has been renamed to generateResult.
// The new parameter $b has been added.
function generateResult($a,$b) {
// some code here
}
// Note the new function parameter:
function showResult($a,$b) {
// The function call has been changed accordingly:
$this->generateResult($a,$b);
}
|
