Guia da Ferramenta de Linha de Comando do ServBay: Instalação, Configuração e Uso

O ServBay oferece não apenas uma interface gráfica de usuário (GUI) intuitiva para gerenciar seu ambiente de desenvolvimento local, mas também poderosas ferramentas integradas de linha de comando. Instalando o CLI do ServBay em seu terminal (como bash ou zsh), você pode executar diretamente diversas ferramentas e pacotes integrados do ServBay via linha de comando, aumentando significativamente sua eficiência e flexibilidade no desenvolvimento.

Pré-requisitos

Antes de usar a ferramenta de linha de comando do ServBay, certifique-se de que o ServBay já está instalado e em execução em seu sistema.

Instalando a ferramenta de linha de comando do ServBay

Veja o passo a passo detalhado para instalar o CLI do ServBay no seu ambiente de terminal:

1. Abra o aplicativo ServBay.

2. Clique na opção Configurações na barra lateral esquerda do ServBay.

   

3. Na página de configurações que será exibida, encontre a seção Ferramenta de linha de comando.

4. Dependendo do terminal que você utiliza no macOS (por padrão, bash ou zsh), clique no botão correspondente:

   • Se você usa o zsh, clique em Instalar ferramenta CLI no zsh.
   • Se você usa o bash, clique em Instalar ferramenta CLI no bash.

   

5. Durante a instalação, normalmente será solicitado que você digite a senha de administrador para modificar arquivos de ambiente do sistema (como .zshrc ou .bash_profile). Autorize a instalação.

6. Após a instalação, lembre-se de fechar e reabrir a janela do seu terminal. A ferramenta CLI do ServBay passará a funcionar corretamente na nova sessão.

Configurando a versão padrão dos pacotes

O ServBay permite definir versões globais padrão para pacotes importantes, como PHP, Node.js, MySQL ou MariaDB. Isso significa que, ao executar comandos como php, node, mysql diretamente no terminal, será usada a versão definida pelo ServBay na interface GUI ou especificada via linha de comando.

Para detalhes completos sobre como definir a versão padrão global, consulte a documentação Definir versão padrão.

Especificando versões por projeto na linha de comando

Para atender às dependências específicas de cada projeto, o ServBay permite que você defina versões de PHP e Node.js no nível de projeto, criando um arquivo .servbay.config na raiz do seu projeto. Isso sobrescreve as definições globais, garantindo que cada projeto utilize sempre as versões corretas dos pacotes e evitando conflitos de versão.

Com o arquivo .servbay.config, é possível definir, além das versões de PHP e Node.js, configurações adicionais em nível de projeto, como versão de execução do Node.js, endereço do repositório de pacotes e diretórios de cache.

Para instruções detalhadas, veja o documento Usando o arquivo .servbay.config.

Executando versões específicas de pacotes diretamente

Além das versões padrão globais e das configurações por projeto, o ServBay adiciona os executáveis de todas as versões dos principais pacotes (como PHP e Node.js) instaladas diretamente ao seu PATH do sistema, com o número da versão como sufixo (por exemplo, php-7.4, php-8.1, php-8.3). Assim, você pode rodar qualquer versão específica desses pacotes diretamente de qualquer janela de terminal, sem alterar configurações globais ou do projeto.

Exemplos de comandos comuns

Após instalar a ferramenta de linha de comando do ServBay, você poderá utilizar diversas ferramentas e comandos integrados no terminal. Veja alguns exemplos frequentes:

• Verificar a versão padrão atual do PHP:

  php -v

• Verificar a versão padrão atual do Node.js:

  node -v

• Executar um script com uma versão específica do PHP:

  php-8.3 your_script.php

  Você pode substituir php-8.3 por qualquer outra versão instalada no ServBay, como php-7.4 ou php-8.1.

• Usar uma versão específica da ferramenta phpize:

  phpize-8.3

  A ferramenta phpize é utilizada para preparar o ambiente de compilação de extensões PHP.

• Conectar ao banco de dados PostgreSQL:

  psql -h localhost -U seu_usuario -d seu_banco

  Substitua seu_usuario e seu_banco pelo nome do usuário e banco de dados reais.

• Conectar ao banco de dados MySQL:

  mysql -h localhost -u seu_usuario -p seu_banco

  Substitua seu_usuario e seu_banco pelos nomes reais de usuário e banco de dados. Após executar o comando, será solicitada a senha de acesso.

• Executar uma consulta SQL:

  psql -h localhost -U seu_usuario -d seu_banco -c "SELECT * FROM sua_tabela;"

  Com o parâmetro -c você pode rodar comandos SQL diretamente da linha de comando.

• Verificar o status do serviço Redis:

  redis-cli info stats

Com estes exemplos, você consegue aproveitar todos os pacotes e serviços fornecidos pelo ServBay no ambiente de linha de comando para um desenvolvimento e depuração mais produtivos.

Observações importantes

• Após instalar a ferramenta de linha de comando, é obrigatório reabrir a janela do terminal para que as variáveis de ambiente atualizadas sejam carregadas.
• Caso altere o caminho de instalação dos pacotes do ServBay, pode ser necessário reinstalar a ferramenta de linha de comando.

Conclusão

A ferramenta de linha de comando do ServBay é uma parte essencial de seu conjunto de funcionalidades, proporcionando aos desenvolvedores acesso direto e eficiente à gestão e ao uso dos diversos pacotes e utilitários do ambiente de desenvolvimento local. Com uma instalação simples, você terá o PHP, Node.js, bancos de dados e outros serviços integrados pelo ServBay acessíveis no terminal, além da flexibilidade para definir versões padrão ou específicas por projeto conforme sua necessidade. Dominar o uso do CLI do ServBay transformará seu fluxo de trabalho local de desenvolvimento e elevará sua produtividade.