安装
最低系统要求
安装 October CMS 之前，请确保目标系统满足最低要求：
- PHP 版本 8.0.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 服务器:
- 阿帕奇
- 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上述命令安装最新版 October CMS，如果你想安装 v3.0，请改用以下命令。
bash
composer create-project october/october myoctober "^3.0"命令完成后，进入项目目录：
bash
cd myoctober运行安装命令:
bash
php artisan october:install最后一步是初始化数据库的迁移命令。或者，当您首次访问后端面板时，October CMS 可以初始化数据库。
bash
php artisan october:migrate当进程完成后，您可以在浏览器中访问后端面板并创建管理员用户配置文件。如果您正在使用内置Web服务器，您可以使用以下命令启动它：
bash
php artisan serve如果您正在生产 Web 服务器上安装平台，请查看 生产配置 文章中列出的建议。
:::
向导安装
向导安装是安装 October CMS 的另一种方式，无需使用 Composer。它比命令行安装更简单，并且不需要任何特殊技能。
- 在您的服务器上准备一个空目录。它可以是一个子目录，域名根目录，或一个子域名。
- 下载安装程序归档文件.
- 将安装程序压缩包解压到已准备好的目录。
- 授予安装目录及其所有子目录和文件的写入权限。
- 在您的 Web 浏览器中导航到
install.php脚本。 - 遵循安装说明。
故障排除安装
在安装期间或安装之后，可能会出现一些典型问题。
::: details 输入许可证密钥后安装冻结
在粘贴许可证密钥内容时，某些环境下可能会出现此情况。 请多次按下 ENTER 键，以使安装过程继续。
:::
::: details An error "Unable to get local issuer certificate" is displayed during installation
The complete error may read cURL error 60: SSL certificate problem: unable to get local issuer certificate.
下载 此证书文件 并将其保存为 cacert.pem。打开您的 php.ini 文件并插入或编辑以下行。您可能需要重启 Apache 以使更改生效。
curl.cainfo = "/path/to/cacert.pem"
:::
::: details 一个错误“指定的键太长了”在迁移过程中显示
完整的错误信息可能如下：SQLSTATE[42000]: Syntax error or access violation: 1071 Specified key was too long; max key length is 767 bytes
这可能发生在较旧版本的 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 命令重置它。
:::