用 PHP 开发健壮的代码(三):编写可重用函数_PHP函数XML
日期：2010-11-17 浏览次数：20569 次
在本系列文章（有关如何在实际情况下开发有效的 PHP 代码）的第 3 部分中，Amol Hatwar 讨论了如何构建最有效的功能型函数，使用这些函数不会牺牲太多性能或可管理性。作者重点阐述了如何编写可重用函数，并介绍了如何避免与该任务相关的一些最常见问题。
欢迎回来。在本系列文章的第 1 部分中，我讨论了一些基本的 PHP 设计规则，并介绍了如何编写安全、简单、与平台无关且快速的代码。在第 2 部分中，我介绍了变量，并讨论了它们在 PHP 编码中的用法 — 好的和坏的实践。
在本文中，您将了解如何在 PHP 中明智地使用函数。在每一种高级编程语言中，程序员都可以定义函数，PHP 也不例外。唯一的区别在于，您不必担心函数的返回类型。
深入研究
函数可用于：
将几行代码封装成一条语句。
简化代码。
最重要的是，将应用程序作为更小的应用程序相互协调的产物。
对于从编译语言（如 C/C++）转到 PHP 的开发人员来说，PHP 的性能级别是令人吃惊的。在使用 CPU 和内存资源方面，用户定义的函数非常昂贵。这主要是因为 PHP 是解释型和松散类型的。
包装与否
有些开发人员仅仅因为不喜欢函数的名称就把他们使用的每个函数都包装起来，而另一些开发人员却根本不喜欢使用包装。
包装现有的 PHP 函数而不添加或补充现有的功能，是完全不能接受的。除了会增加大小和执行时间外，这样的重命名函数有时可能会带来管理上的恶梦。
代码中的内联函数会导致莫名其妙的代码，甚至是更大的管理灾难。这样做的唯一好处可能就是得到一个更快的代码。
更明智的方法是，仅在需要多次使用代码，并且对于您希望实现的任务没有可用的内置 PHP 函数时才定义函数。您可以选择重命名或仅当需要时才有限制地使用。
图 1 中的图表粗略地显示了可管理性和速度与使用的函数数量之间的相互关系。（在此我没标明单位，因为数字取决于个体和团队的能力；这一关系是重要的可视数据。）
图 1. 可管理性／速度 Vs. 函数数量
命名函数
正如我在本系列文章的第 2 部分（请参阅参考资料）中提到的，要获得有效的代码管理，始终都使用公共的命名约定是必不可少的。
其它两个需要考虑的实践是：
选择的名称应当能很好地提示函数的功能。
使用表明包或模块的前缀。
假定您有一个名为 user 的模块，它包含用户管理函数，那么对于检查用户当前是否在线的函数而言，诸如 usr_is_online() 和 usrIsOnline() 这样的函数名称都是上佳之选。
将上面的名称与 is_online_checker() 这样的函数名称相比较。得到的结论是，使用动词优于使用名词，因为函数始终都会做点什么。
多少参数？
很有可能您将使用已经构造的函数。即使情形并非如此，您可能也希望最大化代码的使用范围。要做到这一点，您和其他开发人员应当继续开发易于使用的函数。没人喜欢使用那些所带的参数既晦涩又难于理解的函数，因此请编写易于使用的函数。
选择一个能够说明函数用途的名称（并减少函数使用的参数数量）是确保易于使用的一个好方法。参数数量的幻数是什么呢？依我看来，超过三个参数就会使函数难以记忆。使用大量参数的复杂函数几乎都能被拆分成多个更简单的函数。
没人喜欢使用凑合的函数。
编写优质函数
假定您希望在将 HTML 文档放到浏览器之前设置文档的标题。标题就是 <head>...</head> 标记之间的所有内容。
假定您希望设置 title 和 meta 标记。不使用 setHeader(title, name, value) 函数执行所有工作，而分别使用 setTitle(title) 和 setMeta(name, value) 完成各项工作是一个更佳的解决方案。该方案相互独立地设置 title 和 meta标记。
进一步考虑，标题可以只包含一个 title 标记，但它可以包含多个 meta 标记。如果需要设置多个 meta 标记，则代码必须多次调用 setMeta()。在这种情况下，更佳的解决方案是将带有名称-值对的两维数组传递给 setMeta()，并且让函数循环执行该数组 — 同时执行所有操作。
一般来说，象这样的同时的函数更可取。用函数需要处理的所有数据一次性调用函数，始终优于多次调用函数，并以增量的方式为其提供数据。编写函数时的主要思想是，尽量减少从其它代码对其的调用。
据此，setHeader() 解决方案实在不是好方法。显而易见，我们可以将 setHeader() 重构成 setHeader(title, array)，但是也必须考虑到我们失去了相互独立地设置 title 和 meta 标记的能力。
此外，在实际环境中，标题可能包含多个标记，而不只是 title 和 meta 标记。如果需要添加更多标记，您必须更改 setHeader()，并且改变依赖于它的所有其它代码。在后一种情形下，只需多编写一个函数。
下面的等式适用于所有编程语言：
便于记忆的名称 + 清晰的参数 + 速度和效率 = 在所有编程语言中都适用的优质函数
用分层的方法协调函数
函数很少是独自存在的。它们与其它函数共同起作用，交换和处理数据以完成任务。编写可与相同组或模块中的其它函数良好协作的函数很重要，因为这些函数组或模块组就是您必须能够重用的。
让我们继续假想的页面构建示例。这里，该模块的职责是用 HTML 构建一个页面。（现在让我们先略过细节问题和代码，因为示例的目的只是为了说明：在提高可重用性要素的同时，如何使函数和函数组方便地相互配合。）
从内置的 PHP 函数开始，您可以构建抽象函数，使用它们创建更多处理基本需求的函数，然后依次使用这些函数构建特定于应用程序的函数。图 2 可以让您了解其工作原理。
图 2. 分层的函数
现在，先在内存中构建页面，然后将完成的页面分发给浏览器。
在内存中构建页面有两大好处：
可以用自己的脚本高速缓存已完成的页面。
如果未能成功构建页面，可以废弃完成一半的页面，并使浏览器指向出错页面。
现在，您的用户将不会看到页面中有错误消息的报告了。
根据大多数页面的结构，需要将页面构建模块分成执行以下功能的函数：
绘制顶栏
绘制导航栏
显示内容
添加脚注
还需要执行下述功能的函数：
高速缓存页面
检查页面是否已经被高速缓存
如果页面已被高速缓存则显示它
让我们称之为页面构建器（pagebuilder）模块。
页面构建器模块通过查询数据库执行其工作。由于该数据库是 PHP 之外的，所以将使用数据库抽象模块，其职责是为 PHP 中各种不同的特定于供应商的数据库函数提供同类接口。该模块中的重要函数有：连接数据库的函数、查询数据库的函数以及提供查询结果的函数。
假定您还希望实现一个站点范围的搜索引擎。该模块将负责搜索站点上与某个关键字或某组关键字相关的文档，并根据搜索字符串的相关性或出现该字符串次数最多来显示结果。如果您还希望记录搜索以便进行审计，该模块将与数据库抽象模块一起使用。
请记住，您将接受来自用户的输入。您需要将其显示在屏幕上，并废弃那些看上去怀有恶意的内容。这需要另一个模块，它负责验证用户通过表单提交的数据。
至此，您对我正在讲述的概念肯定有了大致的了解。必须将最核心的功能分解成逻辑模块，要执行它们的任务，应用程序必须使用这些模块提供的函数。
使用这种分层的方法，简单的页面构建呈现应用程序可能如图 3 所示。
图 3. 分层的页面构建应用程序
请注意，在本示例中，核心模块与处理应用程序的模块之间没有层次。也就是说，核心模块可以从下面的抽象模块或层中声明的函数调用和声明函数，但是应用程序代码可能不能这样做。如果应用程序代码中的函数受任何低层函数“污染”或者封装了任何低层函数，那么应用程序代码不应该声明这些函数。它只能使用低层的函数。这被证实是一个更快的方法。
<
欢迎回来。在本系列文章的第 1 部分中，我讨论了一些基本的 PHP 设计规则，并介绍了如何编写安全、简单、与平台无关且快速的代码。在第 2 部分中，我介绍了变量，并讨论了它们在 PHP 编码中的用法 — 好的和坏的实践。
在本文中，您将了解如何在 PHP 中明智地使用函数。在每一种高级编程语言中，程序员都可以定义函数，PHP 也不例外。唯一的区别在于，您不必担心函数的返回类型。
深入研究
函数可用于：
将几行代码封装成一条语句。
简化代码。
最重要的是，将应用程序作为更小的应用程序相互协调的产物。
对于从编译语言（如 C/C++）转到 PHP 的开发人员来说，PHP 的性能级别是令人吃惊的。在使用 CPU 和内存资源方面，用户定义的函数非常昂贵。这主要是因为 PHP 是解释型和松散类型的。
包装与否
有些开发人员仅仅因为不喜欢函数的名称就把他们使用的每个函数都包装起来，而另一些开发人员却根本不喜欢使用包装。
包装现有的 PHP 函数而不添加或补充现有的功能，是完全不能接受的。除了会增加大小和执行时间外，这样的重命名函数有时可能会带来管理上的恶梦。
代码中的内联函数会导致莫名其妙的代码，甚至是更大的管理灾难。这样做的唯一好处可能就是得到一个更快的代码。
更明智的方法是，仅在需要多次使用代码，并且对于您希望实现的任务没有可用的内置 PHP 函数时才定义函数。您可以选择重命名或仅当需要时才有限制地使用。
图 1 中的图表粗略地显示了可管理性和速度与使用的函数数量之间的相互关系。（在此我没标明单位，因为数字取决于个体和团队的能力；这一关系是重要的可视数据。）
图 1. 可管理性／速度 Vs. 函数数量
命名函数
正如我在本系列文章的第 2 部分（请参阅参考资料）中提到的，要获得有效的代码管理，始终都使用公共的命名约定是必不可少的。
其它两个需要考虑的实践是：
选择的名称应当能很好地提示函数的功能。
使用表明包或模块的前缀。
假定您有一个名为 user 的模块，它包含用户管理函数，那么对于检查用户当前是否在线的函数而言，诸如 usr_is_online() 和 usrIsOnline() 这样的函数名称都是上佳之选。
将上面的名称与 is_online_checker() 这样的函数名称相比较。得到的结论是，使用动词优于使用名词，因为函数始终都会做点什么。
多少参数？
很有可能您将使用已经构造的函数。即使情形并非如此，您可能也希望最大化代码的使用范围。要做到这一点，您和其他开发人员应当继续开发易于使用的函数。没人喜欢使用那些所带的参数既晦涩又难于理解的函数，因此请编写易于使用的函数。
选择一个能够说明函数用途的名称（并减少函数使用的参数数量）是确保易于使用的一个好方法。参数数量的幻数是什么呢？依我看来，超过三个参数就会使函数难以记忆。使用大量参数的复杂函数几乎都能被拆分成多个更简单的函数。
没人喜欢使用凑合的函数。
编写优质函数
假定您希望在将 HTML 文档放到浏览器之前设置文档的标题。标题就是 <head>...</head> 标记之间的所有内容。
假定您希望设置 title 和 meta 标记。不使用 setHeader(title, name, value) 函数执行所有工作，而分别使用 setTitle(title) 和 setMeta(name, value) 完成各项工作是一个更佳的解决方案。该方案相互独立地设置 title 和 meta标记。
进一步考虑，标题可以只包含一个 title 标记，但它可以包含多个 meta 标记。如果需要设置多个 meta 标记，则代码必须多次调用 setMeta()。在这种情况下，更佳的解决方案是将带有名称-值对的两维数组传递给 setMeta()，并且让函数循环执行该数组 — 同时执行所有操作。
一般来说，象这样的同时的函数更可取。用函数需要处理的所有数据一次性调用函数，始终优于多次调用函数，并以增量的方式为其提供数据。编写函数时的主要思想是，尽量减少从其它代码对其的调用。
据此，setHeader() 解决方案实在不是好方法。显而易见，我们可以将 setHeader() 重构成 setHeader(title, array)，但是也必须考虑到我们失去了相互独立地设置 title 和 meta 标记的能力。
此外，在实际环境中，标题可能包含多个标记，而不只是 title 和 meta 标记。如果需要添加更多标记，您必须更改 setHeader()，并且改变依赖于它的所有其它代码。在后一种情形下，只需多编写一个函数。
下面的等式适用于所有编程语言：
便于记忆的名称 + 清晰的参数 + 速度和效率 = 在所有编程语言中都适用的优质函数
用分层的方法协调函数
函数很少是独自存在的。它们与其它函数共同起作用，交换和处理数据以完成任务。编写可与相同组或模块中的其它函数良好协作的函数很重要，因为这些函数组或模块组就是您必须能够重用的。
让我们继续假想的页面构建示例。这里，该模块的职责是用 HTML 构建一个页面。（现在让我们先略过细节问题和代码，因为示例的目的只是为了说明：在提高可重用性要素的同时，如何使函数和函数组方便地相互配合。）
从内置的 PHP 函数开始，您可以构建抽象函数，使用它们创建更多处理基本需求的函数，然后依次使用这些函数构建特定于应用程序的函数。图 2 可以让您了解其工作原理。
图 2. 分层的函数
现在，先在内存中构建页面，然后将完成的页面分发给浏览器。
在内存中构建页面有两大好处：
可以用自己的脚本高速缓存已完成的页面。
如果未能成功构建页面，可以废弃完成一半的页面，并使浏览器指向出错页面。
现在，您的用户将不会看到页面中有错误消息的报告了。
根据大多数页面的结构，需要将页面构建模块分成执行以下功能的函数：
绘制顶栏
绘制导航栏
显示内容
添加脚注
还需要执行下述功能的函数：
高速缓存页面
检查页面是否已经被高速缓存
如果页面已被高速缓存则显示它
让我们称之为页面构建器（pagebuilder）模块。
页面构建器模块通过查询数据库执行其工作。由于该数据库是 PHP 之外的，所以将使用数据库抽象模块，其职责是为 PHP 中各种不同的特定于供应商的数据库函数提供同类接口。该模块中的重要函数有：连接数据库的函数、查询数据库的函数以及提供查询结果的函数。
假定您还希望实现一个站点范围的搜索引擎。该模块将负责搜索站点上与某个关键字或某组关键字相关的文档，并根据搜索字符串的相关性或出现该字符串次数最多来显示结果。如果您还希望记录搜索以便进行审计，该模块将与数据库抽象模块一起使用。
请记住，您将接受来自用户的输入。您需要将其显示在屏幕上，并废弃那些看上去怀有恶意的内容。这需要另一个模块，它负责验证用户通过表单提交的数据。
至此，您对我正在讲述的概念肯定有了大致的了解。必须将最核心的功能分解成逻辑模块，要执行它们的任务，应用程序必须使用这些模块提供的函数。
使用这种分层的方法，简单的页面构建呈现应用程序可能如图 3 所示。
图 3. 分层的页面构建应用程序
请注意，在本示例中，核心模块与处理应用程序的模块之间没有层次。也就是说，核心模块可以从下面的抽象模块或层中声明的函数调用和声明函数，但是应用程序代码可能不能这样做。如果应用程序代码中的函数受任何低层函数“污染”或者封装了任何低层函数，那么应用程序代码不应该声明这些函数。它只能使用低层的函数。这被证实是一个更快的方法。
<
免责声明： 本文仅代表作者个人观点，与爱易网无关。其原创性以及文中陈述文字和内容未经本站证实，对本文以及其中全部或者部分内容、文字的真实性、完整性、及时性本站不作任何保证或承诺，请读者仅作参考，并请自行核实相关内容。
