Perché l’esportazione con All-in-One WP Migration a volte fallisce (e come risolvere)

Perché l’esportazione con All-in-One WP Migration a volte fallisce (e come risolvere)

Ti è mai capitato di avviare un’esportazione con All-in-One WP Migration e vederla fallire a metà? Uno dei colpevoli più comuni è semplicemente l’esaurimento dello spazio su disco. Ecco perché succede e il leggero add-on che ho creato per risolvere il problema.

Il problema: i file grandi gonfiano la tua esportazione

Per impostazione predefinita, All-in-One WP Migration impacchetta l’intera installazione di WordPress, compreso tutto ciò che si trova in /wp-content/uploads/. Se la tua libreria multimediale contiene file pesanti, l’archivio può crescere oltre ciò che il tuo piano di hosting (o lo spazio temporaneo su disco) riesce a gestire, facendo fallire l’esportazione.

I tipici divoratori di spazio sono:

  • Audio non compresso come .wav e audio come .mp3
  • Video come .mp4, .mov
  • Archivi e backup come .zip, .rar
Buone notizie: Molti di questi file non sono essenziali per una migrazione. Puoi escluderli per rendere l’esportazione più piccola, più veloce e molto meno soggetta a fallimenti.

La soluzione: escludere specifiche estensioni di file durante l’esportazione

Ho creato un piccolo add-on per All-in-One WP Migration che ti permette di escludere estensioni di file dall’esportazione. Sei tu a decidere quali tipi saltare, per esempio:

wav, mp3, mp4, zip

Questo riduce subito le dimensioni dell’archivio, velocizza il processo e previene i fallimenti legati allo spazio su disco.

Come usarlo

  1. Installa e attiva l’add-on Media Type Excluder for AIWP Migration insieme a All-in-One WP Migration.
  2. Vai su All-in-One WP Migration → Export.
  3. Apri le Advanced options.
  4. Trova Exclude file extensions e inserisci un elenco separato da virgole, ad es. wav, mp3, mp4, zip.
  5. Esegui l’esportazione come al solito.

Il codice dietro l’add-on

Il plugin si aggancia alla fase di esportazione e, in base alle estensioni che fornisci, scorre la directory degli upload per costruire un elenco di file che All-in-One WP Migration deve saltare. Aggiunge anche una piccola interfaccia (una textarea) al pannello Export → Advanced options.

Codice completo del plugin

defined( 'ABSPATH' ) || exit; // Exit if accessed directly.
/**
 * Exclude extensions from All-in-One WP Migration export.
 *
 * This plugin uses the `ai1wm_exclude_media_from_export` filter to remove specific file extensions from the export process.
 * types from the exported archive.
 */
add_filter( 'ai1wm_exclude_media_from_export', function( $filters ) {
    if( ! isset( $_POST['ai1wm_no_extensions'] ) || empty( $_POST['ai1wm_no_extensions'] ) ) { // phpcs:ignore WordPress.Security.NonceVerification
        return $filters; // If the textarea is not set, return the original filters.
    }
    $upload_dir = wp_get_upload_dir();
    $base_dir   = trailingslashit( $upload_dir['basedir'] );
    $exts       = str_replace( '.', '', sanitize_textarea_field( wp_unslash( $_POST['ai1wm_no_extensions'] ) ) ); // phpcs:ignore WordPress.Security.NonceVerification
    $extensions = array_filter( array_map( 'trim', explode( ',', $exts ) ) );
    $extensions = apply_filters( 'eafaiowpm_exclude_extensions', $extensions );
    $iterator = new RecursiveIteratorIterator(
        new RecursiveDirectoryIterator( $base_dir, RecursiveDirectoryIterator::SKIP_DOTS )
    );
    foreach ( $iterator as $file ) {
        /** @var SplFileInfo $file */
        if ( $file->isFile() ) {
            $ext = strtolower( $file->getExtension() );
            if ( in_array( $ext, $extensions, true ) ) {
                $exclude_paths[] = $file->getPathname();
            }
        }
    }
    return $exclude_paths;
});

// Add textarea to Advanced Options
add_action( 'ai1wm_export_advanced_settings', function() {
    ?>
    <li>
        <label for="ai1wm-no-extensions">
            <?php esc_html_e( 'Exclude file extensions', 'media-type-excluder-for-aiowp-migration' ); ?>
            <textarea id="ai1wm-no-extensions" name="ai1wm_no_extensions" rows="4" style="width: 100%;"><?php echo esc_textarea( get_option( 'ai1wm_no_extensions', '' ) ); ?></textarea>
            <?php esc_html_e( 'Separate them by comma.', 'media-type-excluder-for-aiowp-migration' ); ?>
        </label>
    </li>
    <?php
});

I punti chiave spiegati

  • add_filter( 'ai1wm_exclude_media_from_export', ... ) — si inserisce nella pipeline di esportazione e ci permette di passare un array di percorsi di file da escludere.
  • Input dell’utente — una textarea nelle Advanced options raccoglie un elenco di estensioni separate da virgole (ad es. wav, mp3). I punti vengono rimossi per comodità.
  • Scansione della directory — un iteratore ricorsivo scorre wp-content/uploads, confrontando l’estensione di ogni file con il tuo elenco e costruendo $exclude_paths.
  • Risultato — quei percorsi vengono restituiti ad All-in-One WP Migration, che li lascia fuori dall’esportazione.
Consiglio per gli sviluppatori: Puoi pre-elaborare o imporre un insieme predefinito di estensioni tramite apply_filters( 'eafaiowpm_exclude_extensions', $extensions ) nel tuo tema o in un altro plugin.

FAQ

E se mi servono quei file in seguito?

Puoi sempre eseguire un secondo trasferimento solo dei media o sincronizzarli più tardi via SFTP/SSH/CDN. L’obiettivo qui è far riuscire in modo affidabile l’esportazione del sito principale.

In sintesi

I fallimenti delle esportazioni con All-in-One WP Migration dipendono spesso dallo spazio su disco. Escludendo i tipi di file pesanti come .wav, .mp3 o .zip, le tue esportazioni diventano più piccole, più veloci e molto meno soggette a errori.

Articoli correlati

Come aggiornare un plugin di WordPress in sicurezza

Per scoprire come aggiornare un plugin di WordPress in sicurezza, leggi la guida dettagliata qui:
Come aggiornare un plugin di WordPress in sicurezza

Servizi correlati

Aiuto in caso di problemi dopo l’aggiornamento di un plugin

Vuoi stare tranquillo quando aggiorni i tuoi plugin? Dai un’occhiata al nostro Plugin Update Rescue – Annual Protection Plan
Se qualcosa si rompe dopo un aggiornamento, interveniamo noi e lo sistemiamo.