将一个参数添加到一个公共方法

一个公共方法添加一个新的参数是可能只有这是最后一个参数的方法。

如果是这样的话,这是如何正确地做小版本:

1. 添加参数作为评论的签名:

   1 2 3 4 5 6 7 8 9

   / /新的论点可以是可选的公共函数说(字符串美元文本,/ * bool stripWithespace美元= true * /):无效{}/ /或要求公共函数说(字符串美元文本,/ * bool stripWithespace美元* /):无效{}

2. 文档的新论点PHPDoc:

   1 2 3

   / * * *@parambool stripWithespace * /美元

3. 使用func_num_args和func_get_arg检索参数的方法:

   1

   美元stripWithespace=2< = \ func_num_args () ?func_get_arg (1):假;

   注意,默认值是假保持当前的行为。

4. 如果参数有默认值,改变当前的行为,提醒用户:

   1

   trigger_deprecation (sob娱乐下载ymfony /组件的,“X.Y”,“不通过“bool stripWithespace美元”的论点明确弃用,其默认值将改变Z.0 X”。);

5. 如果参数没有默认值,提醒用户需要的下一个主要版本:

   1 2 3 4 5 6 7

   如果(\ func_num_args () <2){trigger_deprecation (sob娱乐下载ymfony /组件的,“X.Y”,”“% s”()方法将有一个新的“bool stripWithespace美元”的论点在Z.0版本中,没有定义它是弃用。,__METHOD__);美元stripWithespace=假;}其他的{美元stripWithespace= func_get_arg (1);}

6. 的下一个主要版本(X.0),取消争论,移除PHPDoc如果没有需要一个描述,并删除func_get_arg代码和警告。