ThinkPHP模型修改器_自动将相对路径转为绝对路径【指南】-php教程-PHP中文网

setxxxattr 不适合处理相对路径转绝对路径，因其不解析html、无请求上下文、在队列/命令行中易失效，且正则易误匹配、硬编码协议致混合内容、误处理协议相对url等。

thinkphp模型修改器_自动将相对路径转为绝对路径【指南】

模型修改器（setXxxAttr）不能安全、可靠地将相对路径转为绝对路径——它不解析 HTML 结构，不感知请求上下文，且在非 HTTP 生命周期中（如队列、命令行）极易失效。

为什么 `setXxxAttr` 不适合处理相对路径转绝对路径

修改器本质是字段值单向转换函数，输入是原始 POST 数据或程序赋值，输出是写入数据库的字符串。它既不调用 DOM 解析器，也不持有 $this->request 实例（TP6/8 中模型默认无 Request 依赖）。常见翻车点：

直接对富文本字段（如 content）用 preg_replace 匹配 src="xxx"：一旦内容含双引号嵌套、HTML 注释、CDATA 或 JS 字符串，正则就误匹配或崩溃；
在 setContentAttr() 里调用 $this->request->domain()：命令行执行 php think queue:work 时该对象为 null，触发致命错误；
补全逻辑硬编码 https://：HTTP 站点生成 HTTPS 链接，浏览器主动拦截混合内容；
未校验原始 src 值：把 //cdn.com/a.jpg（协议相对）或 data:image/png;base64,... 也拼上域名，结果变成无效 URL。

真正该用的地方：控制器层 + 专用服务方法

路径补全必须发生在「能安全解析 HTML」+「明确当前请求协议与域名」的环节。推荐在控制器中调用独立服务方法，再传给模型：

示例（TP8）：

// app/service/HtmlUrlParser.php
<?php namespace app\service;

use think\Request;

class HtmlUrlParser
{
    protected Request $request;

    public function __construct(Request $request)
    {
        $this->request = $request;
    }

    public function fixImageSrc(string $html): string
    {
        // 使用 DOMDocument 更安全（比正则强一个量级）
        $dom = new \DOMDocument();
        libxml_use_internal_errors(true);
        $dom->loadHTML('<?xml encoding="UTF-8">' . $html, LIBXML_HTML_NOIMPLIED | LIBXML_HTML_NODEFDTD);
        libxml_clear_errors();

        foreach ($dom->getElementsByTagName('img') as $img) {
            $src = $img->getAttribute('src');
            if (!$src || filter_var($src, FILTER_VALIDATE_URL)) {
                continue; // 已是有效 URL，跳过
            }
            if (str_starts_with($src, '//') || str_starts_with($src, 'data:') || str_starts_with($src, 'javascript:')) {
                continue;
            }

            $base = $this->request->scheme() . '://' . $this->request->host();
            $fixed = rtrim($base, '/') . '/' . ltrim($src, '/');
            $img->setAttribute('src', $fixed);
        }

        return $dom->saveHTML($dom->documentElement);
    }
}

控制器中调用：

btpanel phpsite 宝塔面板PHP网站

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

下载

$data['content'] = app(HtmlUrlParser::class)->fixImageSrc($this->request->post('content'));
$model->save($data); // 此处 save() 不绕过修改器，但 content 已是处理后 HTML

若坚持塞进模型，必须避开 `Attr` 后缀规则

别用 setContentAttr()，改用普通公共方法，在 save() 前显式调用：

public function fixRelativePaths(): self
{
    if ($this->content) {
        $this->content = $this->parseAndFixHtml($this->content);
    }
    return $this;
}

// 调用方式：
$model->content = $rawContent;
$model->fixRelativePaths()->save();

这样做的好处：

完全规避修改器生命周期限制，$this->request 可安全注入（需在构造时传入或通过容器获取）；
方法名语义清晰，不会被框架误认为是自动转换钩子；
便于单元测试，可 mock Request 对象验证补全逻辑；
后续扩展支持 href、background、srcset 等属性更自然。

补全逻辑里三个必须检查的点

无论在哪一层实现，漏掉任意一项都会导致线上图片大面积挂掉：

filter_var($src, FILTER_VALIDATE_URL) 必须前置判断——放过已合法 URL，只处理相对路径；
拼接前用 rtrim($base, '/') + ltrim($src, '/')，避免生成 https://a.com//uploads/b.jpg 这类双斜杠 URL；
绝对不要用 $_SERVER['HTTP_HOST'] —— 它可被客户端伪造，应始终走 $this->request->host()（TP 自动过滤）或 $this->request->url(true) 提取可信 host。

最易被忽略的是 DOM 解析环节：不用 DOMDocument 而硬上正则，等于在生产环境埋雷——HTML 复杂度稍高，第一次采集到带内联 SVG 的文章，src 就会消失。