转载

在云中构建天气跟踪应用程序，第 2 部分

在第 1 部分中，我介绍了如何创建一个基础 PHP 应用程序，并使用一个在线服务检索并存储世界城市的经纬度坐标。

现在让我们添加来自 IBM 的新 Insights for Weather 服务，并开始使用来自第 1 部分的城市信息跟踪您选择的 5 个世界城市的天气。您还将了解如何将您的最终应用程序托管在 IBM Bluemix 上。

运行示例应用程序

获取示例应用程序的代码

观看 Vikram 逐步演示代码

抄本

完成您的应用程序的前提条件

参见第 1 部分了解必备知识和软件。

第 1 步. 初始化一个 Insights for Weather Service 实例

因为存储数据库中的每个位置记录还包含该位置的纬度和经度，所以您现在可以将您的应用程序与 Insights for Weather 服务相集成。最初，此服务实例将在一种未绑定状态下运行；这使您能够在本地开发应用程序，而将服务实例本身远程托管在 Bluemix 上。

阅读： Insights for Weather 入门

要创建一个新 Insights for Weather 实例，可以登录到您的Bluemix 帐户，在仪表板中单击 Use Services or APIs 按钮。从得到的服务列表中选择 Insights for Weather 。
检查该服务的描述并单击 CREATE 来启动它。确保 App 字段被设置为 Leave unbound ，而且您使用的是 Free Plan 。
该服务实例现在将被初始化，您会看到一个服务信息页面。记下服务名称，您在需要使用它。左侧会显示一个导航栏，单击 Service Credentials 查看该服务实例的访问细节。
将 url 字段的内容复制到应用程序的 $APP_ROOT /config.php 文件中的 weather_uri 键中。这使您的应用程序能够连接到远程 Insights for Weather 实例并开始从中检索天气数据。

第 2 步. 显示当前天气数据

要使用 Insights for Weather 服务，只需请求上一节中显示的服务 URL 并向它附加 API 签名。例如，一个针对 API 端点 https://USERNAME:PASSWORD@twcservice.mybluemix.net/api/weather/v2/observations/current?units=m&language=en-US&geocode=51.50853-0.12574 的请求将生成以下响应，该响应显示了伦敦的当前天气：

具体地讲，JSON 输出包括当前天气的描述性短语（例如 “Partly cloudy”），以及当前温度、风速、湿度和其他数据。要在您的应用程序中显示同样的信息，可以更新 /index 路由处理函数来检索存储的位置列表；然后连接到上面显示的 Insights for Weather 服务来检索每个位置的当前天气条件：

<?php // index page handlers $app->get('/', function () use ($app) {   return $app->redirect($app["url_generator"]->generate('index')); });  $app->get('/index', function () use ($app, $db) {   // get list of locations from database   // for each location, get current weather from Weather service   $collection = $db->locations;     $locations = iterator_to_array($collection->find());   foreach ($locations as &$location) {     $uri = $app->config['weather_uri'] . '/api/weather/v2/observations/current?units=m&language=en-US&geocode=' . urlencode(sprintf('%f,%f', $location['lat'], $location['lng']));     $json = file_get_contents($uri);     if ($json === FALSE) {      throw new Exception("Could not connect to Weather API.");       }     $location['weather'] = json_decode($json, true);   }   return $app['twig']->render('index.twig', array('locations' => $locations)); }) ->bind('index');

接下来，更新 $APP_ROOT /views/index.twig 上的 Twig 模板以显示此信息：

<div data-role="content">                <h2 class="ui-bar ui-bar-a">Current Weather</h2>         <div class="ui-body">           <ul data-role="listview" data-split-icon="minus" data-split-theme="d">                     {% for item in locations %}             <li>               <a href="{{ app.url_generator.generate('forecast', {'id': item._id|trim}) }}" data-ajax="false">{{ item.location }}, {{ item.country }}               <br/>               {{ item.weather.observation.metric.temp }}° C | {{ item.weather.observation.phrase_22char }}               </a>               <a href="{{ app.url_generator.generate('delete', {'id': item._id|trim}) }}" data-ajax="false">Remove</a>                              </li>           {% endfor %}           </ul>         </div>                      <div>           <p><a href="{{ app.url_generator.generate('search') }}" data-ajax="false" data-inline="true" data-role="button" data-icon="plus" data-theme="a">Add Location</a></p>         </div>                    </div>

这是该模板的外观。如果更喜欢使用图标代替文本，Insights for Weather 服务提供了一组完整的图标，以及如何使用它们的说明。

请注意，每个位置的旁边都有一个 Delete 按钮，它链接到 /delete 路由处理函数，并将该位置的唯一 MongoDB 记录标识符传递给此处理函数。 /delete 处理函数将从 MongoDB 数据库中删除指定的记录：

