Installation

• 最低系统要求
• 基于网络的安装
  • 安装疑难解答
• 命令行安装
• 安装后步骤
  • 删除安装文件
  • 查看配置
  • 设置调度程序
  • 设置队列工作者

有两种方法可以安装 Winter，要么使用基于 Web 的安装程序 或者作曲家安装 指示。在继续之前，您应该检查您的服务器是否满足最低系统要求。

#最低系统要求

Winter CMS 对虚拟主机有一些服务器要求：

• PHP 8.0 或更高版本（推荐：8.1）
• PDO PHP 扩展（以及您要连接的数据库的相关驱动程序）
• 卷曲 PHP 扩展
• OpenSSL PHP 扩展
• Mbstring PHP 扩展
• ZipArchive PHP 扩展
• GD PHP 扩展
• SimpleXML PHP 扩展

某些操作系统发行版可能需要您手动安装一些必需的 PHP 扩展。

使用 Ubuntu 时，可以运行以下命令来安装所有必需的扩展：

sudo apt-get update &&
sudo apt-get install php php-ctype php-curl php-xml php-fileinfo php-gd php-json php-mbstring php-mysql php-sqlite3 php-zip

#支持的数据库：

• MariaDB 10.2+ (版本政策)
• MySQL 5.7+ (版本政策)
• PostgreSQL 9.6+ (版本政策)
• SQLite 3.8.8+
• SQL Server 2017+ (版本政策)

使用 SQL Server 数据库引擎时，需要安装组连接 用户定义的聚合。

#基于网络的安装

这网络安装程序 是安装 Winter 的推荐方式非技术用户.它比命令行安装更简单，不需要任何特殊技能。

NOTE: 如果您是开发人员，我们建议您改为通过 Composer 安装

1. 在将托管 Winter CMS 安装的 Web 服务器上准备一个空目录。它可以是主域、子域或子文件夹。
2. 下载“install.zip”文件 从最新版本的 Winter CMS Web 安装程序到此文件夹。
3. 解压缩下载的 ZIP 文件。
4. 授予对提取的所有文件和文件夹的写入权限。
5. 在您的 Web 浏览器中，导航到指向该文件夹的 URL，并包括/install.html 在 URL 的末尾。
6. 按照安装程序中给出的说明进行操作。

#基于 Web 的安装故障排除

1. 无法连接到Winter市场 API：如果您的服务器有防火墙阻止对端口 443 的请求，您将需要允许对该端口的请求和响应。请联系您的系统管理员以允许访问此端口。

2. 安装程序在“确定依赖项”或“安装依赖项”步骤失败：在幕后，Web 安装程序使用 Composer 处理和安装运行 Winter CMS 所需的依赖项 - 注意，你不要 需要将 Composer 安装为 CLI 工具才能工作。此过程可能需要大量内存才能完成 - 如果您的环境限制应用程序的内存使用，请考虑暂时为安装程序允许最多 1.5GB 的内存，然后在安装完成后减少它。安装程序将尝试自动执行此操作。

3. 安装程序无法正常显示或运行：网络安装程序建立在现代前端框架之上，可能需要使用更新的浏览器版本。考虑安装 Mozilla Firefox、Microsoft Edge 或 Google Chrome 并保持最新。

4. 无法解析 JSON 响应：根据您的互联网连接，下载所有源文件可能比max_execution_time PHP配置值 允许；导致下载以不完整的文件库结束。修改 PHP 配置以增加此值并重试。

5. 无法确定 Winter CMS 的依赖项。您的 composer.json 文件无效。：此错误已由使用共享主机的人报告，通常是proc_* 方法被列在disable_functionsPHP INI 设置，或pcntl 未启用 PHP 扩展。不幸的是，现阶段没有解决方法，但您可以在没有这些限制的本地开发环境中使用安装程序，然后在完成后将完整目录复制到您的共享主机。我们正在积极寻找针对此行为的更长期解决方案。

#命令行安装

如果你觉得命令行更舒服或者想使用 Composer，可以在使用 Composer 页面

#安装后步骤

安装完成后，您可能需要进行一些设置。

#删除安装文件

如果您使用过安装向导，出于安全原因，您应该验证安装文件是否已被删除。 Winter 安装程序尝试自行清理，但您应始终验证它们是否已成功删除：

 ┣ 📂 install       <== Installation directory
 ┣ 📜 install.html  <== Installation script

#查看配置

配置文件存放在config 应用程序的目录。虽然每个文件都包含对每个设置的描述，但重要的是要查看常用配置选项 适用于您的情况。

例如，在生产环境中，您可能希望启用CSRF保护.在开发环境中，您可能希望启用前沿更新.

虽然大多数配置是可选的，但我们强烈建议禁用调试模式 对于生产环境。您可能还想使用公共文件夹 以获得额外的安全性。

#设置调度程序

为了使计划任务正常运行，您应该将以下 Cron 条目添加到您的服务器。编辑 crontab 通常使用以下命令执行crontab -e.

* * * * * php /path/to/artisan schedule:run >> /dev/null 2>&1

务必更换/path/to/artisan 的绝对路径artisan Winter根目录下的文件。这个 cron 将每分钟调用命令调度程序，Winter 将在其中评估任何计划的任务并运行到期的任务。

NOTE: 如果您要将此添加到/etc/cron.d，您需要在之后立即指定一个用户* * * * *.

#设置队列工作者

您可以选择设置一个外部队列来处理排队的作业。默认情况下，这些将由平台异步处理。可以通过设置default 中的参数config/queue.php.

如果您决定使用database 队列驱动程序，最好为命令添加一个 Crontab 条目php artisan queue:work --once 处理队列中的第一个可用作业。