DocumentaçãoCommerceGuia de atualização

Aplicar patches

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

Criado para:

  • Experiente
  • Administrador
  • Desenvolvedor

Você pode aplicar patches usando qualquer um dos métodos a seguir:

TIP
Consulte práticas recomendadas para obter informações sobre patches centralizados para o Adobe Commerce em escala corporativa.

Compositor

IMPORTANT
Para aplicar patches de qualidade oficiais, use o Quality Patches Tool. Sempre realize testes abrangentes antes de implantar qualquer patch personalizado.

Para aplicar um patch personalizado usando o Composer:

  1. Abra o aplicativo de linha de comando e navegue até o diretório do projeto.

  2. Adicionar o plug-in cweagans/composer-patches ao arquivo composer.json.

    code language-bash 
    composer require cweagans/composer-patches

  3. Edite o arquivo composer.json e adicione a seguinte seção para especificar:

    • Módulo: "magento/module-payment"
    • Título: "MAGETWO-56934: a página de check-out congela ao fazer pedidos com Authorize.net com cartão de crédito inválido"
    • Caminho para correção: "patches/composer/github-issue-6474.diff"

    Por exemplo:

    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 um patch afetar vários módulos, você deverá criar vários arquivos de patch direcionados a vários módulos.

  4. Aplique o patch. Use a opção -v somente se desejar ver informações de depuração.

    code language-bash 
    composer -v install

  5. Atualize o arquivo composer.lock. O arquivo de bloqueio rastreia quais patches foram aplicados a cada pacote do Composer em um objeto.

    code language-bash 
    composer update --lock

Linha de comando

Para aplicar patches a partir da linha de comando:

  1. Carregue o arquivo local no diretório <Magento_root> no servidor usando FTP, SFTP, SSH ou seu método de transporte normal.

  2. Faça logon no servidor como o usuário administrador e verifique se o arquivo está no diretório correto.

  3. Na interface de linha de comando, execute os seguintes comandos de acordo com a extensão de patch:

    code language-bash 
    patch < patch_file_name.patch

    O comando presume que o arquivo a ser corrigido está localizado em relação ao arquivo de correção.

    note note
    NOTE
    Se a linha de comando mostrar: File to patch:, significa que não é possível localizar o arquivo pretendido, mesmo que o caminho pareça correto. Na caixa exibida no terminal de linha de comando, a primeira linha mostra o arquivo a ser corrigido. Copie o caminho do arquivo e cole-o no prompt File to patch: e pressione Enter para que o patch seja concluído.

  4. Para que as alterações sejam refletidas, atualize o cache no Administrador em Sistema > Ferramentas > Gerenciamento de Cache.

    Como alternativa, o patch pode ser aplicado localmente com o mesmo comando, depois confirmado e enviado normalmente.

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