<?php // handler to remove location from database $app->get('/delete/{id}', function ($id) use ($app, $db) {   $collection = $db->locations;   $collection->remove(array('_id' => new MongoId($id)));   return $app->redirect($app["url_generator"]->generate('index')); }) ->bind('delete');

第 3 步. 检索天气预报

就像您可以检索任何位置的当前天气条件一样，Insights for Weather 服务还允许您检索该位置的 10 天内的天气预报。将您的 API 请求更新为 https://USERNAME:PASSWORD@twcservice.mybluemix.net/api/weather/v2/forecast/daily/10day?units=m&language=en-US&geocode=51.50853-0.12574 ，您将收到白天和晚上的天气条件的详细信息，如下所示。请注意输入中的 dow 和 narrative 字段，它表示星期几和这一天的预报信息片段，因为这些是应用程序使用的主要字段。

要将此功能添加到您的应用程序中，可为 /forecast 路由创建一个新处理函数，向它传递数据库中的位置标识符，然后将该值的坐标插入到上面的 API 请求中。以下是相关代码：

<?php // handler to display 7-day forecast for selected location $app->get('/forecast/{id}', function ($id) use ($app, $db) {   // look up location record in database   // connect and get forecast from Weather service   $collection = $db->locations;   $location = (array)$collection->findOne(array('_id' => new MongoId($id)));   $uri = $app->config['weather_uri'] . '/api/weather/v2/forecast/daily/10day?units=m&language=en-US&geocode=' . urlencode(sprintf('%f,%f', $location['lat'], $location['lng']));   $json = file_get_contents($uri);   if ($json === FALSE) {     throw new Exception("Could not connect to Weather API.");     }   $location['weather'] = json_decode($json, true);   return $app['twig']->render('forecast.twig', array('data' => $location)); }) ->bind('forecast');

您还可以为这个新处理函数添加一个页面模板，并从主索引页面链接到它。可以在应用程序的代码存储库中找到该模板。以下是该选项卡的示例：

第 4 步. 将您的应用程序部署到 IBM Bluemix

此刻，该应用程序已完成，您可以将它部署到 Bluemix 了。

首先，更新应用程序配置文件并修改数据库凭证，让它们指向您的远程 MongoDB 数据库部署。

然后，创建应用程序清单文件，记住通过附加一个随即字符串（比如您姓名的首字母）来使用唯一的主机和应用程序名称。

--- applications: - name: weather-tracker-[initials] memory: 256M instances: 1 host: weather-tracker-[initials] buildpack: https://github.com/cloudfoundry/php-buildpack.git stack: cflinuxfs2

CloudFoundry PHP buildpack 默认情况下不包含 PHP MongoDB 扩展，所以您必须配置该 buildpack，以便在部署期间启用该扩展。另外，如果您希望自动从 Bluemix 获取 Insights for Weather 服务凭证，那么可以更新该代码来使用 Bluemix VCAP_SERVICES 变量，如下所示：
```
<?php if ($services = getenv("VCAP_SERVICES")) {   $services_json = json_decode($services, true);   $app->config['weather_uri'] = $services_json["weatherinsights"][0]["credentials"]["url"]; }
```

您现在看可以继续将该应用程序推送到 Bluemix，然后将 Insights for Weather 服务绑定到该应用程序。

shell> cf api https://api.ng.bluemix.net shell> cf login shell> cf push shell> cf bind-service weather-tracker-[initials] "Insights for Weather-[id]" shell> cf restage weather-tracker-[initials]

现在可以浏览到应用程序清单中指定的主机来开始使用该应用程序，例如 http://weather-tracker- [initials] .mybluemix.net。如果看到一个空白页或其他错误，可以尝试调试您的 PHP 代码来查找出错的地方。

阅读：在 IBM Bluemix 上调试 PHP 错误

结束语

Insights for Weather 服务使得将特定于位置的天气数据和预报添加到移动或 Web 应用程序变得很容易。因为您可以通过 REST API 访问该服务，因此可以将它与任何编程语言相集成。此外，因为该服务托管在 Bluemix 上，所以很容易将它连接到您由 Bluemix 托管的应用程序，只需将该服务绑定到您的应用程序并重新载入它。

您可以从上面的链接下载本教程中实现的所有代码，以及 PHP buildpack 的配置文件。推荐您获取该代码，使用它，并尝试添加一些新特性。我保证您不会造成任何破坏，而且它肯定对您的学习有所帮助。祝您开发愉快！

原文 http://www.ibm.com/developerworks/cn/cloud/library/cl-bluemix-weather-php-app-2/index.html?ca=drs-

正文到此结束