赞
踩
在本教程的其余部分,我们将基于 ThinkPHP 框架完成一个天气查询的应用。使用 天气查询-API文档-开发指南-Web服务 API | 高德地图API 的接口来实现我们的功能。把查询数据缓存到 MySql 中,这样就不用每次频繁的请求第三方的接口了(有请求次数限制)
选择高德开放平台-天气查询 API 主要是因为它是免费的。当然你也可以使用其他的第三方天气查询接口,看个人喜好。
该应用是一个非常简单的 REST API 应用,主要实现两个接口。
GET /weather/:location_id - 从数据库中获取天气(如果存在的话),如果不存在,则从 第三方接口获取。
DELETE /weather/:location_id - 从数据库中删除已缓存的天气信息。再次查询该地点的天气时,将从高德的天气接口获取。
在我们进行应用编码之前,首先使用 Docker 安装并运行 ThinkPHP
ThinkPHP 是一个免费开源的,快速、简单的面向对象的轻量级PHP开发框架,是为了敏捷WEB应用开发和简化企业应用开发而诞生的。ThinkPHP从诞生以来一直秉承简洁实用的设计原则,在保持出色的性能和至简代码的同时,更注重易用性。遵循Apache2开源许可协议发布,意味着你可以免费使用ThinkPHP,甚至允许把你基于ThinkPHP开发的应用开源或商业产品发布/销售。
这就是为什么我选择它作为本教程的教学框架。我不想让你因为一个框架而放弃,但我也不想从头开始建立所有的东西,因为该教程的重点是Docker,而不是我们的PHP应用。
用Docker 创建 ThinkPHP 应用实际上比用本地配置PHP环境所需的操作少。并且为我们还需要使用 Composer,多亏了Docker,我们甚至不需要在主机上安装它。
首先打开你的终端,创建一个项目目录。
- $ mkdir docker-app
- 复制代码
并进入到该目录中
- $ cd docker-app
- 复制代码
现在使用[官方Composer Docker镜像](
hub.docker.com/_/composer/… ThinkPHP 。
- $ docker run --rm --interactive --tty -v E:/workplace/docker-app/:/app composer:latest create-project topthink/think weather-app
- 复制代码
如果你查看weather-app/目录,你会看到 ThinkPHP 6 的项目目录,如下所示:
- dir
-
- E:\workplace\docker-app\weather-app 的目录
-
- 2022/02/11 16:31 <DIR> .
- 2022/02/11 16:30 <DIR> ..
- 2021/12/16 21:06 231 .example.env
- 2021/12/16 21:06 34 .gitignore
- 2021/12/16 21:06 2,038 .travis.yml
- 2021/12/16 21:06 <DIR> app
- 2021/12/16 21:06 1,094 composer.json
- 2022/02/11 16:31 36,134 composer.lock
- 2021/12/16 21:06 <DIR> config
- 2021/12/16 21:06 <DIR> extend
- 2021/12/16 21:06 1,822 LICENSE.txt
- 2021/12/16 21:06 <DIR> public
- 2021/12/16 21:06 1,459 README.md
- 2021/12/16 21:06 <DIR> route
- 2021/12/16 21:06 <DIR> runtime
- 2021/12/16 21:06 180 think
- 2022/02/11 16:31 <DIR> vendor
- 2021/12/16 21:06 <DIR> view
- 复制代码
我们的 docker 运行命令与第二章中的命令相似,但我们使用了不同的镜像。我们没有使用运行hello.php 脚本的 PHP 镜像,而是使用了一个 Composer 镜像。让我们来看看有什么变化。
composer:latest - 这表明我们在这个容器中使用的镜像。如果需要,你可以指定Composer的特定版本;只要查看Docker Hub上支持的镜像标签列表。
create-project topthink/think weather-app - 这是实际将 ThinkPHP 6 安装到容器工作目录中的命令。因为该工作目录是我们主机目录的一个卷,所以 composer 安装的文件现在在主机和容器中都存在。在这一点上,你的应用程序实际上没有做任何事情,但 ThinkPHP 6 已经被安装了,我们现在对 composer 在 Docker 中如何与 PHP 一起工作有了一些了解。
项目创建完成后,我们需要添加几个路由 URL 和 Controller 文件 。让我们打开 weather-app 目录下的 app/controller , 然后新建 Weather.php 文件,内容如下:
- <?php
-
- namespace app\controller;
-
- use app\BaseController;
-
- class Weather extends BaseController
- {
- public function get()
- {
- // todo
- echo "location_id is ".$this->request->param('location_id');
- }
-
- public function delete()
- {
- // todo
- echo "location_id is ".$this->request->param('location_id');
- }
- }
- 复制代码
然后打开 weather-app 目录下的 app/route , 在 app.php 文件中追加如下内容:
- Route::get('/weather/:location_id','weather/get');
- Route::delete('/weather/:location_id','weather/delete');
- 复制代码
现在我们可以在 Docker 容器中运行我们的应用程序,只是为了验证我们的程序是否运行正常,因为我们只添加了两个路由 URL。打开命令行,运行。
- $ docker run --privileged=true --rm -p 38000:80 -v E:/workplace/docker-app/:/var/www/html php:apache
- 复制代码
现在,在浏览器中打开
http://localhost:38000/weather-app/public/index.php/weather/1,你应该看到一个空页面,上面有以下文字:
- location_id is 1
- 复制代码
那么恭喜你,你刚刚已经成功地在 Docker 中运行了你的第一个 ThinkPHP 应用程序。
这次我们使用的docker run命令与我们用来运行 hello.php 脚本 和composer create-project ...的两个命令不同。原因是这次我们想获得包含 Apache 的最新版本的PHP,这样我们就可以为我们的 Web 应用提供服务。让我们更详细地了解新增的命令部分。
最后,你会注意到,这次在镜像名称后面没有命令。这可能会让新的Docker用户感到困惑,但在默认情况下,即使你没有指定命令,大多数镜像也会运行一些命令。在PHP Apache镜像的例子中,默认的命令是运行一个shell脚本来启动Apache。这个脚本正是我们想要的,所以没有理由去改变它。
在这一点上,你的终端将显示任何进来的Apache请求,所以当你加载第一个URL时,你可能看到类似的东西。
- 172.17.0.1 - - [11/Feb/2022:09:14:02 +0000] "GET /weather-app/public/index.php/weather/1 HTTP/1.1" 200 245 "-" "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.80 Safari/537.36 Edg/98.0.1108.43"
- 复制代码
你可以通过向终端发送一个 "中断 "信号来停止和退出终端。在 windows 上,这可以通过按 Ctrl 和按c来实现。
运行你的新网络应用程序的另一个选择是在 "Detached"模式中运行容器。这意味着你在终端将不会看到来自你的容器的输出。这可以通过在我们之前的命令中添加-d标志来实现。
- $ docker run --privileged=true -d --rm -p 38000:80 -v E:/workplace/docker-app/:/var/www/html php:apache
- 复制代码
在分离模式下启动容器后,你的终端将显示新容器的完整ID--类似于a70d25c2a7cedae673f8ab...如果你想停止这个容器,你可以使用docker stop命令,用容器的ID告诉Docker。比如说
- $ docker stop a70d25c2a7cedae673f8ab
- 复制代码
因为输入整个ID是很麻烦的,如果你愿意,Docker允许你只输入前三个或更多的字符。
- $ docker stop a70
- 复制代码
最后,我建议为你的容器命名。我们在本书后面的许多例子中都会这样做,因为用名字来记住一个容器比用随机分配的ID要容易得多,再加上ID是随机的,所以每次你运行一个新版本的容器时,它都会得到一个新的ID。只要不是已经有一个同名的容器,名字就可以多次发出来。为了给我们的新应用容器命名,我们可以用传入的--name标志重新创建它。
- $ docker run --privileged=true -d --rm --name=weather-app -p 38000:80 -v E:/workplace/docker-app/:/var/www/html php:apache
- 复制代码
在使用docker run命令时,还有许多可用的选项,所以你可能想更详细地阅读文档。在我们开发其余的应用程序时,我们会涉及其中的一些选项。
现在我们要引入高德的天气 SDK ,在使用该 SDK 之前你需要阅读高德开放平台-天气查询的技术文档,再添加 SDK 之前我们首先要确保所有现有的容器都停止了。
- $ docker ps //之后在运行 上面的命令停止容器
- docker stop 容器ID
- 复制代码
这个命令将列出所有正在运行的容器。你也可以通过添加-a标志来查看停止的容器。
如果有任何容器正在运行,那么在我们继续前进之前,使用docker stop 来停止它们。
执行命令添加高德天气 SDK,欢迎点赞+星。这是作者之前封装的SDK,当然你也可以自己重新封装或者用其他的天气 SDK,现在在你的终端运行:
- docker run --rm --interactive --tty -v E:/workplace/docker-app/weather-app:/app composer:latest require clydecn/php-amap-weather
- 复制代码
该命令将在你的项目中装新的软件包。在这个过程中,你应该在终端看到一些类似这样的输出。
- Using version ^1.0 for clydecn/php-amap-weather
- ./composer.json has been updated
- Running composer update clydecn/php-amap-weather
- Loading composer repositories with package information
- Updating dependencies
- Lock file operations: 7 installs, 0 updates, 0 removals
- - Locking clydecn/php-amap-weather (v1.0.0)
- - Locking guzzlehttp/guzzle (6.5.5)
- - Locking guzzlehttp/promises (1.5.1)
- - Locking guzzlehttp/psr7 (1.8.3)
- - Locking ralouphie/getallheaders (3.0.3)
- - Locking symfony/polyfill-intl-idn (v1.24.0)
- - Locking symfony/polyfill-intl-normalizer (v1.24.0)
- Writing lock file
- Installing dependencies from lock file (including require-dev)
- Package operations: 7 installs, 0 updates, 0 removals
- - Downloading symfony/polyfill-intl-normalizer (v1.24.0)
- - Downloading symfony/polyfill-intl-idn (v1.24.0)
- - Downloading ralouphie/getallheaders (3.0.3)
- - Downloading guzzlehttp/psr7 (1.8.3)
- - Downloading guzzlehttp/promises (1.5.1)
- - Downloading guzzlehttp/guzzle (6.5.5)
- - Downloading clydecn/php-amap-weather (v1.0.0)
- 0/7 [>---------------------------] 0% - Downloading symfony/polyfill-intl-idn (v1.24.0)
- - Downloading ralouphie/getallheaders (3.0.3)
- - Downloading guzzlehttp/psr7 (1.8.3)
- - Downloading clydecn/php-amap-weather (v1.0.0)
- - Downloading symfony/polyfill-intl-normalizer (v1.24.0)
- - Downloading guzzlehttp/promises (1.5.1)
- - Downloading guzzlehttp/guzzle (6.5.5)
- - Installing symfony/polyfill-intl-normalizer (v1.24.0): Extracting archive
- - Installing symfony/polyfill-intl-idn (v1.24.0): Extracting archive
- - Installing ralouphie/getallheaders (3.0.3): Extracting archive
- - Installing guzzlehttp/psr7 (1.8.3): Extracting archive
- - Installing guzzlehttp/promises (1.5.1): Extracting archive
- - Installing guzzlehttp/guzzle (6.5.5): Extracting archive
- - Installing clydecn/php-amap-weather (v1.0.0): Extracting archive
- 3 package suggestions were added by new dependencies, use `composer suggest` to see details.
- Generating autoload files
- > @php think service:discover
- Succeed!
- > @php think vendor:publish
- File /app/config/trace.php exist!
- Succeed!
- 10 packages you are using are looking for funding.
- Use the `composer fund` command to find out more!
- 复制代码
现在 SDK 已经安装完毕,可以使用了。
我们将使用刚刚添加的高德天气 SDK 来完善我们的业务逻辑,打开 controller 目录下的 Weather.php 添加以下内容:
- <?php
-
- namespace app\controller;
-
- use app\BaseController;
- use Clydecn\Amap\Weather as AmapWeather;
-
- class Weather extends BaseController
- {
- public $key;
- public $weather;
- // 初始化
- protected function initialize()
- {
- $this->key = "KEY"; // 高德 KEY
- $this->weather = new AmapWeather($this->key);
- }
-
- public function get()
- {
- $rid = $this->request->param('location_id','310000');
- // 查询当天天气
- $res = $this->weather->getLiveWeather($rid);
-
- return json($res,200);
- }
-
- public function delete()
- {
- // todo
- echo "location_id is ".$this->request->param('location_id');
- }
- }
- 复制代码
我们做了一些更新--主要是对引入天气 API 初始化天气类
我们的应用程序已经初步完成了向API传递一个真实的位置ID并返回一些数据。首先,使用这个高德位置查询找到一个位置ID。我使用的是上海的ID进行测试。310000,当然你直接传 上海 也是可以的。ok,让我们再次运行Docker容器。
- docker run -d --privileged=true --rm --name=weather-app -p 38000:80 -v E:/workplace/docker-app/:/var/www/html php:apache
- 复制代码
并在你的浏览器中访问正在运行的应用程序,地址是
http://localhost:38000/weather-app/public/index.php/weather/310000。你应该可以看到一个JSON数据,看起来像这样。
- {"status":"1","count":"1","info":"OK","infocode":"10000","lives":[{"province":"上海","city":"上海市","adcode":"310000","weather":"晴","temperature":"11","winddirection":"东","windpower":"≤3","humidity":"38","reporttime":"2022-02-14 14:01:45"}]}
- 复制代码
你的 Docker 化的 PHP 应用程序现在正从外部数据源返回真实数据,并在Apache中提供服务,但你可能会注意到,它的速度并不快(我的页面加载时间为1.92秒!)。
高德天气 API 是一个免费的服务,其他国家可能无法访问。为了解决这个问题,我们将把查询的数据保存在我们自己的 MySQL 数据库中,可以再下次访问的时候可以快速地响应。这将极大地提高性能,下个章节我们将学习如何用 Docker 将 MySql 与 PHP 应用程序相结合。
作者:一壶剑侠_情满天涯
链接:https://juejin.cn/post/7153131894995943431
来源:稀土掘金
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。
Copyright © 2003-2013 www.wpsshop.cn 版权所有,并保留所有权利。