PHP开发：从程序化到面向对象

谷歌PHP API客户端

谷歌专门针对PHP提供一套API客户端，我们将利用它与自己的谷歌账户进行对接，从而对日程表服务加以操作。要想让代码正确起效，大家需要通过设定让自己的谷歌账户接受来自日程表的查询。

虽然这是本篇指南文章的重要前提，但并不能算主要内容。为了避免在这方面浪费太多篇幅，请大家直接参考官方说明文档。各位不必担心，整个设置过程非常简单，而且只要五分钟左右即可搞定。

本教程附带的示例代码中包含谷歌PHP API客户端代码，建议大家就使用这一套以确保整个学习过程与文章说明保持一致。另外，如果大家想尝试自行安装，请点击此处查看官方说明文档。

接下来按照指示向apiAccess.php文件中填写信息。该文件在程序化与面向对象两套实例中都会用到，因此大家不必在新版本中重复填写。我在文件中留下了自己填写的内容，这样大家就能更轻松地找到对应位置并将其按自己的资料进行修改。

如果大家碰巧用的是NetBeans，我把各个项目文件保存在了包含有不同范例的文件夹当中。这样大家可以轻松打开该项目，并点选Run——>Run Project在本地PHP服务器（要求使用PHP 5.4）上直接加以运行。

与谷歌API对接的客户端库为面向对象型。为了示例的正常运行，我编写了一套小小的函数合集，其中囊括了本教程所需要的所有函数。通过这种方式，我们可以利用程序化层在面向对象客户端库之上进行软件编写，且代码不会涉及任何对象。

如果大家打算快速测试自己的代码与指向谷歌API的连接是否正常起效，则可以直接使用位于index.php文件中的代码。它会列出账户中所有日程表信息，且应该至少有一套具备summary字段的日程表中包含您的姓名。如果日程表中存在联系人生日信息，那么谷歌API将无法与之正常协作。不过大家不用惊慌，另选一套即可。

require_once './google-api-php-client/src/Google_Client.php';  
require_once './google-api-php-client/src/contrib/Google_CalendarService.php';  
require_once __DIR__ . '/../apiAccess.php';  
require_once './functins_google_api.php';  
require_once './functions.php';  
session_start();  
   
$client = createClient();  
if(!authenticate($client)) return;  
listAllCalendars($client);  

这个index.php文件将成为我们应用程序的入口点。我们不会使用任何Web框架或者其它复杂的机制。我们要做的只是简单输出一些HTML代码而已。

程序化开发方案

现在我们已经了解了所需创建的目标以及所能使用的资源，接下来就是下载附件中的源代码。我会提供代码中的有用片段，但为了进一步了解全局情况，大家可能希望访问其初始来源。

在这套方案中，我们只求成果能按预期生效。我们的代码可能会显得有些粗糙，而且其中只涉及以下几个文件：

• index.php – 这是惟一一个我们需要通过浏览器直接访问并转向其GET参数的文件。

• functions_google_api.php – 囊括所有前面提到的谷歌API。

• functions.php – 一切奇迹在此发生。

functions.php将容纳应用程序的所有执行过程。包括路由逻辑、表现以及一切值与行为全部发生于此。这款应用非常简单，其主逻辑如下图所示：

这里有一项名为doUserAction()的函数，它的生效与否取决于一条很长的if-else声明；其它方法则根据GET变量中的参数决定调用情况。这些方法随后利用API与谷歌日程表对接，并在屏幕上显示出我们需要的任何结果。

function printCalendarContents($client) {  
   putTitle('These are you events for ' . getCalendar($client, $_GET['showThisCalendar'])['summary'] . ' calendar:');  
   foreach (retrieveEvents($client, $_GET['showThisCalendar']) as $event) {  
      print('<div style="font-size:10px;color:grey;">' . date('Y-m-d H:m', strtotime($event['created'])));  
      putLink('?showThisEvent=' . htmlentities($event['id']) .  
            '&calendarId=' . htmlentities($_GET['showThisCalendar']), $event['summary']);  
      print('</div>');  
      print('<br>');  
   }  
}  

这个例子恐怕要算我们此次编写的代码中最为复杂的函数。它所调用的是名为putTitle()的辅助函数，其作用是将某些经过格式调整的HTML输出以充当标题。标题中将包含我们日程表的实际名称，这是通过调用来自functions_google_api.php文件中的getCalendar()函数来实现的。返回的日历信息是一个数组，其中包含一个summary字段，而这正是我们要找的内容。

$client变量被传递到我们的所有函数当中。它需要与谷歌API相连，不过这方面内容我们稍后再谈。

接下来，我们整理一下日程表中的全部现有事件。这份数组列表由封装在retrieveEvents()函数中的API请求运行得来。对于每个事件，我们都会显示出其创建日期及标题。

其余部分代码与我们之前讨论过的内容相近，甚至更容易理解。大家可以抱着轻松的心情随便看看，然后抖擞精神进军下一章。

组织程序化代码

我们当前的代码完全没问题，但我想我们可以通过调整使其以更合适的方式组织起来。大家可能已经从附带的源代码中发现，该项目所有已经组织完成的代码都被命名为“GoogleCalProceduralOrganized”。

使用全局客户端变量

在代码组织工作中，第一件让人心烦的事在于，我们把$client变量作为参数推广到全局以及嵌套函数的深层当中。程序化编程方案对这类情况提供了一种巧妙的解决办法，即全局变量。由于$client是由index.php所定义，而从全局观点来看，我们需要改变的只是函数对该变量的具体使用方式。因此我们不必改变$client参数，而只需进行如下处理：

function printCalendars() {  
   global $client;  
   putTitle('These are your calendars:');  
   foreach (getCalendarList($client)['items'] as $calendar) {  
      putLink('?showThisCalendar=' . htmlentities($calendar['id']), $calendar['summary']);  
      print('<br>');  
   }  
}  

大家不妨将现有代码与附件中的代码成品进行比较，看看二者有何不同之处。没错，我们并没有将$client作为参数传递，而是在所有函数中使用global $client并将其作为只传递向谷歌API函数的参数。从技术角度看，即使是谷歌API函数也能够使用来自全局的$client变量，但我认为最好还是尽量保持API的独立性。