3步搞定October CMS用户注册：从邮箱验证到欢迎自动化

2026-02-05 05:17:05作者：伍希望

你还在为用户注册流程繁琐而烦恼？本文将带你通过3个步骤，完成October CMS（内容管理系统）的用户注册流程定制，包括邮箱验证功能实现和欢迎邮件自动化发送，无需复杂代码基础，轻松提升用户体验。

准备工作：核心文件与目录说明

在开始定制前，先了解项目中与用户管理相关的核心文件位置：

用户认证配置：config/auth.php
后端服务提供器：modules/backend/ServiceProvider.php
系统更新管理器：modules/system/classes/UpdateManager.php

步骤1：配置邮箱验证基础环境

修改认证配置

打开config/auth.php文件，找到providers数组，确保用户模型启用了邮箱验证功能：

'providers' => [
    'users' => [
        'driver' => 'eloquent',
        'model' => October\User::class,
        'table' => 'users',
        'verification' => true, // 添加此行启用邮箱验证
    ],
],

设置邮件服务

在config/mail.php中配置SMTP服务器信息，确保邮件能够正常发送：

'mailers' => [
    'smtp' => [
        'transport' => 'smtp',
        'host' => env('MAIL_HOST', 'smtp.qq.com'),
        'port' => env('MAIL_PORT', 465),
        'encryption' => env('MAIL_ENCRYPTION', 'ssl'),
        'username' => env('MAIL_USERNAME'),
        'password' => env('MAIL_PASSWORD'),
    ],
],

步骤2：实现邮箱验证功能

创建验证控制器

在modules/backend/controllers目录下创建Auth/VerificationController.php文件，添加以下代码：

namespace Backend\Controllers\Auth;

use October\Rain\Support\Facades\Mail;
use Backend\Models\User;
use Backend\Classes\Controller;

class VerificationController extends Controller
{
    public function verify($token)
    {
        $user = User::where('verification_token', $token)->first();
        
        if ($user) {
            $user->is_verified = true;
            $user->verification_token = null;
            $user->save();
            
            // 发送欢迎邮件
            $this->sendWelcomeEmail($user);
            
            return redirect()->to('/login?verified=1');
        }
        
        return redirect()->to('/login?verified=0');
    }
    
    protected function sendWelcomeEmail($user)
    {
        Mail::send('backend::mail.welcome', ['user' => $user], function ($message) use ($user) {
            $message->to($user->email, $user->name)
                    ->subject('欢迎加入我们的平台');
        });
    }
}

添加验证路由

在modules/backend/routes.php中添加验证路由：

Route::get('auth/verify/{token}', 'Auth\VerificationController@verify')->name('auth.verify');

步骤3：设计欢迎邮件模板与自动化流程

创建邮件模板

在modules/backend/views/mail目录下创建welcome.htm文件，设计欢迎邮件内容：

<h1>欢迎您，{{ user.name }}！</h1>
<p>您的邮箱已成功验证，现在可以使用我们的平台服务了。</p>
<p>如有任何问题，请随时联系我们的客服团队。</p>

配置自动发送规则

打开modules/system/handlers/Installer.php，添加用户注册成功后的事件监听：

public function afterInstall()
{
    Event::listen('backend.user.registered', function ($user) {
        // 生成验证令牌
        $user->verification_token = str_random(32);
        $user->save();
        
        // 发送验证邮件
        Mail::send('backend::mail.verification', ['user' => $user], function ($message) use ($user) {
            $message->to($user->email, $user->name)
                    ->subject('请验证您的邮箱');
        });
    });
}