以下指南可用于在现有的 Laravel 9 应用程序之上安装 October CMS v3。如果你想保留相同的数据库而不丢失数据,或者只是更喜欢将 Laravel 作为起点,这会很有用。
主要步骤涉及将 Laravel 的 Illuminate 包替换为 October 的 Rain 包,它代表了 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 路由来设置管理员账户。
配置您系统的一些可选步骤: