---
url: /zh/api/scripts/extension-modules/core/cache/memcache.md
---
# core.cache.memcache

此模块提供内存缓存功能，用于构建操作期间的临时数据存储。

::: tip 提示
使用此模块需要先导入：`import("core.cache.memcache")`
:::

## memcache.set

* 设置缓存值（单键）

#### 函数原型

::: tip API

```lua
memcache.set(cachename: <string>, key: <string>, value: <any>)
```

:::

#### 参数说明

| 参数 | 描述 |
|------|------|
| cachename | 必需。缓存名称字符串 |
| key | 必需。缓存键字符串 |
| value | 必需。缓存值（可以是任意 Lua 值） |

#### 返回值说明

无返回值

#### 用法说明

```lua
import("core.cache.memcache")

-- 使用单个键存储值
memcache.set("mycache", "key1", {1, 2, 3})
```

## memcache.get

* 获取缓存值（单键）

#### 函数原型

::: tip API

```lua
memcache.get(cachename: <string>, key: <string>)
```

:::

#### 参数说明

| 参数 | 描述 |
|------|------|
| cachename | 必需。缓存名称字符串 |
| key | 必需。缓存键字符串 |

#### 返回值说明

| 类型 | 描述 |
|------|------|
| any | 找到返回缓存值，未找到返回 nil |

#### 用法说明

```lua
import("core.cache.memcache")

-- 使用单个键获取值
local value = memcache.get("mycache", "key1")
```

## memcache.set2

* 设置缓存值（二级键）

#### 函数原型

::: tip API

```lua
memcache.set2(cachename: <string>, key1: <string>, key2: <string>, value: <any>)
```

:::

#### 参数说明

| 参数 | 描述 |
|------|------|
| cachename | 必需。缓存名称字符串 |
| key1 | 必需。一级缓存键字符串 |
| key2 | 必需。二级缓存键字符串 |
| value | 必需。缓存值（可以是任意 Lua 值） |

#### 返回值说明

无返回值

#### 用法说明

```lua
import("core.cache.memcache")

-- 使用二级键存储值
memcache.set2("mycache", "user", "name", "tboox")
```

## memcache.get2

* 获取缓存值（二级键）

#### 函数原型

::: tip API

```lua
memcache.get2(cachename: <string>, key1: <string>, key2: <string>)
```

:::

#### 参数说明

| 参数 | 描述 |
|------|------|
| cachename | 必需。缓存名称字符串 |
| key1 | 必需。一级缓存键字符串 |
| key2 | 必需。二级缓存键字符串 |

#### 返回值说明

| 类型 | 描述 |
|------|------|
| any | 找到返回缓存值，未找到返回 nil |

#### 用法说明

```lua
import("core.cache.memcache")

-- 使用二级键获取值
local name = memcache.get2("mycache", "user", "name")
```

## memcache.clear

* 清除缓存条目

#### 函数原型

::: tip API

```lua
memcache.clear(cachename?: <string>)
```

:::

#### 参数说明

| 参数 | 描述 |
|------|------|
| cachename | 可选。缓存名称字符串。如果省略，清除所有缓存 |

#### 返回值说明

无返回值

#### 用法说明

```lua
import("core.cache.memcache")

-- 清除指定缓存
memcache.clear("mycache")

-- 清除所有缓存
memcache.clear()
```