Converter for Media – 圖片最佳化 | 轉換 WebP 及 AVIF

常見問題集

如何回報安全性錯誤？

您可以透過 Patchstack 弱點揭露計畫回報安全性錯誤。Patchstack 團隊會協助驗證、分類及處理任何安全性弱點。

回報安全性漏洞

如何取得技術支援？（尋求協助前）

新增討論串前，請先閱讀此常見問題中的所有其他問題，以及支援論壇中的其他討論串。或許有人遇過類似問題，而且問題已經獲得解決。

新增討論串時，請依照以下步驟操作，並逐一回覆每一項問題或要求：

1. 外掛設定頁面上是否有任何錯誤？如果您有任何錯誤，請閱讀這個討論串。

2. 您網站的 URL。

3. 外掛設定畫面中「說明中心」分頁的螢幕擷取畫面 — 請擷取整個頁面。

4. 請執行 FAQ 中「如何確認外掛程式是否正常運作？」所述的測試。請傳送包含測試結果的 DevTools 螢幕擷取畫面。

請記得在新增討論串時回答所有問題。這樣更容易，也能加快問題的解決速度。

Nginx 設定

如果您使用不支援 .htaccess 規則的 Nginx 伺服器，則需要額外的 Nginx 伺服器組態，外掛才能正常運作。

如需更多資訊，請閱讀這篇教學課程。

Nginx Proxy 的設定

如果您使用支援 .htaccess 規則的 Nginx 伺服器，但外掛程式設定頁面仍出現伺服器設定錯誤，則需要額外設定 Nginx 伺服器，外掛程式才能正常運作。

如需更多資訊，請閱讀 這份教學課程。

外掛程式設定畫面發生錯誤？

如果您在外掛程式設定畫面上看到錯誤，請先仔細閱讀錯誤內容。這些錯誤會在伺服器或網站設定發生問題時顯示。

這些訊息旨在減少重複的支援要求，節省您和我們的時間。請閱讀 這個討論串以取得更多資訊。

轉換時發生錯誤？

轉換時可能會發生幾種錯誤。首先，請仔細閱讀錯誤內容。在大多數情況下，您可以自行解決這個問題。請嘗試自行處理，或聯絡伺服器管理員。

如果您收到錯誤：File "%s" does not exist. Please check file path.，表示 PHP 中的 file_exists() 函式使用錯誤訊息中提供的檔案路徑時，回傳了 false。請檢查此路徑，並確認路徑正確。

如果您遇到錯誤：檔案 "%s" 無法讀取。請檢查檔案權限。，這表示 PHP 中的 is_readable() 函式使用錯誤訊息中提供的檔案路徑時回傳了 false。請檢查檔案及其所在目錄的權限。

如果您收到錯誤："%s" is not a valid image file.，這表示檔案已損毀。請將檔案下載至磁碟，使用任何繪圖程式重新儲存，然後再次將檔案新增至頁面。如果錯誤只套用至個別圖片，您可以忽略此錯誤—只會載入原始圖片，不會載入 WebP 圖片。

如果您收到錯誤：Image "%s" converted to .webp is larger than original and converted .webp file has been deleted.，表示原始圖片的檔案大小小於 WebP。這會在圖片先前已經壓縮過時發生。請在外掛設定中停用 「輸出格式大於原始檔案時自動移除檔案」 選項，以強制一律使用 WebP。

外掛有哪些需求？

幾乎所有主機服務都符合這些需求。您必須使用至少 7.0 版的 PHP，並安裝 GD 或 Imagick 擴充功能。擴充功能必須支援 WebP format。 如果您收到 GD 或 Imagick 程式庫未安裝的錯誤，但實際上已安裝，則很可能是設定不正確且不支援 WebP。

這些是必要的原生 PHP 擴充功能，WordPress 等軟體會使用它們來產生縮圖。您的伺服器也必須啟用 mod_mime、mod_rewrite 和 mod_expires 模組。

正確伺服器組態的範例可以在此處找到。外掛程式設定畫面的說明中心分頁中，可以找到目前組態的連結。

請注意標示為紅色的項目。 如果您的情況中沒有顯示標示為紅色的值，表示您的伺服器不符合技術需求。請注意 GD 程式庫的 WebP Support 值，以及 Imagick 程式庫支援擴充功能清單中的 WEBP。

如果您的伺服器不符合技術需求，請聯絡您的伺服器管理員。我們無法協助您。請勿就此事聯絡我們，因為這是伺服器設定問題，而非外掛程式問題。

此外，REST API 必須啟用且能在沒有其他限制的情況下正常運作。如果遇到問題，請聯絡建立您網站的開發人員。他應該能輕鬆找出 REST API 無法正常運作的問題。

如何確認外掛是否正常運作？

如要進一步了解外掛程式的運作方式，請參閱我們的手冊。

如何變更 uploads 的路徑？

您可以使用以下類型的篩選器變更預設路徑。這是提供進階使用者使用的解決方案。如果您不是進階使用者，請略過此問題。

WordPress 根安裝目錄的路徑（預設為 ABSPATH）：

add_filter( 'webpc_site_root', function( $path ) {
    return ABSPATH;
} );

目錄的路徑（相對於根目錄）：

add_filter( 'webpc_dir_name', function( $path, $directory ) {
    switch ( $directory ) {
        case 'uploads':
            return 'wp-content/uploads';
        case 'webp':
            return 'wp-content/uploads-webpc';
        case 'plugins':
            return 'wp-content/plugins';
        case 'themes':
            return 'wp-content/themes';
    }
    return $path;
}, 10, 2 );

