Como usar Composer para gerenciar dependências PHP Print

Como usar Composer para gerenciar dependências PHP na GeHost

Olá, querido(a) cliente! Seja bem-vindo(a) ao seu novo passo rumo ao desenvolvimento web mais organizado e tranquilo. Aqui na GeHost, acreditamos que todo mundo pode aprender a cuidar do seu site com confiança — mesmo que seja sua primeira vez com PHP.

Hoje vamos aprender a usar Composer, uma ferramenta essencial para gerenciar as bibliotecas (ou "dependências") que seu projeto PHP precisa. Isso evita o trabalho manual de baixar e atualizar arquivos, e deixa tudo mais seguro e controlado.

Antes de começar: o que é Composer?

Imagine que seu site é uma receita. Em vez de comprar todos os ingredientes separadamente, você tem um "kit de ingredientes" que já vem com tudo o que precisa — e, quando um novo ingrediente é lançado, você atualiza o kit automaticamente.

Composer é esse kit para projetos PHP. Ele cuida de instalar, atualizar e gerenciar todas as bibliotecas que seu site depende.

Passo a passo: instalar e usar Composer no cPanel da GeHost

1. Acesse o cPanel da sua conta

Primeiro, faça login no seu painel de controle. Você pode acessar o cPanel por meio do link da sua conta na GeHost.

2. Localize a ferramenta "Terminal" no cPanel

Na página inicial do cPanel (tela de home), procure pela seção “Outras Ferramentas” ou “Ferramentas de Desenvolvimento”. Lá, você encontrará a opção Terminal.

3. Abra o Terminal e verifique se o Composer está instalado

Clique em Terminal para abrir uma janela de comando. Em seguida, digite:

composer --version

Se aparecer uma versão (como Composer version 2.7.10), parabéns! Você já tem o Composer instalado. Se não aparecer nada ou der erro, não se preocupe — vamos instalar agora.

4. Instale o Composer (se necessário)

Se o Composer não estiver instalado, digite os comandos abaixo um por um no Terminal:

1. cd /home/seu_usuario — substitua seu_usuario pelo nome da sua conta no cPanel.
2. curl -sS https://getcomposer.org/installer | php
3. mv composer.phar /usr/local/bin/composer
4. chmod +x /usr/local/bin/composer

Pronto! Agora o Composer está disponível em qualquer lugar do seu servidor.

5. Vá até a pasta do seu projeto no cPanel

No cPanel, vá até a ferramenta Gerenciador de Arquivos (File Manager).

Abra a pasta onde seu projeto PHP está localizado — normalmente public_html ou uma subpasta como meu-site.

6. Crie o arquivo composer.json

No diretório do seu projeto, crie um novo arquivo chamado composer.json. Você pode fazer isso diretamente no Gerenciador de Arquivos — clique em “Novo Arquivo”, nomeie como composer.json e cole o conteúdo abaixo:

{
  "name": "meu/projeto",
  "description": "Meu projeto PHP com Composer",
  "require": {
    "php": "^8.1",
    "monolog/monolog": "^2.0"
  },
  "autoload": {
    "psr-4": {
      "App\\": "src/"
    }
  }
}

Esse arquivo diz ao Composer quais bibliotecas seu projeto precisa. No exemplo acima, estamos pedindo o Monolog, uma biblioteca de log popular.

7. Instale as dependências com Composer

Volte ao Terminal e, dentro da pasta do seu projeto, digite:

composer install

Se tudo estiver certo, o Composer vai baixar automaticamente o Monolog e outras dependências listadas, colocando-as na pasta vendor/.

8. Use suas dependências no código

Quando quiser usar uma biblioteca instalada, basta incluir o autoload do Composer no seu código PHP:

require_once 'vendor/autoload.php';

use Monolog\Logger;
use Monolog\Handler\StreamHandler;

$logger = new Logger('meu_app');
$logger->pushHandler(new StreamHandler('logs/app.log', Logger::INFO));
$logger->info('O sistema foi iniciado com sucesso!');

Pronto! Agora seu projeto está usando bibliotecas de forma segura e organizada.

Dicas do Sensei da GeHost

• Atualize sempre: Use composer update quando quiser atualizar suas bibliotecas para versões mais novas e seguras.
• Nunca suba o diretório vendor ao servidor — ele é gerado automaticamente. Use apenas o composer.json e composer.lock.
• Use o composer.lock para garantir que todos os desenvolvedores (e servidores) usem as mesmas versões.
• Se tiver dúvidas, sempre consulte a documentação oficial — é clara, gratuita e cheia de exemplos.

Conclusão

Usar Composer pode parecer um passo a mais no início, mas ele é como um guardião do seu código — evita erros, garante compatibilidade e torna o desenvolvimento mais rápido e seguro.

Se você seguiu todos os passos, parabéns! Você agora é um(a) desenvolvedor(a) com ferramentas profissionais no seu arsenal. E lembre-se: na GeHost, você não está sozinho. Estamos aqui para ajudar sempre.

Com carinho, seu Sensei da GeHost 🌿