安装

本指南主要介绍了如何安装 OnChat 服务端应用程序。

先决条件

想要运行 OnChat，你需要具备以下条件：

软件与环境

• PHP 版本 >=7.1.0（使用 php -v 查看版本）。PHP 是一种流行的通用脚本语言，特别适合于 Web 开发。
• Composer 版本 >= 2.0.0（使用 composer -V 查看版本）。Composer 是 PHP 的依赖管理器。
• Swoole 版本 >=4.6.0（使用 php --ri swoole 查看版本）。Swoole 是一个 PHP 的协程框架，提供了基于协程的并发库。
• PhpRedis 版本 当前版（使用 php --ri redis 查看版本）。PhpRedis 是一个 PHP 扩展，提供了用于与 Redis 进行通信的 API。
• Imagick 版本 当前版（使用 php --ri imagick 查看版本）。Imagick 是一个 PHP 扩展，可以使用 ImageMagick 库创建和修改图像。
• MySQL 版本 >=5.7.0（使用 mysql -V 查看版本）。MySQL 是一个开源的关系数据库管理系统。
• Redis 版本 >=5.0.0（使用 redis-cli -v 查看版本）。Redis 是一个开源的内存数据结构存储，用作数据库，缓存和消息代理。
• FFmpeg 版本 当前版（使用 ffmpeg -version 查看版本）。FFmpeg 是一个用于处理多媒体内容的库和工具的集合。
• Supervisor 版本 当前版（使用 supervisorctl version 查看版本）。Supervisor 是一个进程控制系统。
• OpenSSL 版本 当前版（使用 openssl version 查看版本）。OpenSSL 是用于传输层安全性 (TLS) 和安全套接字层 (SSL) 协议的强大、商业级和功能齐全的工具包。

caution

对于 Swoole，需要开启 SWOOLE_HOOK_NATIVE_CURL（使用 php --ri swoole | grep curl-native 查看是否开启）。若未开启，你需要重新编译 Swoole，编译时需开启 --enable-swoole-curl 选项，详见 Swoole 文档 » 。

tip

对于 Supervisor，这是一个可替换软件。你可以使用其他进程管理软件替代，例如 Monit 。
对于 OpenSSL，这是一个可替换软件。主要用来生成 RS256 公私钥，你可以使用其他 RS256 公私钥生成软件替代。

服务

• SMTP 邮件推送，一种电子邮件群发服务。
• 阿里云对象存储服务（OSS），一种海量、安全、低成本、高可靠的云存储服务（可选）。

tip

对于阿里云对象存储服务（OSS），这是一项可选服务。 OnChat 虽然支持本地存储功能，但推荐使用第三方对象存储服务（不限于阿里云）。 这些第三方服务一般会提供媒体数据处理，URL 签名、防盗等功能，而内置的本地存储只提供基本的文件存储功能。

info

对于存储服务，OnChat 采用了多驱动设计，并内置了 本地存储 、阿里云对象存储服务（OSS） 驱动。
如果你需要使用其他的第三方存储服务，你需要自行实现存储驱动，详见高级指南 »。

安装 OnChat

1. 你可以使用 GIT 工具克隆 OnChat 服务端仓库到本地，请在终端/控制台窗口输入如下命令：

   git clone https://github.com/HyperLife1119/OnChat

2. 导航至 OnChat 服务端应用程序项目根目录下，输入如下命令以安装项目所需依赖项：

   composer install