從痞客邦、Blogger 搬到 WordPress 後，把文章裡的外站圖片抓回自己的媒體庫

最後更新：2026/10/15

寫了八年的痞客邦部落格，六百篇文章匯進 WordPress，看起來一切正常，直到某天打開舊文章，圖片全變成破圖。原因很簡單：匯入的只有文字，文章裡的圖片網址還是 pimg.tw 開頭，圖片檔案一直放在舊平台的主機上。舊平台限制外連、改網址、或哪天關站，你的文章就只剩文字。

〈WordPress 網站搬家〉那篇講的是整個 WordPress 搬主機，圖片會跟著搬；這篇處理的是從別的平台搬過來、圖片沒跟來的情況。做法是一段程式碼，在後台「工具」多一個「抓回外站圖片」頁面：先預覽每篇文章有幾張外站圖片，確認後一鍵把它們下載進自己的媒體庫，並把文章裡的網址換成自己的。

不想自己改？把這篇交給 AI

把這篇的網址（或全文）連同下面這段話貼給 AI：

我的網站是 WordPress。我從別的平台搬過來，文章裡的圖片還連著舊平台的網址，我想照下面這篇文章把它們抓回自己的媒體庫。
請先問我：舊平台是哪一個、大約有幾篇文章、主機空間還剩多少、有沒有先備份資料庫。
問清楚之後，再一步一步告訴我：要用哪一段程式碼、貼在哪裡、怎麼先預覽再執行，以及跑完怎麼確認。
如果文章的做法不適合我的網站，請直接告訴我原因和替代做法。
文章：（貼上這篇的網址，或整篇內容）

改之前先備份，密碼不要貼給 AI。

完整程式碼

// 第 85 篇：把文章裡的外站圖片抓回自己的媒體庫

// 處理一篇文章：找出不是自己網站的 <img>，下載進媒體庫，把網址換掉
function mimi_localize_images($post_id, $dry_run = true) {
    require_once ABSPATH . 'wp-admin/includes/media.php';
    require_once ABSPATH . 'wp-admin/includes/file.php';
    require_once ABSPATH . 'wp-admin/includes/image.php';

    $post    = get_post($post_id);
    $content = $post->post_content;
    $home    = wp_parse_url(home_url(), PHP_URL_HOST);
    $result  = ['post' => $post_id, 'found' => 0, 'replaced' => 0, 'failed' => []];

    preg_match_all('/<img[^>]+src=["\']([^"\']+)["\']/i', $content, $m);
    foreach (array_unique($m[1]) as $src) {
        $host = wp_parse_url($src, PHP_URL_HOST);
        if (!$host || $host === $home) {
            continue; // 自己的圖，跳過
        }
        $result['found']++;
        if ($dry_run) {
            continue;
        }
        $new = media_sideload_image($src, $post_id, null, 'src'); // 下載、建附件、回傳新網址
        if (is_wp_error($new)) {
            $result['failed'][] = $src . '：' . $new->get_error_message();
            continue;
        }
        $content = str_replace($src, $new, $content);
        $result['replaced']++;
    }
    if (!$dry_run && $result['replaced']) {
        wp_update_post(['ID' => $post_id, 'post_content' => $content]);
    }
    return $result;
}

// 後台工具：工具 > 抓回外站圖片。先「預覽」看有幾張，再「開始」
add_action('admin_menu', function () {
    add_management_page('抓回外站圖片', '抓回外站圖片', 'manage_options', 'mimi-localize', function () {
        $go  = !empty($_POST['go']) && check_admin_referer('mimi_localize');
        $ids = get_posts(['post_type' => ['post', 'page'], 'post_status' => 'any', 'numberposts' => -1, 'fields' => 'ids']);
        echo '<div class="wrap"><h1>抓回外站圖片</h1>';
        $total = ['found' => 0, 'replaced' => 0, 'failed' => []];
        foreach ($ids as $id) {
            $r = mimi_localize_images($id, !$go);
            if ($r['found']) {
                echo '<p>' . esc_html(get_the_title($id)) . '：外站圖片 ' . $r['found'] . ' 張' . ($go ? '，抓回 ' . $r['replaced'] . ' 張' : '') . '</p>';
                $total['found'] += $r['found'];
                $total['replaced'] += $r['replaced'];
                $total['failed'] = array_merge($total['failed'], $r['failed']);
            }
        }
        echo '<p><strong>' . ($go ? '完成：抓回 ' . $total['replaced'] . ' 張' : '共 ' . $total['found'] . ' 張外站圖片（還沒抓）') . '</strong></p>';
        foreach ($total['failed'] as $f) {
            echo '<p style="color:#b32d2e">失敗：' . esc_html($f) . '</p>';
        }
        echo '<form method="post">' . wp_nonce_field('mimi_localize', '_wpnonce', true, false) . '<button class="button button-primary" name="go" value="1">開始抓回（先備份資料庫）</button></form></div>';
    });
});

程式碼放在 Code Snippets 這類外掛或子主題，放法和備份方式見〈WooCommerce 結帳頁改成台灣習慣〉。

兩段各做了什麼

第一段是處理一篇文章的函式。它用正規表示式找出內文所有 <img> 的網址，網域和自己網站一樣的跳過，其他的算成外站圖片。「預覽」模式只數有幾張；「執行」模式對每一張呼叫 WordPress 內建的 media_sideload_image：下載檔案、放進上傳資料夾、建一筆媒體庫的附件、產生各種尺寸的縮圖，然後回傳新的網址。程式再把內文裡的舊網址換成新網址，全部換完才存回文章。下載失敗的圖片會記下原因，內文裡那一張保持原樣，不會變成空白。

第二段在後台「工具」選單下加一頁「抓回外站圖片」。打開頁面就是預覽：列出每一篇有外站圖片的文章和張數，最後一行是總數。按「開始抓回」才真的執行，執行完同一頁顯示每篇抓回幾張、哪幾張失敗。只有管理員看得到這一頁。