第三章。创立一个 ThinkPHP 应用程序
在本教程的其余部分，咱们将基于 ThinkPHP 框架实现一个天气查问的利用。应用 高德开放平台-天气查问 的接口来实现咱们的性能。把查问数据缓存到 MySql 中，这样就不必每次频繁的申请第三方的接口了（有申请次数限度）
抉择高德开放平台-天气查问 API 次要是因为它是收费的。当然你也能够应用其余的第三方天气查问接口，看集体爱好。
该利用是一个非常简单的 REST API 利用，次要实现两个接口。
GET /weather/:location_id- 从数据库中获取天气（如果存在的话），如果不存在，则从 第三方接口获取。DELETE /weather/:location_id- 从数据库中删除已缓存的天气信息。再次查问该地点的天气时，将从高德的天气接口获取。
在咱们进行利用编码之前，首先应用 Docker 装置并运行 [ThinkPHP](https://www.kancloud.cn/manual/thinkphp6_0/1037479)装置 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/_/comp...）装置 ThinkPHP 。
$ docker run --rm --interactive --tty -v E:/workplace/docker-app/:/app composer:latest create-project topthink/think weather-app如果你查看weather-app/目录，你会看到 ThinkPHP 6 的我的项目目录，如下所示：
dirE:\workplace\docker-app\weather-app 的目录2022/02/11 16:31 <DIR> .2022/02/11 16:30 <DIR> ..2021/12/16 21:06 231 .example.env2021/12/16 21:06 34 .gitignore2021/12/16 21:06 2,038 .travis.yml2021/12/16 21:06 <DIR> app2021/12/16 21:06 1,094 composer.json2022/02/11 16:31 36,134 composer.lock2021/12/16 21:06 <DIR> config2021/12/16 21:06 <DIR> extend2021/12/16 21:06 1,822 LICENSE.txt2021/12/16 21:06 <DIR> public2021/12/16 21:06 1,459 README.md2021/12/16 21:06 <DIR> route2021/12/16 21:06 <DIR> runtime2021/12/16 21:06 180 think2022/02/11 16:31 <DIR> vendor2021/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 文件，内容如下：
<?phpnamespace 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来实现。
更多Docker运行选项
在 Detached 模式下运行
运行你的新网络应用程序的另一个抉择是在 "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 之前你须要浏览高德开放平台-天气查问的技术文档，再增加 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 updatedRunning composer update clydecn/php-amap-weatherLoading composer repositories with package informationUpdating dependenciesLock 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 fileInstalling 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 archive3 package suggestions were added by new dependencies, use `composer suggest` to see details.Generating autoload files> @php think service:discoverSucceed!> @php think vendor:publishFile /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 增加以下内容：
<?phpnamespace 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 应用程序相结合。