第3章 HestiaCP 快速安装应用开发指南
Quick Install App
Hestia 收到最多的功能请求之一就是支持 Softaculous。但由于 hestia-php 需要使用 Ioncube,而我们反对使用专有软件,因此我们开发了自己的 Quick Install App 方案。
更多信息请参见 hestia-quick-install 仓库。
创建新应用
在 /usr/local/hestia/web/src/app/WebApp/Installers/ 下新建一个名为 Example 的文件夹。
创建一个名为 ExampleSetup.php 的文件。
将示例文件的内容复制到新文件中。
这样在打开 Quick Install App 页面时,就会看到一个名为 "Example" 的应用。
Info 信息
要在 Quick Install App 列表中显示信息,需要配置以下选项:
Name:应用的显示名称。注意命名必须符合以下正则表达式:[a-zA-Z][a-zA-Z0,9],否则将无法注册为可用应用!
Group:目前未使用,但未来可能会加入相关功能。当前使用的分组有:cms、ecommerce、framework。
Enabled:是否在 Quick Install App 页面中显示该应用,默认为 true。
Version:格式为 x.x.x 或 latest。
Thumbnail:应用图标的图片文件,放在同一文件夹内,最大尺寸为 300px × 300px。
Settings 设置
表单字段
支持以下字段类型:
- 文本输入 - 下拉选择 - 复选框 - 单选按钮
由于这部分功能较为复杂,请参考现有应用的示例来使用。
Database 数据库
用于启用数据库自动创建的开关。启用后会显示一个复选框,允许用户自动创建新数据库,并包含以下 3 个字段:
- Database Name(数据库名) - Database User(数据库用户) - Database Password(数据库密码)
下载应用源码
目前支持以下下载方式:
- 从 URL 下载压缩包 - 通过 Composer - 通过 WP-CLI
服务器设置
用于设置应用的环境要求和 Web 服务器模板。例如,某些应用需要特定的 Nginx 模板,或只能在 PHP 8.0 及以上版本运行。
Nginx:用于 Nginx + PHP-FPM 配置的模板。
Apache2:用于 Apache2 配置的模板,通常可以省略。
PHP version:所有支持的 PHP 版本数组。
安装 Web 应用
应用源码下载完成后,有多种安装和配置方式:
- 操作配置文件 - 执行命令,例如使用 drush 安装 Drupal - 使用 curl 通过 HTTP 完成应用配置
警告
为避免出现问题,请确保所有命令都以应用所属用户身份执行,而不是 root 或 admin。HestiaCP 提供的命令默认都是这样做的。
提交分享
完成后,你可以提交 Pull Request,我们会审查代码。如果符合我们的标准,就会收录到下一个版本中。