WordPress syntax error報錯：unexpected single-quoted string完美修復指南

WordPress PHP 報錯可能是幽靈空間在作怪！

程式設計師最怕的不是bug，而是被bug 玩弄感情。

你寫的邏輯明明沒問題，可PHP 偏偏給你來一句 syntax error，這就像你約會遲到三分鐘，對方卻甩臉子說「你不愛我」一樣，委屈到想摔鍵盤。

為什麼會WordPress PHP報錯？

PHP 給出的提示是：

syntax error, unexpected single-quoted string "wpturbo_handle_upload_convert_...", expecting ")"

翻譯成人話就是：我本來等著右括號，結果你給我塞進一個奇怪的字串，還帶著莫名其妙的氣質。

那麼問題出在哪？不是你的函數邏輯，而是那行看似沒毛病的：

add_filter('wp_handle_upload', 'wpturbo_handle_upload_convert_to_webp');

程式碼裡的幽靈空格

問題核心在於，當你複製貼上程式碼時，混進了 全角空格 有人 零寬空格。

這些東西在編輯器裡肉眼看不到，但PHP 解析時就會抓狂。

就像你吃一碗麵，味道挺香，結果突然咬到一粒沙子，人瞬間破防。 PHP 此刻的心情就是如此。

對的寫法是什麼？

你要做的其實很簡單，把那些幽靈空格統統換掉，保留最純的半角空格。

對的WordPress程式碼如下：

add_filter('wp_handle_upload', 'wpturbo_handle_upload_convert_to_webp');

function wpturbo_handle_upload_convert_to_webp($upload) {
    if (in_array($upload['type'], ['image/jpeg', 'image/png', 'image/gif'])) {
        $file_path = $upload['file'];
        if (extension_loaded('imagick') || extension_loaded('gd')) {
            $image_editor = wp_get_image_editor($file_path);
            if (!is_wp_error($image_editor)) {
                // Set WebP quality (adjust as needed)
                $quality = 80; // Adjust between 0 (low) to 100 (high)
                $image_editor->set_quality($quality);

                $file_info = pathinfo($file_path);
                $dirname = $file_info['dirname'];
                $filename = $file_info['filename'];
                $def_filename = wp_unique_filename($dirname, $filename . '.webp');
                $new_file_path = $dirname . '/' . $def_filename;

                $saved_image = $image_editor->save($new_file_path, 'image/webp');
                if (!is_wp_error($saved_image) && file_exists($saved_image['path'])) {
                    $upload['file'] = $saved_image['path'];
                    $upload['url']  = str_replace(basename($upload['url']), basename($saved_image['path']), $upload['url']);
                    $upload['type'] = 'image/webp';
                    @unlink($file_path);
                }
            }
        }
    }
    return $upload;
}

如何避免這種情況？

你可能會問，以後是不是每次複製貼上都要提心吊膽？答案是：不用慌，但要聰明。

1. 用可靠的編輯器，例如VS Code，能自動高亮出奇怪的字元。
2. 開啟檔案時，嘗試用UTF-8 編碼儲存，能減少一半「鬼符號」的風險。
3. 如果實在不放心，把可疑的程式碼黏在純文字工具裡清洗一遍。

就像吃火鍋前先洗洗菜，少掉不少意外。

結語

這種報錯看似玄學，其實邏輯很清晰。程式設計就像寫詩，標點符號和空格都是節奏的靈魂。一個錯誤的空格，足以讓代碼失去韻律，像樂團裡突然多出來一個跑調的大號。

我們在寫程式碼時，要養成一種「符號潔癖」。做到細節完美，才能讓邏輯運作順暢無比。哲學一點說，這也是對精確性和秩序的追求。

總結

重點有三：

• 報錯不是邏輯問題，而是幽靈空格惹禍。
• 對的修復方法就是要替換成標準半角空格。
• 養成代碼潔癖，遠離潛伏的隱藏字符。

所以，如果你下次遇到看似莫名其妙的報錯，不妨先懷疑一下：是不是有看不見的「幽靈」在作祟？ 行動起來，清理它們，你的程式碼就能順暢運行了。