ThinkPHP配置二级域名实现图片处理：独立子域名调用图像处理服务【操作】-ThinkPHP-PHP中文网

thinkphp可通过nginx/apache泛域名配置+route::domain('img.example.com')路由分组+image控制器解析@参数实现二级域名图片处理。需开启url_domain_deploy、限制路径与尺寸、加redis缓存防重复处理。

thinkphp配置二级域名实现图片处理：独立子域名调用图像处理服务【操作】

ThinkPHP 本身不直接支持二级域名的图像处理路由，但可以通过 Nginx/Apache 配置 + 路由分组 + 图像处理扩展（如 think-image 或自定义 GD/Imagick 封装）实现「独立子域名调用图片处理服务」的效果。核心在于：将 img.example.com 指向同一套 ThinkPHP 应用，并在应用内识别子域名，走专用图像处理逻辑。

一、DNS 与 Web 服务器配置（让子域名生效）

确保二级域名已解析到服务器 IP，并在 Web 服务中统一指向 ThinkPHP 的入口目录（如 public/）：

Nginx 示例：无需单独 server 块，用泛解析或通配 server_name 匹配所有子域

server {
    listen 80;
    server_name example.com *.example.com;
    root /path/to/thinkphp/public;
    index index.php;

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

Apache 可通过 VirtualHost + ServerAlias *.example.com 实现类似效果
DNS 设置 A 记录：img.example.com → 你的服务器IP

二、ThinkPHP 中识别并路由子域名请求

在 app/middleware.php 或全局中间件中判断 Host，标记为「图片处理请求」；再配合路由分组定向处理：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

在 app/route/app.php 中定义子域名专属路由

// 路由文件中
Route::domain('img.example.com', function () {
    // 所有 img 子域下的请求都走这里
    Route::get(':path', 'Image/index')
         ->pattern(['path' => '.*']);
});

:path 捕获完整路径（如 /uploads/avatar.jpg@w_200,h_200,q_85），便于后续解析参数
确保 app/config/app.php 中 'url_domain_deploy' => true 开启域名部署支持

三、编写 Image 控制器处理动态图片请求

创建 app/controller/Image.php，解析 URL 中的原始图路径和处理指令（如缩略、裁剪、水印等）：

使用 think-image 扩展（composer require topthink/think-image）快速操作
关键逻辑：提取原图相对路径 → 定位真实文件 → 解析 @ 后参数 → 执行处理 → 输出二进制流

public function index($path = '')
{
    // 解析：uploads/photo.jpg@w_300,h_200,q_90 → ['file'=>'uploads/photo.jpg', 'opts'=>['w'=>300,'h'=>200,'q'=>90]]
    [$file, $opts] = $this->parseImageRequest($path);

    $realPath = ROOT_PATH . 'public' . DS . $file;
    if (!is_file($realPath)) {
        return $this->errorImage(); // 返回 404 占位图或抛异常
    }

    $image = \think\Image::open($realPath);
    if (isset($opts['w']) && isset($opts['h'])) {
        $image->thumb($opts['w'], $opts['h'], \think\Image::THUMB_CENTER);
    }
    if (isset($opts['q'])) {
        $image->quality($opts['q']);
    }

    return $image->response();
}