請注意，/uploads-webpc 目錄必須與 /uploads、/plugins 和 /themes 目錄位於相同的巢狀層級。

/wp-content/ 目錄 URL 中的前置詞或等效項目 （用於 .htaccess）：

add_filter( 'webpc_htaccess_rewrite_path', function( $prefix ) {
    return '/';
} );

以下自訂 WordPress 結構範例：

...
├── web
    ...
    ├── app
    │   ├── mu-plugins
    │   ├── plugins
    │   ├── themes
    │   └── uploads
    ├── wp-config.php
    ...

使用以下篩選器：

add_filter( 'webpc_site_root', function( $path ) {
    return 'C:/WAMP/www/project/web'; // your valid path to root
} );
add_filter( 'webpc_htaccess_rewrite_path', function( $prefix ) {
    return '/';
} );
add_filter( 'webpc_dir_name', function( $path, $directory ) {
    switch ( $directory ) {
        case 'uploads':
            return 'app/uploads';
        case 'webp':
            return 'app/uploads-webpc';
        case 'plugins':
            return 'app/plugins';
        case 'themes':
            return 'app/themes';
    }
    return $path;
}, 10, 2 );

設定篩選條件後，前往管理面板中的 Settings -> Converter for Media，然後按一下 Save Changes 按鈕。具有適當規則的 .htaccess 檔案應建立在 /uploads 與 /uploads-webpc 目錄中。

如何排除不進行轉換的路徑？

若要排除選取的目錄，請在外掛程式設定中的進階設定分頁之 Excluded directories 欄位中提供這些目錄。

在此欄位中，您可以輸入目錄名稱或路徑。以下是範例：
– 2023
– 2024/01
– 2023,2024/01

若要排除選取的檔案，請使用以下篩選器 （在此案例中，檔名會使用字尾 “-skipped”，例如 image-skipped.png）：

add_filter( 'webpc_supported_source_file', function( bool $status, string $file_name, string $server_path ): bool {
    $excluded_suffix = '-skipped';
    if ( strpos( $file_name, $excluded_suffix . '.' ) !== false ) {
        return false;
    }
    return $status;
}, 10, 3 );

引數 $server_path 是目錄或檔案的絕對伺服器路徑。在篩選器中，您可以視需要套用更複雜的規則。

排除的目錄和檔案所做的變更會在圖片轉換前生效，不會影響已轉換的圖片。這些圖片必須從下列目錄手動移除：/wp-content/uploads-webpc/。

自訂目錄支援

外掛程式預設支援以下目錄：
– /gallery
– /plugins
– /themes
– /uploads

如果您想要新增自訂目錄的支援，請將下列程式碼新增至佈景主題目錄中的 functions.php 檔案（請使用正確的目錄名稱取代 custom-directory）：

add_filter( 'webpc_source_directories', function ( $directories ) {
    $directories[] = 'custom-directory';
    return $directories;
} );

請記住，此目錄必須位於 /wp-content 目錄中。

如何手動執行轉換？

依預設，按一下 Start Bulk Optimization 按鈕時，會轉換所有圖片。此外，將新檔案新增至媒體庫時，也會自動進行轉換。

請記住，我們的外掛程式會將 WordPress 產生的圖片納入處理。有許多外掛程式會產生例如不同尺寸或不同版本的圖片。

如果您想與自行產生圖片的外掛程式整合，也可以這麼做。我們的外掛程式提供這類整合功能。這適用於 /wp-content 目錄中的所有圖片。

這是提供進階使用者使用的解決方案。如果您想與其他外掛程式整合，最好聯絡該外掛程式的作者，並提供我們外掛程式中可用操作的資訊。這將協助您更快找到解決方案。

若要手動轉換選取的檔案，可以使用下列動作，傳入包含路徑清單的陣列 （這些路徑必須是絕對伺服器路徑）：

do_action( 'webpc_convert_paths', $paths, true );

另一種方法是從媒體庫傳入文章 ID，手動開始轉換選取的附件。請記得在註冊所有圖片尺寸後（也就是執行 add_image_size 函式後）再執行此動作：

do_action( 'webpc_convert_attachment', $post_id, true );

若要刪除手動轉換的檔案，請使用下列動作，並將包含檔案絕對伺服器路徑的陣列作為引數 （這會刪除手動轉換的檔案）：

do_action( 'webpc_delete_paths', $paths );

WP-CLI 支援

此外掛程式支援 WP-CLI，可在伺服器層級更快速地轉換圖片。如何開始使用 WP-CLI 的詳細資訊，請參閱 手冊。支援的命令如下所述。

檢查網站上可轉換圖片的數量上限：

wp converter-for-media calculate

轉換所有圖片：

wp converter-for-media regenerate

轉換所有圖片（使用「強制再次轉換所有圖片」選項）：

wp converter-for-media regenerate --force

外掛程式支援 CDN 嗎？

網站檔案（WordPress 檔案）和媒體庫中的圖片必須位於同一部伺服器上。如果是這樣，一切應該都能正常運作。

如果只有您的圖片位於另一部 CDN 伺服器上，很遺憾將無法正常運作，因為這類圖片是由另一部伺服器管理。

目前支援的 CDN 伺服器清單：
– BunnyCDN（使用前請參閱相關說明）