> ## Documentation Index
> Fetch the complete documentation index at: https://cs-lua.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# mysql — Открытие

> MySQL/MariaDB: удалённая база, не блокирующая кадр

# Открытие

<h2 id="connect">
  mysql.connect
</h2>

Открывает соединение с сайтовой базой.

```lua theme={null}
mysql.connect(opts)
```

### Аргументы

| # | имя    | тип   |                             |
| - | ------ | ----- | --------------------------- |
| 1 | `opts` | table | см. [Опции](#connect-опции) |

### Возвращает

| тип    |                                                        |
| ------ | ------------------------------------------------------ |
| `conn` | объект соединения — не ждёт настоящего TCP-подключения |

<h3 id="connect-опции">
  Опции
</h3>

| поле       | тип    |                          |
| ---------- | ------ | ------------------------ |
| `host`     | string | по умолчанию `127.0.0.1` |
| `port`     | number | по умолчанию `3306`      |
| `user`     | string |                          |
| `password` | string |                          |
| `database` | string |                          |
| `charset`  | string | по умолчанию `utf8`      |

### Пример

```lua theme={null}
local site = mysql.connect{
    host = "127.0.0.1", user = "root", password = "", database = "gamecms",
}
```

<Note>
  Открывается лениво: ошибка в адресе или пароле проявится не здесь,
  а в `res.error` первого запроса.
</Note>