用PHP开发健壮的代码：编写可重用函数
程序员文章站
2024-02-10 21:19:16
...
在本文中，您将了解如何在 php(做为现在的主流开发语言) 中明智地使用函数。在每一种高级编程语言中，程序员都可以定义函数，php(做为现在的主流开发语言) 也不例外。唯一的区别在于，您不必担心函数的返回类型。
深入研究
函数可用于：
将几行代码封装成一条语句。
简化代码。
最重要的是，将应用程序作为更小的应用程序相互协调的产物。
对于从编译语言（如 C/C++）转到 php(做为现在的主流开发语言) 的开发人员来说，php(做为现在的主流开发语言) 的性能级别是令人吃惊的。在使用 CPU 和内存资源方面，用户定义的函数非常昂贵。这主要是因为 php(做为现在的主流开发语言) 是解释型和松散类型的。
包装与否
有些开发人员仅仅因为不喜欢函数的名称就把他们使用的每个函数都包装起来，而另一些开发人员却根本不喜欢使用包装。
包装现有的 php(做为现在的主流开发语言) 函数而不添加或补充现有的功能，是完全不能接受的。除了会增加大小和执行时间外，这样的重命名函数有时可能会带来管理上的恶梦。
代码中的内联函数会导致莫名其妙的代码，甚至是更大的管理灾难。这样做的唯一好处可能就是得到一个更快的代码。
更明智的方法是，仅在需要多次使用代码，并且对于您希望实现的任务没有可用的内置 php(做为现在的主流开发语言) 函数时才定义函数。您可以选择重命名或仅当需要时才有限制地使用。
图 1 中的图表粗略地显示了可管理性和速度与使用的函数数量之间的相互关系。（在此我没标明单位，因为数字取决于个体和团队的能力；这一关系是重要的可视数据。）
图 1. 可管理性／速度 Vs. 函数数量
命名函数
正如我在本系列文章的第" 2 部分（请参阅参考资料）中提到的，要获得有效的代码管理，始终都使用公共的命名约定是必不可少的。
其它两个需要考虑的实践是：
选择的名称应当能很好地提示函数的功能。
使用表明包或模块的前缀。
假定您有一个名为 user 的模块，它包含用户管理函数，那么对于检查用户当前是否在线的函数而言，诸如 usr_is_online() 和 usrIsOnline() 这样的函数名称都是上佳之选。
将上面的名称与 is_online_checker() 这样的函数名称相比较。得到的结论是，使用动词优于使用名词，因为函数始终都会做点什么。
多少参数？
很有可能您将使用已经构造的函数。即使情形并非如此，您可能也希望最大化代码的使用范围。要做到这一点，您和其他开发人员应当继续开发易于使用的函数。没人喜欢使用那些所带的参数既晦涩又难于理解的函数，因此请编写易于使用的函数。
选择一个能够说明函数用途的名称（并减少函数使用的参数数量）是确保易于使用的一个好方法。参数数量的幻数是什么呢？依我看来，超过三个参数就会使函数难以记忆。使用大量参数的复杂函数几乎都能被拆分成多个更简单的函数。
没人喜欢使用凑合的函数。
编写优质函数
假定您希望在将 HTML 文档放到浏览器之前设置文档的标题。标题就是 ... 标记之间的所有内容。
假定您希望设置 title 和 meta 标记。不使用 setHeader(title, name, value) 函数执行所有工作，而分别使用 setTitle(title) 和 setMeta(name, value) 完成各项工作是一个更佳的解决方案。该方案相互独立地设置 title 和 meta标记。
进一步考虑，标题可以只包含一个 title 标记，但它可以包含多个 meta 标记。如果需要设置多个 meta 标记，则代码必须多次调用 setMeta()。在这种情况下，更佳的解决方案是将带有名称-值对的两维数组传递给 setMeta()，并且让函数循环执行该数组 — 同时执行所有操作。
一般来说，象这样的同时的函数更可取。用函数需要处理的所有数据一次性调用函数，始终优于多次调用函数，并以增量的方式为其提供数据。编写函数时的主要思想是，尽量减少从其它代码对其的调用。
深入研究
函数可用于：
将几行代码封装成一条语句。
简化代码。
最重要的是，将应用程序作为更小的应用程序相互协调的产物。
对于从编译语言（如 C/C++）转到 php(做为现在的主流开发语言) 的开发人员来说，php(做为现在的主流开发语言) 的性能级别是令人吃惊的。在使用 CPU 和内存资源方面，用户定义的函数非常昂贵。这主要是因为 php(做为现在的主流开发语言) 是解释型和松散类型的。
包装与否
有些开发人员仅仅因为不喜欢函数的名称就把他们使用的每个函数都包装起来，而另一些开发人员却根本不喜欢使用包装。
包装现有的 php(做为现在的主流开发语言) 函数而不添加或补充现有的功能，是完全不能接受的。除了会增加大小和执行时间外，这样的重命名函数有时可能会带来管理上的恶梦。
代码中的内联函数会导致莫名其妙的代码，甚至是更大的管理灾难。这样做的唯一好处可能就是得到一个更快的代码。
更明智的方法是，仅在需要多次使用代码，并且对于您希望实现的任务没有可用的内置 php(做为现在的主流开发语言) 函数时才定义函数。您可以选择重命名或仅当需要时才有限制地使用。
图 1 中的图表粗略地显示了可管理性和速度与使用的函数数量之间的相互关系。（在此我没标明单位，因为数字取决于个体和团队的能力；这一关系是重要的可视数据。）
命名函数
正如我在本系列文章的第" 2 部分（请参阅参考资料）中提到的，要获得有效的代码管理，始终都使用公共的命名约定是必不可少的。
其它两个需要考虑的实践是：
选择的名称应当能很好地提示函数的功能。
使用表明包或模块的前缀。
假定您有一个名为 user 的模块，它包含用户管理函数，那么对于检查用户当前是否在线的函数而言，诸如 usr_is_online() 和 usrIsOnline() 这样的函数名称都是上佳之选。
将上面的名称与 is_online_checker() 这样的函数名称相比较。得到的结论是，使用动词优于使用名词，因为函数始终都会做点什么。
多少参数？
很有可能您将使用已经构造的函数。即使情形并非如此，您可能也希望最大化代码的使用范围。要做到这一点，您和其他开发人员应当继续开发易于使用的函数。没人喜欢使用那些所带的参数既晦涩又难于理解的函数，因此请编写易于使用的函数。
选择一个能够说明函数用途的名称（并减少函数使用的参数数量）是确保易于使用的一个好方法。参数数量的幻数是什么呢？依我看来，超过三个参数就会使函数难以记忆。使用大量参数的复杂函数几乎都能被拆分成多个更简单的函数。
没人喜欢使用凑合的函数。
编写优质函数
假定您希望在将 HTML 文档放到浏览器之前设置文档的标题。标题就是 ... 标记之间的所有内容。
假定您希望设置 title 和 meta 标记。不使用 setHeader(title, name, value) 函数执行所有工作，而分别使用 setTitle(title) 和 setMeta(name, value) 完成各项工作是一个更佳的解决方案。该方案相互独立地设置 title 和 meta标记。
进一步考虑，标题可以只包含一个 title 标记，但它可以包含多个 meta 标记。如果需要设置多个 meta 标记，则代码必须多次调用 setMeta()。在这种情况下，更佳的解决方案是将带有名称-值对的两维数组传递给 setMeta()，并且让函数循环执行该数组 — 同时执行所有操作。
一般来说，象这样的同时的函数更可取。用函数需要处理的所有数据一次性调用函数，始终优于多次调用函数，并以增量的方式为其提供数据。编写函数时的主要思想是，尽量减少从其它代码对其的调用。