如何让SaaS客户将自定义域名绑定至个人页面（指定技术栈）

基于你的技术栈（Ubuntu、Apache、PHP8、Symfony6、MySQL），按以下步骤落地：

1. 数据库存储域名映射 #

在用户表（假设表名为users）中新增字段存储客户自定义域名，确保唯一性：

ALTER TABLE users ADD COLUMN custom_domain VARCHAR(255) UNIQUE NULL COMMENT '客户自定义域名';

客户提交域名后，需先验证所有权（比如要求添加指定TXT记录），验证通过后再写入该字段。

2. Apache 虚拟主机配置 #

先启用必要模块：

sudo a2enmod rewrite vhost_alias ssl
sudo systemctl restart apache2

配置默认虚拟主机，接收所有域名请求并转发至Symfony入口：

<VirtualHost *:80>
    ServerName exampledomain.com
    ServerAlias *.exampledomain.com
    ServerAlias *

    DocumentRoot /var/www/your-symfony-project/public

    <Directory /var/www/your-symfony-project/public>
        AllowOverride All
        Require all granted
        FallbackResource /index.php
    </Directory>

    # 强制跳转HTTPS
    RewriteEngine On
    RewriteCond %{HTTPS} off
    RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
</VirtualHost>

<VirtualHost *:443>
    ServerName exampledomain.com
    ServerAlias *.exampledomain.com
    ServerAlias *

    DocumentRoot /var/www/your-symfony-project/public

    <Directory /var/www/your-symfony-project/public>
        AllowOverride All
        Require all granted
        FallbackResource /index.php
    </Directory>

    # SSL证书配置（后续用Certbot生成）
    SSLEngine on
    SSLCertificateFile /etc/letsencrypt/live/exampledomain.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/exampledomain.com/privkey.pem
</VirtualHost>

替换/var/www/your-symfony-project为你的Symfony项目实际路径，证书路径根据生成结果调整。

3. Symfony 请求处理与路由 #

方式一：事件监听器解析域名 #

创建DomainResolverListener监听请求，匹配对应用户：

// src/EventListener/DomainResolverListener.php
namespace App\EventListener;

use App\Entity\User;
use Doctrine\ORM\EntityManagerInterface;
use Symfony\Component\HttpKernel\Event\KernelRequestEvent;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;

class DomainResolverListener
{
    public function __construct(private EntityManagerInterface $em) {}

    public function onKernelRequest(KernelRequestEvent $event): void
    {
        if (!$event->isMainRequest()) return;

        $host = $event->getRequest()->getHost();
        // 排除系统自有域名，避免冲突
        if ($host === 'exampledomain.com' || str_ends_with($host, '.exampledomain.com')) return;

        $user = $this->em->getRepository(User::class)->findOneBy(['custom_domain' => $host]);
        if (!$user) throw new NotFoundHttpException('该域名未绑定个人页面');

        // 改写请求路径，复用原个人页面路由逻辑
        $event->getRequest()->server->set('REQUEST_URI', '/' . $user->getUsername());
    }
}

在services.yaml注册监听器：

services:
    App\EventListener\DomainResolverListener:
        tags:
            - { name: kernel.event_listener, event: kernel.request }

方式二：自定义路由直接处理 #

在config/routes.yaml添加域名匹配路由：

custom_domain_profile:
    path: /
    host: '{domain}'
    controller: App\Controller\UserController::customDomainProfile
    requirements:
        domain: '.+'

控制器中实现逻辑：

// src/Controller/UserController.php
namespace App\Controller;

use App\Entity\User;
use Doctrine\ORM\EntityManagerInterface;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;

class UserController extends AbstractController
{
    public function customDomainProfile(string $domain, EntityManagerInterface $em)
    {
        $user = $em->getRepository(User::class)->findOneBy(['custom_domain' => $domain]);
        if (!$user) throw new NotFoundHttpException();

        // 复用原个人页面模板
        return $this->render('user/profile.html.twig', ['user' => $user]);
    }

    // 原个人页面路由
    public function profile(string $username, EntityManagerInterface $em)
    {
        $user = $em->getRepository(User::class)->findOneBy(['username' => $username]);
        if (!$user) throw new NotFoundHttpException();
        return $this->render('user/profile.html.twig', ['user' => $user]);
    }
}

4. SSL证书自动配置 #

用Certbot生成通配符证书，支持所有自定义域名：

sudo apt install certbot python3-certbot-apache
sudo certbot certonly --apache -d exampledomain.com -d *.exampledomain.com --manual --preferred-challenges dns

按提示添加DNS TXT记录完成域名验证，证书会自动续期。

5. 客户侧配置指导 #

告知客户完成以下操作：

• 将自定义域名的A记录指向你的服务器IP，或CNAME记录指向exampledomain.com
• 若使用HTTPS，需等待域名解析生效后，系统会自动适配证书（无需客户额外操作）
• 需完成域名所有权验证（比如添加指定TXT记录）后才能绑定生效

内容的提问来源于stack exchange，提问作者khatabnajeeb88