安装
最低系统要求
安装 October CMS 前，请确保目标系统满足最低要求：
- PHP 版本 8.2.0 或更高
- Composer 2.0 或更高版本
- PDO PHP 扩展
- cURL PHP 扩展
- OpenSSL PHP 扩展
- Mbstring PHP 扩展
- ZipArchive PHP 扩展
- GD PHP 扩展
- SimpleXML PHP 扩展。
支持的数据库服务器：
- MySQL 5.7 或 MariaDB 10.2。对于旧版 MySQL 或 MariaDB，您可能需要配置索引长度以支持
utf8mb4字符集。 - PostgreSQL 9.6
- SQLite 3.8.8.
支持的 Web 服务器:
- Apache
- Nginx
- Lighttpd
- 微软 IIS
安装 October CMS
您应该在 Web 服务器上配置虚拟主机以访问安装目录。对于本地开发，您可以使用Laravel Sail、Valet、Laragon或内置的 Laravel 开发服务器。
October CMS 是一个 PHP Web 应用程序，它使用 Composer 来管理其依赖项。请确保在开始之前已安装 Composer。许可证密钥 将在完成安装时需要。
要安装此平台，请在终端中使用 create-project 命令初始化一个项目。以下命令会在一个名为 myoctober 的目录中创建一个新项目：
bash
composer create-project october/october myoctober命令完成后，进入项目目录：
bash
cd myoctober运行安装命令：
bash
php artisan october:install最后一步是迁移命令，它将初始化数据库。或者，当您首次访问后端面板时，October CMS 也可以初始化数据库。
bash
php artisan october:migrate当进程完成时，你可以在浏览器中访问后端面板并创建管理员用户配置文件。如果你正在使用内置 Web 服务器，你可以使用以下命令启动它：
bash
php artisan serve如果您正在将平台安装到生产 Web 服务器上，请查阅生产配置文章中列出的建议。
向导安装
向导安装是一种不使用 Composer 安装 October CMS 的替代方法。它比命令行安装更简单且不需要任何特殊技能。
- 在您的服务器上准备一个空目录。它可以是一个子目录、域名根目录或一个子域名。
- 下载安装程序归档文件.
- 解压安装包到准备好的目录
- 授予对安装目录及其所有子目录和文件的写入权限。
- 在您的网络浏览器中导航到
install.php脚本。 - 遵循安装说明。
安装故障排除
几个典型问题可能会在安装期间或安装之后出现。
::: details 输入许可证密钥后安装卡住
在某些环境中，粘贴许可证密钥内容时可能会出现这种情况。多次按下 ENTER 键以允许安装过程继续。
:::
::: details 在安装过程中显示“无法获取本地颁发者证书”错误
完整的错误信息可能为 cURL 错误 60: SSL 证书问题: 无法获取本地颁发者证书。
下载 此证书文件 并将其保存为 cacert.pem。打开您的 php.ini 文件并插入或编辑以下行。您可能需要重新启动 Apache 以使更改生效。
curl.cainfo = "/path/to/cacert.pem"
:::
::: details 在迁移过程中显示错误“指定的键过长”
完整的错误信息可能如下：SQLSTATE[42000]: 语法错误或访问冲突: 1071 指定的键过长; 最大键长度为 767 字节
这可能发生在较旧版本的 MySQL 或 MariaDB 上。配置索引长度以支持 utf8mb4 字符集可以帮助解决此问题。
:::
::: details 打开应用程序时显示空白屏幕
检查 /storage 文件和子目录的权限是否设置正确。它们必须对 Web 服务器可写。
:::
::: details 登录时出现无效安全令牌错误
检查以确保 storage/framework 路径中没有缺失的子目录。您可能需要添加 会话、缓存和视图目录。
:::
::: details 后台面板显示“页面未找到”(404)
如果应用程序找不到数据库，则后端会显示一个 404 页面。尝试启用调试模式以查看底层错误消息。
:::
::: details 更新应用程序时显示500错误
Web服务器上的请求超时应该增加或禁用。例如，Apache的FastCGI有时会将 -idle-timeout 选项设置为30秒。
:::
::: details Zend OPcache API 受 "restrict_api" 配置指令限制
当内部尝试使用 OPcache 内部功能时，可能会出现此问题。通过在 config/cms.php 文件中将 force_bytecode_invalidation 配置设置为 false，可以禁用此功能。
:::
::: details 凭据无效 (HTTP 403) 针对 '...', 正在中止。
此错误可能在 Composer 中出现，当您的服务器上缺少 auth.json 文件或您的项目许可证已过期时，请尝试登录您的账户并检查项目是否具有有效的许可证。如果许可证处于活动状态，您可以使用 project:set Artisan 命令重置它。
:::