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
支持的数据库:
使用 SQL Server 数据库引擎时,需要安装组连接 用户定义的聚合。
基于网络的安装
这网络安装程序 是安装 Winter 的推荐方式非技术用户.它比命令行安装更简单,不需要任何特殊技能。
NOTE: 如果您是开发人员,我们建议您改为通过 Composer 安装
- 在将托管 Winter CMS 安装的 Web 服务器上准备一个空目录。它可以是主域、子域或子文件夹。
- 下载“install.zip”文件 从最新版本的 Winter CMS Web 安装程序到此文件夹。
- 解压缩下载的 ZIP 文件。
- 授予对提取的所有文件和文件夹的写入权限。
- 在您的 Web 浏览器中,导航到指向该文件夹的 URL,并包括
/install.html
在 URL 的末尾。 - 按照安装程序中给出的说明进行操作。
基于 Web 的安装故障排除
-
无法连接到Winter市场 API:如果您的服务器有防火墙阻止对端口 443 的请求,您将需要允许对该端口的请求和响应。请联系您的系统管理员以允许访问此端口。
-
安装程序在“确定依赖项”或“安装依赖项”步骤失败:在幕后,Web 安装程序使用 Composer 处理和安装运行 Winter CMS 所需的依赖项 - 注意,你不要 需要将 Composer 安装为 CLI 工具才能工作。此过程可能需要大量内存才能完成 - 如果您的环境限制应用程序的内存使用,请考虑暂时为安装程序允许最多 1.5GB 的内存,然后在安装完成后减少它。安装程序将尝试自动执行此操作。
-
安装程序无法正常显示或运行:网络安装程序建立在现代前端框架之上,可能需要使用更新的浏览器版本。考虑安装 Mozilla Firefox、Microsoft Edge 或 Google Chrome 并保持最新。
-
无法解析 JSON 响应:根据您的互联网连接,下载所有源文件可能比
max_execution_time
PHP配置值 允许;导致下载以不完整的文件库结束。修改 PHP 配置以增加此值并重试。 -
无法确定 Winter CMS 的依赖项。您的 composer.json 文件无效。:此错误已由使用共享主机的人报告,通常是
proc_*
方法被列在disable_functions
PHP 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
处理队列中的第一个可用作业。