Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. OpenCart
Code

Integrando Bibliotecas Externas no OpenCart Usando Composer

by
Difficulty:IntermediateLength:ShortLanguages:

Portuguese (Português) translation by Erick Patrick (you can also view the original English article)

Quase todo framework hoje em dia traz suporte ao Composer, uma ótima ferramenta de administração de dependência em PHP, e o OpenCart não é excessão. Hoje, aprenderemos como usar Composer para integrar bibliotecas externas no OpenCart.

O Papel do Composer no OpenCart

Desde o OpenCart 2.2, fluxo de trabalho com Composer é suportado. Então, baixemos a versão mais atual da OpenCart (no momento é a 2.3.0.2). Instalemos e configuremo-na já que será útil mais tarde no artigo.

Exploremos a estrutura de diretórios e veremos algumas diferenças comparadas a versões anteriores do OpenCart. No contexto desse artigo, os candidatos são os arquivos composer.json e o diretório vendor.

Vejamos rapidamente o arquivo composer.json.

Embora uma discussão da sintaxe do Composer esteja fora do escopo do artigo, expliquemos rapidamente em termos leigos.

Primeiro, o projeto OpenCart em si está disponível como uma biblioteca, então poderíamos instalá-lo via Composer sem ter de baixá-lo manualmente pelo site. Depois, também requer bibliotecas de terceiros para funcionar, como divido, leafo, etc. Claro, não precisamos nos preocupar com isso, já que o Composer cuidara de tudo ao executar seus comandos.

Ao instalar uma nova biblioteca, uma entrada respectiva será adicionada ao composer.json. Os arquivos dela serão colocados na pasta vendor. Exploremos esse diretório e veremos as bibliotecas já instaladas!

A pasta vendor também contém o autoload.php, gerado pelo composer em si, garantido que as bibliotecas do OpenCart são carregadas automaticamente, permtindo usá-lo direto. Claro, OpenCart usa o autoload.php ao inicializar o projeto.

Eis a introdução ao funcionamento do Composer no OpenCart. Para propósito de demonstração, usaremos a popular biblioteca PHPMailer usando Composer.

Instalando PHPMailer Usando Composer

PHPMailer é uma biblioteca popular em PHP usada para enviar emails. Instalaremo-na no OpenCart usando Composer. Então, vamos ao terminal e acessemos o diretório que fica o composer.json do projeto.

Agora, executemos o comando composer require phpmailer/phpmailer e apertemos enter! Se tudo saiu bem, o resultado deve ser parecido com isso.

E é isso! PHPMailer foi baixado e instalado com sucesso e essa é a beleza do Composer! Verifiquemos olhando a pasta vendor e acharemos ela instalada na pasta phpmailr/phpmailer.

Agora, vejamos o composer.json para ver como é.

Como vemos, "phpmailer/phpmailer": "^5.2" foi adicionado na seção require. Isso significa que nosso projeto requer PHPMailer para funcionar.

Assumamos que trabalhamos com outros desenvolvedores e precisamos compartilhar trabalho regularmente. Nesse caso, precisamos compartilhar só o composer.json e o resto será lidado pelo Composer em si! Eles só precisarão executar composer update e isso instalará as dependências requeridas em seus computadores.

Agora, já instalamos PHPMailer usando Composer, como usá-la? É exatamente isso que veremos na próxima seção!

Como Usar a Biblioteca PHPMailer?

Já fizemos um favor a nós mesmos ao usar Composer para instalar PHPMailer, agora, vejamos como é bem simples usá-la em nosso código.

Para exemplos, construiremos um pequeno controlador que invocaremos para enviar emails.

Abramos nosso editor de código e criemos o arquivo example/email.php na pasta catalog/controller com o conteúdo a seguir.

Podemos testá-lo acessando o site via http://url-do-site-open-cart/index.php?route=example/email.

No método index, vemos que instanciamos o objeto PHPMailer sem qualquer declaração de inclusão que seria usada para invocar as classes do PHPMailer se não usássemos o fluxo de trabalho do Composer. E você está certo, foi carregado automaticamente pelo OpenCart. Lembremo-nos que autoload.php na pasta vendor faz essa mágica!

Após isso, é só usar código padrão do PHPMailer para enviar email. Claro, esse exemplo é bem simples, já que tratar do PHPMailer requer um artigo próprio!

Assim, essa foi uma introdução rápida de como usar Composer com OpenCart para integrar bibliotecas externas.

Conclusão

Nesse artigo, vimos só o básico do fluxo de trabalho com Composer no OpenCar ao usar bibliotecas de terceiros em nossos projetos. Sem mencionar que o Composer é o futuro da administração de dependências em PHP. Então, é sempre bom sujar as mãos com ele já que tem se tornado o padrão nos principais frameworks.

Perguntas e sugestões são sempre bem vindas!

Advertisement
Advertisement
Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.