DIV CSS 佈局教程網

Bootstrap 富文本編輯器 wysiwyg 存進 MySQL 的兩種編碼方案
編輯:關於JavaScript     

Bootstrap 的 wysiwyg 元件能編輯富文本,但編輯完的內容怎麼存進資料庫、存進去之後又怎麼讀回來顯示,官方文件並沒有交代。這個問題要分兩種情況討論,取決於內容裡有沒有圖片。

先確認欄位型別

富文本是一整段 HTML,含大量標籤、引號與換行,用一般字串欄位很容易不夠或出問題。實務上直接用 longtext:

`description` longtext NOT NULL COMMENT '項目詳細描述',

LongText 的上限是 2³²−1 個字元,日常使用完全綽綽有餘。

情況一:內容只有文字,做 HTML 轉碼即可

最直覺的做法是把特殊字元換成 HTML 實體,存進資料庫時就是一段安全的純文字,讀出來再解碼還原。

function html_encode(str) {
    if (str.length == 0) { return ""; }
    return str.replace(/&/g, "&")
              .replace(/</g,  "&lt;")
              .replace(/>/g,  "&gt;")
              .replace(/ /g,  "&nbsp;")
              .replace(/'/g,  "&#39;")
              .replace(/"/g,  "&quot;")
              .replace(/\n/g,  "<br>");
}

function html_decode(str) {
    if (str.length == 0) { return ""; }
    return str.replace(/<br>/g, "\n")
              .replace(/&quot;/g, '"')
              .replace(/&#39;/g,  "'")
              .replace(/&nbsp;/g, " ")
              .replace(/&gt;/g,  ">")
              .replace(/&lt;/g,  "<")
              .replace(/&amp;/g,  "&");
}

這裡有個順序陷阱:編碼時 & 一定要第一個被替換,解碼時則要最後才被還原。順序顛倒會把已經編碼過的實體再編一次,內容就壞了。

但這套做法有個致命限制:處理不了圖片。因為它會把所有標籤都變成實體,<img> 自然也一起被編碼掉。

情況二:內容含圖片,改用 Base64

圖片要以 base64 內嵌的形式保存,就必須繞過 HTML 轉碼,改用 jquery.base64 把整段 HTML 當成一個不透明字串處理。

① 引入並指定 UTF-8

<script type="text/javascript" src="${ctx}/components/jquery/jquery.base64.js"</script>
$.base64.utf8encode = true;    // 確保中文不亂碼

② 表單提交時編碼

關鍵是把富文本內容轉成 base64,再塞進一個隱藏欄位隨表單送出:

var editor = "<input type='hidden' name='" + $this.attr("name")
           + "' value='" + $.base64.btoa($this.html()) + "' />";

整合進表單提交流程(此處參照 dwz 框架的寫法):

/**
 * 帶檔案上傳的 ajax 表單提交
 * @param {Object} form
 * @param {Object} callback
 */
function iframeCallback(form, callback) {
    var $form = $(form), $iframe = $("#callbackframe");

    // 把每個富文本編輯器的內容轉成隱藏欄位
    $("div.editor", $form).each(function () {
        var $this = $(this);
        $form.append("<input type='hidden' name='" + $this.attr("name")
                   + "' value='" + $.base64.btoa($this.html()) + "' />");
    });

    // 表單驗證
    var data = $form.data('bootstrapValidator');
    if (data && !data.isValid()) { return false; }

    // 建立隱藏 iframe 作為上傳目標
    if ($iframe.size() == 0) {
        $iframe = $("<iframe id='callbackframe' name='callbackframe'
                        src='about:blank' style='display:none'></iframe>")
                   .appendTo("body");
    }
    if (!form.ajax) {
        $form.append('<input type="hidden" name="ajax" value="1" />');
    }
    form.target = "callbackframe";
    _iframeResponse($iframe[0], callback || YUNM.ajaxDone);
}

function _iframeResponse(iframe, callback) {
    var $iframe = $(iframe), $document = $(document);
    $document.trigger("ajaxStart");

    $iframe.bind("load", function (event) {
        $iframe.unbind("load");
        $document.trigger("ajaxStop");

        // 部分瀏覽器會觸發 about:blank 的 load,要排除
        if (iframe.src == "javascript:'<html></html>';") { return; }

        var doc = iframe.contentDocument || iframe.document;
        if (doc.readyState && doc.readyState != 'complete') { return; }
        if (doc.body && doc.body.innerHTML == "false") { return; }

        var response;
        if (doc.XMLDocument) {
            response = doc.XMLDocument;                       // 舊 IE
        } else if (doc.body) {
            try {
                response = $iframe.contents().find("body").text();
                response = jQuery.parseJSON(response);
            } catch (e) {
                response = doc.body.innerHTML;                // 回傳的是 HTML
            }
        } else {
            response = doc;
        }
        callback(response);
    });
}

用隱藏 iframe 收送檔案是 iframe 時代的經典手法:把表單 target 指向 iframe,檔案上傳後頁面不會跳轉,再由 iframe 的 load 事件把結果讀出來。

③ 讀出來時解碼

$('#editor').html($.base64.atob(description, true));

用 atob 把資料庫中的字串解回 HTML,再塞回編輯器即可。

今天會怎麼做

上面這兩套方案都有明顯的時代痕跡。Base64 內嵌圖片會讓內容膨脹約三分之一,而且整段存進單一欄位後,資料庫完全無法對內容做查詢或索引。

更現代的作法是:圖片另外上傳,編輯器內容只存指向該圖片的 URL;儲存前用 DOMPurify 這類白名單工具做一次 sanitize,避免 XSS;資料庫端則改用 parameter binding 而非字串拼接,從根本上杜絕 SQL Injection。至于 iframe 提交,現在用 FormData 搭配 fetch 或 XMLHttpRequest 就能優雅解決,也不必再處理 iframe load 的種種邊界情況。

想再深入 Bootstrap,可以參考 Bootstrap 學習教程、實戰教程與插件使用教程三個專題。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved