去年安装paddleOCR2.5使用正常,也记录了安装步骤文档,今天交接安装文档导致安装成功,OCR识别不生效,以及报错,并且更换服务器尝试也不行,估计是相关模块版本原因导致不能识别。

本次记录paddleOCR最新的2.6安装文档,记录遇到的问题。开撸！！！



基于PaddleHub部署CPU版本的PaddleOCR实操过程记录。

- PaddleOCR：release/2.6分支
- pip: 23.1.2
- PaddlePaddle 2.4.2
- Paddlehub 2.1.0

# 一、python安装

python 3.9.12安装(网上有更多教程，过)

## 二、预训练模型应用工具安装

```
#使用清华源或者阿里下载速度会快
python -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple paddlepaddle 

#执行完语句会提示升级pip,那就升级吧
python.exe -m pip install -i https://mirrors.aliyun.com/pypi/simple --upgrade pip  

pip install -i https://mirrors.aliyun.com/pypi/simple --default-timeout=100 paddlehub
```

# 三、PaddleOCR

## 1、拉取代码

```text
git clone https://github.com/PaddlePaddle/PaddleOCR
```

## 2、根目录创建文件夹,命名`inference`

## 3、安装所需环境

```
cd PaddleOCR-release-2.6/
pip install -i https://mirrors.aliyun.com/pypi/simple --default-timeout=100 -r requirements.txt
```

<a style="color:red;" href="#6">注意:执行此命令前,先看本章第六节,博主已踩坑，已完善!:rage:</a>

# 四、基于PaddleHub Serving的服务部署

hubserving服务部署目录下包括文本检测、文本方向分类，文本识别、文本检测+文本方向分类+文本识别3阶段串联，表格识别和PP-Structure六种服务包，请根据需求选择相应的服务包进行安装和启动。目录结构如下：
```
deploy/hubserving/
  └─  ocr_cls     文本方向分类模块服务包
  └─  ocr_det     文本检测模块服务包
  └─  ocr_rec     文本识别模块服务包
  └─  ocr_system  文本检测+文本方向分类+文本识别串联服务包
  └─  structure_table  表格识别服务包
  └─  structure_system  PP-Structure服务包
```

每个服务包下包含3个文件。以2阶段串联服务包为例，目录如下：
```
deploy/hubserving/ocr_system/
  └─  __init__.py    空文件，必选
  └─  config.json    配置文件，可选，使用配置启动服务时作为参数传入
  └─  module.py      主模块，必选，包含服务的完整逻辑
  └─  params.py      参数文件，必选，包含模型路径、前后处理参数等参数
```

**本片使用的ocr_system**

## 1、放入推理模型

