DocumentazioneCommerceGuida all’aggiornamento

Applicare le patch

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Esperto
  • Amministratore
  • Sviluppatore

È possibile applicare le patch utilizzando uno dei seguenti metodi:

TIP
Consulta best practice per informazioni sull'applicazione centralizzata di patch per Adobe Commerce su scala aziendale.

Compositore

IMPORTANT
Per applicare le patch di qualità ufficiali, utilizzare Quality Patches Tool. Eseguire sempre test completi prima di distribuire qualsiasi patch personalizzata.

Per applicare una patch personalizzata mediante Compositore:

  1. Apri l’applicazione della riga di comando e passa alla directory del progetto.

  2. Aggiungere il plug-in cweagans/composer-patches al file composer.json.

    code language-bash 
    composer require cweagans/composer-patches

  3. Modificare il file composer.json e aggiungere la sezione seguente per specificare:

    • Modulo: "magento/module-payment"
    • Titolo: "MAGETWO-56934: la pagina di pagamento si blocca quando si ordina con Authorize.net con carta di credito non valida"
    • Percorso patch: "patches/composer/github-issue-6474.diff"

    Ad esempio:

    code language-json 
    "extra": {
    "composer-exit-on-patch-failure": true,
    "patches": {
        "magento/module-payment": {
            "MAGETWO-56934: Checkout page freezes when ordering with Authorize.net with invalid credit card": "patches/composer/github-issue-6474.diff"
        }
    }
}

    Se una patch interessa più moduli, è necessario creare più file di patch destinati a più moduli.

  4. Applichi il cerotto. Utilizzare l'opzione -v solo se si desidera visualizzare le informazioni di debug.

    code language-bash 
    composer -v install

  5. Aggiornare il file composer.lock. Il file di blocco tiene traccia delle patch applicate a ciascun pacchetto Composer di un oggetto.

    code language-bash 
    composer update --lock

Riga di comando

Per applicare le patch dalla riga di comando:

  1. Caricare il file locale nella directory <Magento_root> sul server utilizzando FTP, SFTP, SSH o il normale metodo di trasporto.

  2. Accedere al server come utente amministratore e verificare che il file si trovi nella directory corretta.

  3. Nell’interfaccia della riga di comando, esegui i seguenti comandi in base all’estensione della patch:

    code language-bash 
    patch < patch_file_name.patch

    Il comando presuppone che il file di cui applicare la patch si trovi in relazione al file di patch.

    note note
    NOTE
    Se la riga di comando mostra: File to patch:, significa che non è possibile individuare il file desiderato, anche se il percorso sembra corretto. Nella casella visualizzata nel terminale della riga di comando, la prima riga mostra il file a cui applicare la patch. Copiare il percorso del file e incollarlo nel prompt File to patch:, quindi premere Enter per completare la patch.

  4. Affinché le modifiche vengano applicate, aggiorna la cache nell'amministratore in Sistema > Strumenti > Gestione cache.

    In alternativa, è possibile applicare localmente la patch con lo stesso comando, quindi eseguirne il commit e il push normalmente.

recommendation-more-help
83a60e0e-8849-4685-a8cd-c129ecd795ea