menu-btn

安装

October CMS Documentation Docs
/

安装

October CMS 是一个具有简单直观界面的 Web 应用程序平台。Web 平台提供一致的结构，并强调可重用性，因此您可以专注于构建独特的内容，而我们处理无聊的部分。

无论您是 Web 开发新手还是拥有多年经验，October CMS 都是一个平台，可让您轻松为您和您的客户创建定制体验。 我们希望您与我们一起享受旅程，并在简单中发现快乐。

要在本地运行 October CMS，我们推荐以下软件：

October中文文档全部由"超越无限" (opens new window)维护，您可以在我们的企业介绍 (opens new window)页面加入中国开发者社区

# 安装Composer

October CMS 使用Composer (opens new window) 来管理它的依赖。因此，在开始之前，您需要确保已安装 Composer。

您还应该检查您的计算机或服务器是否满足运行 PHP 应用程序的 最低系统要求 。

# 安装 October CMS

然后，您可以在终端中使用命令create-project创建一个新的 October CMS 项目。下面在名为myoctober的目录中创建一个新项目。

composer create-project october/october myoctober "^2.0"

您也可以使用此命令安装到当前目录。

composer create-project october/october . "^2.0"

任务完成后，运行安装命令以指导您完成后续步骤。

php artisan october:install

接下来，使用以下命令迁移数据库。

php artisan october:migrate

然后，您可以提供应用程序并在浏览器中打开它。

php artisan serve

Note：如果您正在使用项目，请继续阅读项目文章 (opens new window) 有关如何设置项目的信息。

# 安装后步骤

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

# 查看配置

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

例如，在生产环境中，您可能希望执行以下操作：

# 设置调度程序

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

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

请务必将 /path/to/artisan 替换为 October CMS 根目录中 artisan 文件的绝对路径。 此 Cron 将每分钟调用命令调度程序。 然后 October CMS 评估所有计划的任务并运行到期的任务。

注意：如果你把这个添加到/etc/cron.d，你需要在* * * * * 之后立即指定一个用户。

# 设置队列工作者

您可以选择设置一个外部队列来处理 排队任务，默认情况下，这些将由平台异步处理。这种行为可以通过在 config/queue.php 中设置 default 参数来改变。

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

您还可以将队列作为守护进程运行

php artisan queue:work

# 最低系统要求

October CMS 对服务器有一些要求：

  1. PHP 7.4 或更高版本
  2. Composer 2.0 或更高版本
  3. PDO PHP Extension(以及要连接的数据库的相关驱动程序)
  4. cURL PHP 扩展
  5. OpenSSL PHP 扩展
  6. Mbstring PHP 扩展
  7. ZipArchive PHP 扩展
  8. GD PHP 扩展
  9. SimpleXML PHP 扩展

为这些数据库提供支持的最低要求：

  1. MySQL 5.7 或 MariaDB 10.2
  2. PostgreSQL 9.6
  3. SQLite 3.8.8

请注意，October CMS v2 与 PHP 8.1 不兼容，v3 beta (opens new window) 可满足此要求。 建议降级到 PHP 8.0 并使用版本2以获得最佳稳定性和支持。

如果您使用的是旧版本的 MySQL 或 MariaDB，您可能需要配置索引长度 以支持 utf8mb4 字符集.

某些操作系统发行版可能需要您手动安装一些必要的 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 数据库引擎时，需要安装 group concatenation (opens new window) 用户定义聚合。

# 安装疑难解答

  1. 当我输入许可证密钥时安装挂起或冻结：在某些环境中粘贴密钥内容时可能会发生这种情况。多次按 ENTER 键以允许安装过程继续。

  2. 迁移过程中显示错误 Specified key was too long：当您使用旧版本的 MySQL 或 MariaDB 时会发生这种情况。要解决此问题，您可能需要配置索引长度 以支持utf8mb4 字符集。

  3. 打开应用程序时显示空白屏幕：检查/storage文件和文件夹的权限设置是否正确，它们应该在Web服务器是可写的。

  4. **后端区域显示 Page not found (404) **：如果应用程序找不到数据库，则后端会显示404页面。尝试启用 调试模式 以查看底层错误消息。

  5. **更新应用程序时显示错误 500 **：您可能需要增加或禁用网络服务器的超时限制。例如，Apache 的 FastCGI 有时会将 -idle-timeout 选项设置为 30 秒。

注意：详细的系统日志可以在storage/logs目录中找到。

配置 →