安装服务模块前，需要准备推理模型,模型来自[官网](https://github.com/PaddlePaddle/PaddleOCR)中'PP-OCR系列模型列表（更新中）'

![image-20230427165341294](https://chensh888.com:8090/file/blog/2023/20230427165345.png)

推理模型并放到根目录`inference`文件夹。默认使用的是PP-OCRv3模型，默认模型路径为：

```
检测模型：./inference/ch_PP-OCRv3_det_infer/
识别模型：./inference/ch_PP-OCRv3_rec_infer/
方向分类器：./inference/ch_ppocr_mobile_v2.0_cls_infer/
表格结构识别模型：./inference/en_ppocr_mobile_v2.0_table_structure_infer/
```

**模型路径可在`\deploy\hubserving\ocr_system\params.py`中查看和修改。** 

## 2、安装服务模块

PaddleOCR提供5种服务模块，根据需要安装所需模块。

**在Windows环境下(文件夹的分隔符为`\`)，安装示例如下：**

```
# 安装检测+识别串联服务模块：
hub install deploy\hubserving\ocr_system\
```

## 3、启动服务

### 3.1.命令行命令启动（仅支持CPU,本人使用CPU）

**启动命令：**  

```shell
$ hub serving start --modules [Module1==Version1, Module2==Version2, ...] \
                    --port XXXX \
                    --use_multiprocess \
                    --workers \
```

**参数：**  

| 参数               | 用途                                                         |
| ------------------ | ------------------------------------------------------------ |
| --modules/-m       | PaddleHub Serving预安装模型，以多个Module==Version键值对的形式列出<br>*`当不指定Version时，默认选择最新版本`* |
| --port/-p          | 服务端口，默认为8866                                         |
| --use_multiprocess | 是否启用并发方式，默认为单进程方式，推荐多核CPU机器使用此方式<br>*`Windows操作系统只支持单进程方式`* |
| --workers          | 在并发方式下指定的并发任务数，默认为`2*cpu_count-1`，其中`cpu_count`为CPU核数 |

**简易启动串联服务：  ```hub serving start -m ocr_system```  **

这样就完成了一个服务化API的部署，使用默认端口号8866。

### 3.2.了解配置文件启动（支持CPU、GPU）

**启动命令：**  
```hub serving start -c config.json```  

其中，`config.json`格式如下：

```python
{
    "modules_info": {
        "ocr_system": {
            "init_args": {
                "version": "1.0.0",
                "use_gpu": true
            },
            "predict_args": {
            }
        }
    },
    "port": 8868,
    "use_multiprocess": false,
    "workers": 2
}
```

- `init_args`中的可配参数与`module.py`中的`_initialize`函数接口一致。其中，**当`use_gpu`为`true`时，表示使用GPU启动服务**。  
- `predict_args`中的可配参数与`module.py`中的`predict`函数接口一致。

**注意:**  

- 使用配置文件启动服务时，其他参数会被忽略。
- 如果使用GPU预测(即，`use_gpu`置为`true`)，则需要在启动服务之前，设置CUDA_VISIBLE_DEVICES环境变量，如：```export CUDA_VISIBLE_DEVICES=0```，否则不用设置。
- **`use_gpu`不可与`use_multiprocess`同时为`true`**。

如，使用GPU 3号卡启动串联服务：  

```shell
export CUDA_VISIBLE_DEVICES=3
hub serving start -c deploy/hubserving/ocr_system/config.json
```

# 五、文字识别测试

进入PaddleOCR\tools目录，为了简单起见，在目录下放入一张命名为1.jpg的图片,在命令行执行命令：

```
python test_hubserving.py http://127.0.0.1:8866/predict/ocr_rec 1.jpg
```

# 六、问题关键点

<span id="6"></span>

## 1、numpy

使用文字识别测试时报错如下:

```
{'msg': "module 'numpy' has no attribute 'int'.\nnp.int was a deprecated alias for the builtin int. To avoid
this error in existing code, use int by itself. Doing this will not modify any behavior and is safe. When 
replacing np.int, you may wish to use e.g. np.int64 or np.int32 to specify the precision. If you wish to 
review your current use, check the release note link for additional information.\nThe aliases was originally
deprecated in NumPy 1.20; for more details and guidance see the original release note at:\n    
https://numpy.org/devdocs/release/1.20.0-notes.html#deprecations", 'results': '', 'status': '101'}
```

**解决方案:**

numpy降级，修改requirements.txt中的numpy改为:numpy==1.23.3

## 2、Polygon3

正常安装报错如下:

```
error:subprocess-exited-with-error
python setuppy bdist_wheel did not run successfully.
exit code: 1
	[14 Lines of output]
	Using NumPy extension!
	running bdist_wheel
	runningbuild
	runningbuild_py
	creating build
	creatingbuild\lib.win-amd64-cpython-39
	creating build\lib.win-amd64-cpython-39\Polygon
	copying Polygon\Io.py -> build\lib.win-amd64-cpython-39\Polygon
	copying Polygon\shapes.py -> build\lib.win-amd64-cpython-39\Polygon
	copying Polygon\utils.py -> buildlib.win-amd64-cpython-39\Polygon
	copying Polygon-_init_-.py -> build\lib.win-amd64-cpython-39\Polygon
	running build_ext
	building 'Polygon.cPolygon' extensionerror: Microsoft Visual C++ 14. or greater is required. Get it with "Microsoft C++ Build Tools"
: https://visualstudio.microsoft.com/visual-cpp-build-tools/
	[end of output]
```

**解决方案:**

**步骤1:** 手动安装 Polygon3，[下载whl文件](https://www.lfd.uci.edu/~gohlke/pythonlibs/)(进入此网站搜索`polygon3`)

**步骤2:** cmd命令，进行本地pip。

```
pip install 文件路径\Polygon3-3.0.9.1-cp39-cp39-win_amd64.whl
```

## 3、lanms-neo==1.0.2

正常安装报错,No module named lanms

解决方案: 安装C++的桌面开发,[下载C++工具](https://visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools/)(国内网站下载速度堪忧,建议爬梯)，安装好后打开，勾选C++桌面开发。

![image-20230505094704499](https://chensh888.com:8090/file/blog/2023/20230505095952.png)

paddleOCR服务搭建,并使用java调用

主题:[hexo数学家](https://zhwangart.com/)添加Waline评论。


# 一、主题添加Waline评论

## 1、安装依赖

```
在Hexo目录执行 
npm install @waline/hexo-next
```

2、主题config配置添加

[waline属性官网网址](https://waline.js.org/reference/client/props.html#serverurl)

```
waline:
  enable: true  #是否开启
  el: 'vcomments'      # Valine 的初始化挂载器，无需更改
  serverURL: http://自己的域名:8360 # Waline #服务端地址，我们这里就是上面部署的 Vercel 地址
  placeholder: 请文明评论呀 # #评论框的默认文字
  avatar: mm # 头像风格
  meta: [nick, mail, link] # 自定义评论框上面的三个输入框的内容
  pageSize: 10 # 评论数量多少时显示分页
  lang: zh-cn # 语言, 可选值: en, zh-cn
  # Warning: 不要同时启用 `waline.visitor` 以及 `leancloud_visitors`.
  visitor: false # 文章阅读统计
  comment_count: true # 如果为 false , 评论数量只会在当前评论页面显示, 主页则不显示
  requiredFields: [] # 设置用户评论时必填的信息，[nick,mail]: [nick] | [nick, mail]
  libUrl: # Set custom library cdn url
```

3、创建ejs文件

themes\ocean\layout\_partial\post\waline.ejs

```
<% if (theme.waline.enable) { %>
<div class="vcomments" id="<%- theme.waline.el %>"></div>
<%- js('//unpkg.com/@waline/client@v2/dist/waline.js') %>
<link href='//unpkg.com/@waline/client@v2/dist/waline.css' rel='stylesheet' />
<script>
  Waline.init({
    el: '#<%- theme.waline.el %>',
	serverURL: '<%- theme.waline.serverURL%>',
    avatar: '<%- theme.waline.avatar %>',
    //meta: [<%- theme.waline.requiredFields %>],
	requiredMeta: ['mail'], #直接在这个文件赋值,否则引入变量不会带单引号
	wordLimit: <%- theme.waline.wordLimit %>,
	pageSize: '<%- theme.waline.pageSize %>',
	lang: '<%- theme.waline.lang %>',
	visitor: '<%- theme.waline.visitor %>',
	comment_count: '<%- theme.waline.comment_count %>',
    placeholder: '<%- theme.waline.placeholder %>'
	
  })
</script>
<% } %>
```

4、页面最下方显示评论

ocean\layout\_partial\article.ejs

```
  <% if (is_post()) { %>
  <%- partial('post/waline') %>
  <%- partial('post/valine') %>
  <%- partial('post/gitalk') %>
  <%} %>
```

# 二、Waline

## 1.MYSQL

### 1.1.导入库waline.sql

这里在服务器的mysql中创建库

```
CREATE DATABASE waline DEFAULT CHARACTER SET utf8mb4;

CREATE TABLE `wl_Comment` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `user_id` int(11) DEFAULT NULL,
  `comment` text,
  `insertedAt` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `ip` varchar(100) DEFAULT '',
  `link` varchar(255) DEFAULT NULL,
  `mail` varchar(255) DEFAULT NULL,
  `nick` varchar(255) DEFAULT NULL,
  `pid` int(11) DEFAULT NULL,
  `rid` int(11) DEFAULT NULL,
  `sticky` int(11) DEFAULT NULL,
  `status` varchar(50) NOT NULL DEFAULT '',
  `ua` text,
  `url` varchar(255) DEFAULT NULL,
  `createdAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  `updatedAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `wl_Counter` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `time` int(11) DEFAULT NULL,
  `url` varchar(255) NOT NULL DEFAULT '',
  `createdAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  `updatedAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

CREATE TABLE `wl_Users` (
  `id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `display_name` varchar(255) NOT NULL DEFAULT '',
  `email` varchar(255) NOT NULL DEFAULT '',
  `password` varchar(255) NOT NULL DEFAULT '',
  `type` varchar(50) NOT NULL DEFAULT '',
  `url` varchar(255) DEFAULT NULL,
  `avatar` varchar(255) DEFAULT NULL,
  `github` varchar(255) DEFAULT NULL,
  `twitter` varchar(255) DEFAULT NULL,
  `facebook` varchar(255) DEFAULT NULL,
  `google` varchar(255) DEFAULT NULL,
  `weibo` varchar(255) DEFAULT NULL,
  `qq` varchar(255) DEFAULT NULL,
  `createdAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  `updatedAt` timestamp NULL DEFAULT CURRENT_TIMESTAMP,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
```

## 2.docker

### 2.1.拉取镜像

```
docker pull lizheming/waline:latest  #拉取镜像
```

### 2.2.启动并运行

点击[官网](https://console.leancloud.cn/login)注册,并且绑定安全域名

```
//参数在官网:https://waline.js.org/reference/server/config.html#disallowiplist

docker run -d --name waline -p 8360:8360
-v /software/docker/waline-blog:/app/data  #挂在镜像
-e TZ="Asia/Shanghai"
-e MYSQL_HOST="192.168.1.88"	#MYSQL ip
-e MYSQL_DB="waline"			#MYSQL 库名
-e MYSQL_USER="**"				#MYSQL 用户名
-e MYSQL_PASSWORD="**"			#MYSQL 密码
-e AUTHOR_EMAIL="**@qq.com"		#发送邮箱
-e SITE_NAME="陈少华的博客"		
-e SENDER_NAME="博客留言"
-e SITE_URL="www.chensh888.com" #博客地址
-e SMTP_SERVICE="QQ"			#发送邮箱类型
-e SMTP_USER="**@qq.com"		#发送邮箱
-e SMTP_PASS="**" 				#QQ特有的第三TOKEN
-e SECURE_DOMAINS='chensh888.com,www.chensh888.com' #生效博客域名
-e DISABLE_USERAGENT="false"
-e IPQPS="30"
--restart always
lizheming/waline:latest
```

根据容器中的源码查看的参数如下，请根据实际与官网比对填写。

```
module.exports = {
  workers: 1,
  storage,
  jwtKey,
  forbiddenWords,
  disallowIPList: [],
  secureDomains: SECURE_DOMAINS ? SECURE_DOMAINS.split(/\s*,\s*/) : undefined,
  disableUserAgent: DISABLE_USERAGENT && !isFalse(DISABLE_USERAGENT),
  disableRegion: DISABLE_REGION && !isFalse(DISABLE_REGION),
  levels:
    !LEVELS || isFalse(LEVELS)
      ? false
      : LEVELS.split(/\s*,\s*/).map((v) => Number(v)),
  avatarProxy,
  oauthUrl,
  markdown,
  mailSubject: MAIL_SUBJECT,
  mailTemplate: MAIL_TEMPLATE,
  mailSubjectAdmin: MAIL_SUBJECT_ADMIN,
  mailTemplateAdmin: MAIL_TEMPLATE_ADMIN,
  QQTemplate: QQ_TEMPLATE,
  TGTemplate: TG_TEMPLATE,
  WXTemplate: WX_TEMPLATE,
  DiscordTemplate: DISCORD_TEMPLATE,
  LarkTemplate: LARK_TEMPLATE,
};
```

Hexo添加Waline评论

-  页面导航
-  页面事件
-  生命周期
-  WXS 脚本



# 一、页面导航

## 1.什么是页面导航

页面导航指的是页面之间的相互跳转。例如，浏览器中实现页面导航的方式有如下两种：

- `<a>` 链接
- `location.href`

## 2.小程序中实现页面导航的两种方式
- 声明式导航
  - 在页面上声明一个 `<navigator>` 导航组件
  - 通过点击` <navigator>` 组件实现页面跳转
- 编程式导航
  - 调用小程序的导航 API，实现页面的跳转

## 3.声明式导航

### 3.1.导航到 tabBar 页面
tabBar 页面指的是被配置为 tabBar 的页面。
在使用 `<navigator>` 组件跳转到指定的 tabBar 页面时，需要指定 url 属性和 open-type 属性，其中：

- url 表示要跳转的页面的地址，必须以 / 开头

- open-type 表示跳转的方式，必须为 switchTab

**示例代码如下：**

```
<navigator url="/pages/message/message" open-type="switchTab">声明式跳转消息</navigator>
```

### 3.2.导航到非 tabBar 页面
非 tabBar 页面指的是没有被配置为 tabBar 的页面。
在使用 `<navigator>` 组件跳转到普通的非 tabBar 页面时，则需要指定 url 属性和 open-type 属性，其中：

- url 表示要跳转的页面的地址，必须以 / 开头
- open-type 表示跳转的方式，必须为 navigate

**示例代码如下：**

```
# 注意：为了简便，在导航到非 tabBar 页面时，open-type="navigate" 属性可以省略。
<navigator url="/pages/info/info" open-type="navigate">声明式跳转info</navigator>
```

### 3.3.后退导航
如果要后退到上一页面或多级页面，则需要指定 open-type 属性和 delta 属性，其中：
- open-type 的值必须是 navigateBack，表示要进行后退导航
- delta 的值必须是数字，表示要后退的层级

**示例代码如下：**

```
# 注意：为了简便，如果只是后退到上一页面，则可以省略 delta 属性，因为其默认值就是 1。
<navigator open-type="navigateBack" delta="1">声明式返回上一页</navigator>
```

## 4.编程式导航
### 4.1.导航到 tabBar 页面

调用 wx.switchTab(Object object) 方法，可以跳转到 tabBar 页面。其中 Object 参数对象的属性列表如下：

表格来源: [小程序官网switchTab](https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.switchTab.html)

| 属性     | 类型     | 默认值 | 必填 | 说明                                                         |
| :------- | :------- | :----- | :--- | :----------------------------------------------------------- |
| url      | string   |        | 是   | 需要跳转的 tabBar 页面的路径 (代码包路径)（需在 app.json 的 [tabBar](https://developers.weixin.qq.com/miniprogram/dev/reference/configuration/app.html#tabbar) 字段定义的页面），路径后不能带参数。 |
| success  | function |        | 否   | 接口调用成功的回调函数                                       |
| fail     | function |        | 否   | 接口调用失败的回调函数                                       |
| complete | function |        | 否   | 接口调用结束的回调函数（调用成功、失败都会执行）             |

**示例代码如下：**

```
// 页面标签
<button bindtap="skipMessage" type="primary" >编程式跳转消息</button>

 /**
  * 通过编程式跳转到message页面
  */
 skipMessage(){
   wx.switchTab({
     url: '/pages/message/message',
   })
 },
```

### 4.2.导航到非 tabBar 页面
调用 wx.navigateTo(Object object) 方法，可以跳转到非 tabBar 的页面。其中 Object 参数对象的属性列表如下：

表格来源: [小程序官网navigateTo](https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.navigateTo.html)

| 属性      | 类型     | 默认值 | 必填 | 说明                                                         |
| :-------- | :------- | :----- | :--- | :----------------------------------------------------------- |
| url       | string   |        | 是   | 需要跳转的应用内非 tabBar 的页面的路径 (代码包路径), 路径后可以带参数。参数与路径之间使用 `?` 分隔，参数键与参数值用 `=` 相连，不同参数用 `&` 分隔；如 'path?key=value&key2=value2' |
| events    | Object   |        | 否   | 页面间通信接口，用于监听被打开页面发送到当前页面的数据。基础库 2.7.3 开始支持。 |
| routeType | string   |        | 是   | 2.29.2 自定义路由类型，相关文档 [自定义路由](https://developers.weixin.qq.com/miniprogram/dev/framework/runtime/skyline/custom-route.html) |
| success   | function |        | 否   | 接口调用成功的回调函数                                       |
| fail      | function |        | 否   | 接口调用失败的回调函数                                       |
| complete  | function |        | 否   | 接口调用结束的回调函数（调用成功、失败都会执行）             |

**示例代码如下：**

```
// 页面标签
<button bindtap="skipInfo" type="primary" plain>编程式跳转info</button>

  /**
   * 通过编程式跳转到Info页面
   */
  skipInfo(){
    wx.navigateTo({
      url: '/pages/info/info'
    })
  },
```

### 4.3.后退导航
调用 wx.navigateBack(Object object) 方法，可以返回上一页面或多级页面。其中 Object 参数对象可选的属性列表如下：

表格来源: [小程序官网navigateBack](https://developers.weixin.qq.com/miniprogram/dev/api/route/wx.navigateBack.html)

| 属性     | 类型     | 默认值 | 必填 | 说明                                                    |
| :------- | :------- | :----- | :--- | :------------------------------------------------------ |
| delta    | number   | 1      | 否   | 返回的页面数，如果 delta 大于现有页面数，则返回到首页。 |
| success  | function |        | 否   | 接口调用成功的回调函数                                  |
| fail     | function |        | 否   | 接口调用失败的回调函数                                  |
| complete | function |        | 否   | 接口调用结束的回调函数（调用成功、失败都会执行）        |

**示例代码如下：**

```
// 页面标签
<button bindtap="skipBack" type="primary" >编程式跳转info</button>
  /**
   * 编程式导航，返回上一层
   */
  skipBack(){
    wx.navigateBack({
      delta:1,
      success: (res) => {
        console.log("成功打印");
      }
    })
  },
```

## 5.导航传参

### 5.1.声明式、编程式导航传参一致

 url 路径的后面可以携带参数：

- 参数与路径之间使用 `?` 分隔
- 参数键与参数值用` =` 相连
- 不同参数用 `&` 分隔

**示例代码如下：**

```
/pages/info/info?name=张三&age=18
```

### 5.2.在 onLoad 中接收导航参数
通过声明式导航传参或编程式导航传参所携带的参数，可以直接在 onLoad 事件中直接获取到，示例代码如下：

```
  /**
   * 生命周期函数--监听页面加载
   */
  onLoad(options) {
    console.log(options);
  },
```

# 二、页面事件

## 1.下拉刷新事件

### 1.1.什么是下拉刷新
**下拉刷新**是移动端的专有名词，指的是通过手指在屏幕上的下拉滑动操作，从而**重新加载页面数据**的行为。

### 1.2. 启用下拉刷新
**启用下拉刷新有两种方式**：

- 全局开启下拉刷新
  - 在 app.json 的 window 节点中，将 `enablePullDownRefresh` 设置为 true

- 局部开启下拉刷新
  - 在页面的 .json 配置文件中，将 `enablePullDownRefresh` 设置为 true



在实际开发中，推荐使用第 2 种方式，为需要的页面单独开启下拉刷新的效果。

### 1.3.配置下拉刷新窗口的样式
在全局或页面的 .json 配置文件中，通过 `backgroundColor `和 `backgroundTextStyle `来配置下拉刷新窗口的样式，其中：

- `backgroundColor `用来配置下拉刷新**窗口的背景颜色**，仅支持16 进制的颜色值
- `backgroundTextStyle `用来配置下拉刷新 **loading 的样式**，仅支持 dark 和 light

### 1.4.监听页面的下拉刷新事件
在页面的 .js 文件中，通过 onPullDownRefresh() 函数即可监听当前页面的下拉刷新事件。

例如，在页面的 wxml 中有如下的 UI 结构，点击按钮可以让 count 值自增 +1：

```
# 页面标签
<view>
 count值是: {{ count }}
</view>
<button bindtap="addCount">+1</button>

/**
 * 点击 count + 1
 */
addCount(){
  this.setData({
    count: this.data.count + 1
  });
},
```

在触发页面的下拉刷新事件的时候，如果要把 count 的值重置为 0，示例代码如下：

```
/**
 * 页面相关事件处理函数--监听用户下拉动作
 */
onPullDownRefresh() {
  console.log("触发了下拉刷新");
  this.setData({
    count: 0
  });
},
```

### 1.5.停止下拉刷新的效果
当处理完下拉刷新后，下拉刷新的 loading 效果会一直显示，不会主动消失，所以需要手动隐藏下拉刷新的loading 效果。此时，调用 `wx.stopPullDownRefresh()` 可以停止当前页面的下拉刷新。示例代码如下：

```
/**
 * 页面相关事件处理函数--监听用户下拉动作
 */
onPullDownRefresh() {
  console.log("触发了下拉刷新");
  this.setData({
    count: 0
  });
  //当数据修改完成后,关闭下拉框
  wx.stopPullDownRefresh();
},
```

## 2.上拉触底事件
### 2.1.什么是上拉触底
**上拉触底**是移动端的专有名词，通过手指在屏幕上的上拉滑动操作，从而**加载更多数据**的行为。

### 2.2.监听页面的上拉触底事件
在页面的 .js 文件中，通过 `onReachBottom() `函数即可监听当前页面的上拉触底事件。示例代码如下：

```
/**
 * 页面上拉触底事件的处理函数
 */
onReachBottom() {
  console.log("出发了上拉触底的事件");
},
```

### 2.3.配置上拉触底距离
上拉触底距离指的是触发上拉触底事件时，滚动条距离页面底部的距离。  
可以在全局或页面的 .json 配置文件中，通过 `onReachBottomDistance `属性来配置上拉触底的距离。  
小程序默认的触底距离是 50px，在实际开发中，可以根据自己的需求修改这个默认值。  

### 2.4.上拉触发案例

点击tabBar初始化随机10个颜色卡片展示,每当上拉触底新的随机10个颜色。效果如下:

<img src="https://chensh888.com:8090/file/blog/2023/20230413132953.png" alt="image-20230413132838589" style="zoom: 67%;" />

**案例的实现步骤:**

1. 定义获取随机颜色的方法
1. 在页面加载时获取初始数据
1. 渲染 UI 结构并美化页面效果
1. 在上拉触底时调用获取随机颜色的方法
1. 添加 loading 提示效果
1. 对上拉触底进行节流处理

**最终代码:**

页面元素、样式(.wxml、.wxss):

```

<view wx:for="{{ colorList}}" wx:key="index" style="background-color: rgba({{item}},0.3);" class="num-item">
  {{item}}
</view>

.num-item{
  border: 1rpx solid #efefef;
  border-radius: 8rpx;
  line-height: 200rpx;
  margin: 15rpx;
  text-align: center;
  text-shadow: 0rpx 0rpx 5rpx #fff;
  box-shadow:  0rpx 0rpx 5rpx #aaa;
}
```

.js方法:

```
  /**
   * 页面的初始数据
   */
  data: {
    //存放颜色
    colorList:[],
    //loding效果
    isLoding: false
  },
    /**
   * 获取颜色数据
   */
  getColors(){
    this.setData({
      isLoding: true
    });
    wx.showLoading({
      title: '数据加载中...',
    });
    wx.request({
      url: 'https://www.escook.cn/api/color',
      method:'GET',
      success: ({
          data: res
        }) => {
        console.log(res);
        this.setData({
          //es6语法 2个数组合并
          colorList: [...this.data.colorList,...res.data]
        });
      },
      complete: (res) =>{
        wx.hideLoading();
        this.setData({
          isLoding: false
        });
      }
    })
  },
  /**
   * 生命周期函数--监听页面加载
   */
  onLoad(options) {
    this.getColors();
  },
  /**
   * 页面上拉触底事件的处理函数
   */
  onReachBottom() {
    if(this.data.isLoding)return;
    this.getColors();
  },
```

# 三、生命周期

## 1.什么是生命周期
**生命周期（Life Cycle）**是指一个对象从**创建 -> 运行 -> 销毁**的整个阶段，**强调的是一个时间段**。例如：

- 张三**出生**，表示这个人**生命周期的开始**
- 张三**离世**，表示这个人**生命周期的结束**
- 中间张三的一生，就是张三的生命周期

**我们可以把每个小程序运行的过程，也概括为生命周期：**

- 小程序的**启动**，表示**生命周期的开始**
- 小程序的关闭，表示**生命周期的结束**
- 中间小程序运行的过程，就是小程序的生命周期

## 2.生命周期的分类
在小程序中，生命周期分为两类，分别是：

- **应用生命周期**
  - 特指小程序从启动 -> 运行 -> 销毁的过程
  
- **页面生命周期**
  - 特指小程序中，每个页面的加载 -> 渲染 -> 销毁的过程

其中，**页面**的生命周期**范围较小**，**应用程序**的生命周期**范围较大**，如图所示：

![image-20230413134534285](https://chensh888.com:8090/file/blog/2023/20230413134537.png)

## 3.什么是生命周期函数
**生命周期函数：**是由小程序框架提供的**内置函数**，会伴随着生命周期，**自动按次序执行**。
**生命周期函数的作用：**允许程序员**在特定的时间点，执行某些特定的操作**。例如，页面刚加载的时候，可以在onLoad 生命周期函数中初始化页面的数据。

**注意：生命周期强调的是时间段，生命周期函数强调的是时间点。**

## 4.生命周期函数的分类
小程序中的生命周期函数分为两类，分别是：

- **应用的生命周期函数**
  - 特指小程序从启动 -> 运行 -> 销毁期间依次调用的那些函数
- **页面的生命周期函数**
  - 特指小程序中，每个页面从加载 -> 渲染 -> 销毁期间依次调用的那些函数

## 5.应用的生命周期函数
小程序的应用生命周期函数需要在 app.js 中进行声明，示例代码如下：

```
// app.js
App({

  /**
   * 当小程序初始化完成时，会触发 onLaunch（全局只触发一次）
   */
  onLaunch: function () {},

  /**
   * 当小程序启动，或从后台进入前台显示，会触发 onShow
   */
  onShow: function (options) {},

  /**
   * 当小程序从前台进入后台，会触发 onHide
   */
  onHide: function () {},
})
```

## 6.页面的生命周期函数
小程序的页面生命周期函数需要在页面的 .js 文件中进行声明，示例代码如下：

```
// pages/message/message.js
Page({

  /**
   * 生命周期函数--监听页面加载
   * 一个页面只调用1次
   */
  onLoad(options) {},

  /**
   * 生命周期函数--监听页面初次渲染完成
   * 一个页面只调用1次
   */
  onReady() {},

  /**
   * 生命周期函数--监听页面显示
   */
  onShow() {},

  /**
   * 生命周期函数--监听页面隐藏
   */
  onHide() {},

  /**
   * 生命周期函数--监听页面卸载
   * 一个页面只调用1次
   */
  onUnload() {},
})
```

# 四、WXS 脚本

## 1.概述
### 1.1.什么是 wxs
WXS（WeiXin Script）是小程序独有的一套脚本语言，结合 WXML，可以构建出页面的结构。

### 1.2.wxs 的应用场景
wxml 中无法调用在页面的 .js 中定义的函数，但是，wxml 中可以调用 wxs 中定义的函数。因此，小程序中wxs 的典型应用场景就是"过滤器"。

### 1.3.wxs 和 JavaScript 的关系*
虽然 wxs 的语法类似于 JavaScript，但是 wxs 和 JavaScript 是完全不同的两种语言：

- **wxs 有自己的数据类型**
  - *number* 数值类型、*string* 字符串类型、*boolean* 布尔类型、*object *对象类型、
  - *function* 函数类型、*array* 数组类型、 *date* 日期类型、 *regexp* 正则
- **wxs 不支持类似于 ES6 及以上的语法形式**
  - *不支持*：let、const、解构赋值、展开运算符、箭头函数、对象属性简写、etc...
  - *支持*：var 定义变量、普通 function 函数等类似于 ES5 的语法
- **wxs 遵循 CommonJS 规范**
  - *module* 对象
  - *require()*函数module.exports 对象
  - *module.exports* 对象

## 2.基础语法
### 2.1.内嵌 wxs 脚本
wxs 代码可以编写在 wxml 文件中的` <wxs>` 标签内，就像 Javascript 代码可以编写在 html 文件中的 `<script> `标签内一样。
wxml 文件中的每个` <wxs></wxs> `标签，**必须提供 module 属性**，用来指定**当前 wxs 的模块名称**，方便在
wxml 中访问模块中的成员：

```

<view>
  {{m1.toUpper(userName)}}
</view>

<wxs module="m1">
    module.exports.toUpper = function(str){
      return str.toUpperCase();
    }
</wxs>
```

### 2.2.定义外联的 wxs 脚本
wxs 代码还可以编写在以 .wxs 为后缀名的文件内，就像 javascript 代码可以编写在以 .js 为后缀名的文件中一样。示例代码如下：

**一般创建到根目录中的utils文件夹中:**

```
function toLower(str){
  return str.toLowerCase();
}

module.exports = {
  toLower : toLower
}
```

### 2.3.使用外联的 wxs 脚本
在 wxml 中引入外联的 wxs 脚本时，必须为 <wxs> 标签添加 module 和 src 属性，其中：
- module 用来指定模块的名称
- src 用来指定要引入的脚本的路径，且必须是相对路径

示例代码如下：

```
<view> {{m2.toLower(userName)}} </view>

<wxs module="m2" src="/utils/tools.wxs"></wxs>
```

## 3.WXS 的特点
### 3.1.与 JavaScript 不同
为了降低 wxs（WeiXin Script）的学习成本， wxs 语言在设计时借大量鉴了 JavaScript 的语法。但是本质上，wxs 和 JavaScript 是完全不同的两种语言！

### 3.2.不能作为组件的事件回调
wxs 典型的应用场景就是**"过滤器"，经常配合 Mustache 语法进行使用**，例如：

```
<view > {{m2.toLower(userName)}} </view>
```

但是，在 wxs 中定义的函数**不能作为组件的事件回调函数**。例如，下面的用法是错误的：

```
<button bindtap="m2.toLower">按钮</button>
```

### 3.3.隔离性
**隔离性**指的是 wxs 的运行环境和其他 JavaScript 代码是隔离的。体现在如下两方面：

- wxs 不能调用 js 中定义的函数
- wxs 不能调用小程序提供的 API

### 3.4.性能好
- 在 **iOS 设备**上，小程序内的 **WXS** 会比 JavaScript 代码**快 2 ~ 20 倍**
- 在 **android 设备**上，二者的运行效率**无差异**

微信小程序-视图与逻辑

Docker Compose部署多个应用实战练习部署nginx和jar包。

部署项目为若依的前后端分离项目,前端使用vue+nginx部署。后端springBoot，以jar包部署。



# 一丶准备资源

文件列表:

- app
  - app.jar
- nginx
  - cong
  - html
  - log
- docker-compose.yml

# 二、配置nginx

&emsp;首先nginx配置文件请根据我的{% post_link 运维/docker/4、Docker安装软件 docker安装nginx文章%}，3个文件夹保存到宿主机中，分别为:conf、html、log

&emsp;nginx配置文件根据自己实际测试项目配置，不会的百度的nginx部署vue项目。

# 三、编写docker-compose.yml

问题: 在反复部署中我遇到后端服务port 端口不生效

解决:加入了`stdin_open`、`tty` 。其中 `stdin_open` 相当于 `run` 命令中的 `-d`,其中 `tty` 相当于 `run` 命令中的 `-i`

```yml
version: '3'        # 自定义版本号，一般是2，3
services:
    #前端 nginx
    my-nginx-pro1: # 服务名称
        image: nginx # 创建容器时所需的镜像
        container_name: my-nginx-pro1 # 容器名称，默认为"工程名称_服务条目名称_序号"
        restart: "always" #重启策略，能够使服务保持始终运行，生产环境推荐使用
        volumes:
            # :号左边是宿主机的nginx的文件路径，右边是nginx容器的文件路径
            - /mymkdir/softwore/docker/test/nginx/conf/nginx.conf:/etc/nginx/nginx.conf
            - /mymkdir/softwore/docker/test/nginx/conf/conf.d:/etc/nginx/conf.d
            - /mymkdir/softwore/docker/test/nginx/log:/var/log/nginx
            - /mymkdir/softwore/docker/test/nginx/html:/usr/share/nginx/html
        ports: # 宿主机与容器的端口映射关系
            - "8080:8080" # 左边宿主机端口:右边容器端口
        networks: # 配置容器连接的网络，引用顶级 networks 下的条目
            data_security:
                ipv4_address: 192.128.0.2
        privileged: true      # 这个必须要，解决nginx的文件调用的权限问题
    #后端
    my-web-pro1:	# 服务名称
        image: openjdk:8  # 创建容器时所需的镜像
        container_name: my-web-pro1 # 容器名称，默认为"工程名称_服务条目名称_序号"
        ports: # 宿主机与容器的端口映射关系
            - '8090:8090' # 左边宿主机端口:右边容器端口
        restart: "always" #重启策略，能够使服务保持始终运行，生产环境推荐使用
        volumes:
            - ./app:/app
        # jar 包名称必须改成你自己的
        command: java -Duser.timezone=GMT+8 -jar /app/app.jar
        #build: . #表示以当前目录下的Dockerfile开始构建镜像
        networks:	# 配置容器连接的网络，引用顶级 networks 下的条目
            data_security:
                ipv4_address: 192.128.0.3
        stdin_open: true #stdin_open相当于run命令中的-d
        tty: true #tty相当于run命令中的-i
#网络服务
networks:
    data_security:      # 自定义网络名字
        driver: bridge	  # 网络模式，默认为 bridge
        ipam:
            config:
                - subnet: 192.128.0.0/16           #自定义固定容器ip 实现容器间通讯，增强docker-compose项目可移植性

```

# 四、执行部署

```shell
#执行部署 建议使用-d后台执行
[root@MiWiFi-RA81-srv test]# docker-compose up -d
[+] Running 2/2
 ⠿ Container my-web-pro1    Started                                                                                         1.1s
 ⠿ Container my-nginx-pro1  Started
 #执行完成之后 查看容器是否启动
 [root@MiWiFi-RA81-srv test]# docker ps
 #部署失败执行删除所有容器继续重来
[root@MiWiFi-RA81-srv test]# docker rm -f $(docker ps -aq)
```

# 五、浏览器查看

![image-20230322214840203](https://chensh888.com:8090/file/blog/2023/20230322214843.png)

Docker Compose+nginx+jar部署

-  网络数据请求



# 一、WXML 模板语法

## 1、发起 GET 请求

调用微信小程序提供的 wx.request() 方法，可以发起 GET 数据请求，示例代码如下：

```
wx.request({
      url: 'http://localhost/ceshi',
      method:'GET',
      //拼接在URL后中
      parm:{
          name: '张三'
        },  
      data:{
        age: 18
      },
      success:(res)=>{
        console.log("成功!");
      },
      fail:(res)=>{
        console.log(res);
      },
    })
```

## 2、发起 POST请求

```
wx.request({
      url: 'http://localhost/ceshi',
      method:'POST',
      //拼接在URL后中
      parm:{
          name: '张三'
        },  
      data:{
        age: 18
      },
      success:(res)=>{
        console.log("成功!");
      },
      fail:(res)=>{
        console.log(res);
      },
    })
```

## 3、小程序中网络数据请求的限制

出于安全性方面的考虑，小程序官方对数据接口的请求做出了如下

两个限制：

① 只能请求 HTTPS 类型的接口

② 必须将接口的域名添加到信任列表中



**注**:跳过 request 合法域名校验的选项，仅限在开发与调试阶段使用！

![image-20230213143426238](https://chensh888.com:8090/file/blog/2023/20230213143428.png)

## 4、配置 request 合法域名

需求描述：假设在自己的微信小程序中，希望请求 "自己的域名" 域名下的接口

配置步骤：登录微信小程序管理后台 -> 开发 -> 开发设置 -> 服务器域名 -> 修改 request 合法域名

注意事项：

① 域名只支持 https 协议

② 域名不能使用 IP 地址或 localhost

③ 域名必须经过 ICP 备案

④ 服务器域名一个月内最多可申请 5 次修改

## 5、关于跨域和Ajax的说明

跨域问题只存在于基于浏览器的 Web 开发中。由于小程序的宿主环境不是浏览器，而是微信客户端，所以小程序中不存在跨域的问题。   

Ajax 技术的核心是依赖于浏览器中的 XMLHttpRequest 这个对象，由于小程序的宿主环境是微信客户端，所以小程序中不能叫做“发起 Ajax 请求”，而是叫做“发起网络数据请求”。