以下指南可用于在现有 Laravel 9 应用程序之上安装 October CMS v3。如果你希望在不丢失数据的情况下保留相同的数据库,而又不丢失数据,或者只是倾向于将 Laravel 作为起点,这会很有用。
关键步骤涉及用 October 的 Rain 包替换 Laravel 的 Illuminate 包,该包代表了 Laravel 的扩展技术版本,并添加了运行 October CMS 所需的核心功能。
请务必仔细遵循本指南,因为类名略有不同。
为了开始,假设我们有一个全新的 Laravel 安装,通过以下命令:
composer create-project laravel/laravel:^9.0 mylaravel在新创建的目录中,引入 October CMS Rain 库。
cd mylaravel
composer require october/rain通过设置您的项目密钥,对 October CMS 网关进行身份验证。
php artisan project:set <license key>需要所有 October CMS 模块。
composer require october/all当提示信任 composer/installers 时,输入 Y 表示同意。
Do you trust "composer/installers" to execute code and wish to enable it now?以下步骤用于将 Illuminate 替换为 Rain。
在文件 bootstrap/app.php Illuminate\Foundation\Application 类应替换为 October\Rain\Foundation\Application.
// File bootstrap/app.php
// Replace
$app = new Illuminate\Foundation\Application(
$_ENV['APP_BASE_PATH'] ?? dirname(__DIR__)
);
// With
$app = new October\Rain\Foundation\Application(
$_ENV['APP_BASE_PATH'] ?? dirname(__DIR__)
);在文件 app/Http/Kernel.php 的 App\Http\Kernel 类应该继承 October\Rain\Foundation\Http\Kernel。
// File app/Http/Kernel.php
// Replace
use Illuminate\Foundation\Http\Kernel as HttpKernel;
// With
use October\Rain\Foundation\Http\Kernel as HttpKernel;在文件 app/Console/Kernel.php 中 App\Console\Kernel 类应该继承 October\Rain\Foundation\Console\Kernel。
// File app/Console/Kernel.php
// Replace
use Illuminate\Foundation\Console\Kernel as ConsoleKernel;
// With
use October\Rain\Foundation\Console\Kernel as ConsoleKernel;在文件 app/Exceptions/Handler.php 该 App\Exceptions\Handler 类应继承 October\Rain\Foundation\Exception\Handler。
// File app/Exceptions/Handler.php
// Replace
use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;
// With
use October\Rain\Foundation\Exception\Handler as ExceptionHandler;以下步骤将从 October CMS 复制供应商文件。要发布这些文件,请遵循以下步骤:
复制以下文件夹从zip文件。
假设您的数据库已配置并正在运行,运行 October CMS 迁移。
php artisan october:migrate接下来,为了使 CMS 页面对前端可用,移除或注释掉文件 routes/web.php 中的默认路由。
现在你可以打开 /backend 路由来设置管理员账户。
配置您的系统的一些可选步骤: