第三章。创建一个 ThinkPHP 应用程序

第三章。创建一个 ThinkPHP 应用程序

在本教程的其余部分，我们将基于 ThinkPHP 框架完成一个天气查询的应用。使用高德开放平台-天气查询的接口来实现我们的功能。把查询数据缓存到 MySql 中，这样就不用每次频繁的请求第三方的接口了（有请求次数限制）

选择高德开放平台-天气查询 API 主要是因为它是免费的。当然你也可以使用其他的第三方天气查询接口，看个人喜好。
该应用是一个非常简单的 REST API 应用，主要实现两个接口。

GET /weather/:location_id - 从数据库中获取天气（如果存在的话），如果不存在，则从第三方接口获取。
DELETE /weather/:location_id - 从数据库中删除已缓存的天气信息。再次查询该地点的天气时，将从高德的天气接口获取。

在我们进行应用编码之前，首先使用 Docker 安装并运行 ThinkPHP

安装 ThinkPHP Framework

ThinkPHP 是一个免费开源的，快速、简单的面向对象的轻量级PHP开发框架，是为了敏捷WEB应用开发和简化企业应用开发而诞生的。ThinkPHP从诞生以来一直秉承简洁实用的设计原则，在保持出色的性能和至简代码的同时，更注重易用性。遵循Apache2开源许可协议发布，意味着你可以免费使用ThinkPHP，甚至允许把你基于ThinkPHP开发的应用开源或商业产品发布/销售。
这就是为什么我选择它作为本教程的教学框架。我不想让你因为一个框架而放弃，但我也不想从头开始建立所有的东西，因为该教程的重点是Docker，而不是我们的PHP应用。

用Docker 创建 ThinkPHP 应用实际上比用本地配置PHP环境所需的操作少。并且为我们还需要使用 Composer，多亏了Docker，我们甚至不需要在主机上安装它。

首先打开你的终端，创建一个项目目录。

$ mkdir docker-app

并进入到该目录中

$ cd docker-app

现在使用[官方Composer Docker镜像]（https://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

创建 ThinkPHP 应用的过程中的命令梳理

我们的 docker 运行命令与第二章中的命令相似，但我们使用了不同的镜像。我们没有使用运行hello.php 脚本的 PHP 镜像，而是使用了一个 Composer 镜像。让我们来看看有什么变化。

composer:latest - 这表明我们在这个容器中使用的镜像。如果需要，你可以指定Composer的特定版本；只要查看Docker Hub上支持的镜像标签列表。
create-project topthink/think weather-app - 这是实际将 ThinkPHP 6 安装到容器工作目录中的命令。因为该工作目录是我们主机目录的一个卷，所以 composer 安装的文件现在在主机和容器中都存在。在这一点上，你的应用程序实际上没有做任何事情，但 ThinkPHP 6 已经被安装了，我们现在对 composer 在 Docker 中如何与 PHP 一起工作有了一些了解。

新建路由与 Controller （逻辑处理）文件

项目创建完成后，我们需要添加几个路由 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 应用程序。

运行 ThinkPHP 应用的命令梳理

这次我们使用的docker run命令与我们用来运行 hello.php 脚本和composer create-project ...的两个命令不同。原因是这次我们想获得包含 Apache 的最新版本的PHP，这样我们就可以为我们的 Web 应用提供服务。让我们更详细地了解新增的命令部分。

-p 38000:80 - 这里我们在容器和主机系统之间定义了端口映射。这个命令说Docker应该把容器上的80号端口映射到我们主机上的38000号端口。你可以在你的主机上选择任何有效的端口，但使用一个高的端口（10000以上）可能是一个好主意，因为许多低的端口被保留给大多数标准机器上的内置进程。对于容器，你必须*使用80端口，因为那是Docker镜像暴露的端口，Apache在上面运行。
—privileged=true - 容器内是否使用 root 权限
-v E:/workplace/docker-app/:/var/www/html - 这一次，我们将代码从主机挂载到容器的/var/www/html目录。原因是，PHP的Apache镜像是从这个目录中提供代码的。这是我们之前运行的PHP脚本之间的一个微妙但关键的区别。请务必仔细阅读官方PHP Docker镜像文档以避免遗漏这样的事情。
php:apache - 该镜像是官方的 PHP Apache 容器。它包含PHP和Apache（一种流行的Web服务器）在同一个容器中，允许你快速提供代码用于本地开发。当然你也可以选择是使用php:fpm镜像链接一个nginx的镜像，这些我不会在本书中介绍，需要你自己去了解。
最后，你会注意到，这次在镜像名称后面没有命令。这可能会让新的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来实现。

添加高德天气 SDK

现在我们要引入高德的天气 SDK ，在使用该 SDK 之前你需要阅读高德开放平台-天气查询的技术文档，再添加 SDK 之前我们首先要确保所有现有的容器都停止了。

$ docker ps   //之后在运行 上面的命令停止容器
docker stop 容器ID

这个命令将列出所有正在运行的容器。你也可以通过添加-a标志来查看停止的容器。
如果有任何容器正在运行，那么在我们继续前进之前，使用docker stop <ID>来停止它们。

添天气 SDK

执行命令添加高德天气 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 API

我们将使用刚刚添加的高德天气 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 初始化天气类

$this->weather=new AmapWeather($this->key); - 实例化天气API 类
$res=$this->weather->getLiveWeather('310000'); - 获取天气信息。
return json($res,200); - 最后，返回 Json 数据

测试

我们的应用程序已经初步完成了向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 应用程序相结合。

docker PHP 入门实践

Docker PHP 入门实践(三)

第三章。创建一个 ThinkPHP 应用程序

安装 ThinkPHP Framework

创建 ThinkPHP 应用的过程中的命令梳理

新建路由与 Controller （逻辑处理）文件

运行我们的应用程序

运行 ThinkPHP 应用的命令梳理

更多Docker运行选项

在 Detached 模式下运行

停止一个容器

命名容器

添加高德天气 SDK

添天气 SDK

调用 SDK API

解疑

测试

Docker PHP 入门实践(三)

第三章。创建一个 ThinkPHP 应用程序

安装 ThinkPHP Framework

创建 ThinkPHP 应用的过程中的命令梳理

新建路由与 Controller （逻辑处理） 文件

运行我们的应用程序

运行 ThinkPHP 应用的命令梳理

更多Docker运行选项

在 Detached 模式下运行

停止一个容器

命名容器

添加高德天气 SDK

添天气 SDK

调用 SDK API

解疑

测试

新建路由与 Controller （逻辑处理）文件