joelpiccoli / instalacao-ambiente

Instalação de um ambiente de desenvolvimento com PHP, MySQL e Nginx no Linux

Configuração do ambiente

Passo a passo rápido de como ter um ambiente com Git, PHP, MySQL, NodeJS e Nginx funcionando no Linux.

• Atualização do Sistema
• Instalação do Git
• Instalar Oh-My-Zsh
• Instalar o PHP 8.3
• Instalar o Composer
• Instalar Nginx
• Instalar o MySQL
• Instalar o NodeJS
• Usando o Linux Valet
• Aliases
• WSL Considerações

---

Atualização do Sistema

sudo apt update && sudo apt upgrade

---

Instalação do Git

sudo add-apt-repository ppa:git-core/ppa
sudo apt update

Se desejar instalar o git-flow

sudo apt install -y git git-flow

---

Instalar Oh My Zsh

sudo apt install zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"

Após instalar o Oh-my-zsh vamos instalar o pacote do ZSH-autosuggestions. Primeiro clone o projeto.

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

Após isso edite o arquivo ~/.zshrc e adicione o plugin a lista de plugins.

plugins=( 
    # other plugins...
    zsh-autosuggestions
)

Depois é só reabrir o terminal ou executar o comando source ~/.zshrc para dar reload.

---

Instalar o PHP

sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install -y php8.3-cli php8.3-fpm php8.3-mysql php8.3-zip php8.3-dom php8.3-mbstring php8.3-curl php8.3-gd php8.3-bcmath php8.3-redis php8.3-xdebug php8.3-memcached

---

Instalar o Composer

1. Baixar o Composer

curl -sS https://getcomposer.org/installer -o composer-setup.php
php composer-setup.php
php -r "unlink('composer-setup.php');"

2. Instalar o Composer

sudo mv composer.phar /usr/local/bin/composer

3. Adicionar no Path

sudo nano ~/.zshrc

adicionar esse trecho ao final do arquivo e salvar

export PATH="$PATH:$HOME/.config/composer/vendor/bin"

atualizar o bash

source ~/.zshrc

Important

Algumas vezes, é possível que ao tentar baixar um package ou dar update em algum projeto você encare um erro de timeout ao conectar-se com o Packagist. Nesse caso, abra o terminal e execute o seguinte comando:

sudo sh -c "echo 'precedence ::ffff:0:0/96 100' >> /etc/gai.conf"

Iso fará com que o IPv4 tenha preferência sobre o IPv6. Isso deve resolver o problema de conexão com o Packagist.

---

Instalar Nginx

sudo add-apt-repository ppa:nginx/stable
sudo apt update
sudo apt install -y nginx

---

Instalar o MySQL

sudo apt install mysql-server

Após isso execute

mysql_secure_installation

Se for pedido o password você pode ter que alterar a forma de autenticação do root, se for o caso, siga os proximos passos:

sudo mysql -u root

Execute o seguinte:

USE mysql;
UPDATE user SET plugin='mysql_native_password' WHERE User='root';
FLUSH PRIVILEGES;
exit;

Atualize o MySQL

sudo service mysql restart

Após execute novamente o comando mysql_secure_installation e deve funcionar ok.

Fonte: ERROR 1698 (28000): Access denied for user 'root'@'localhost'

---

Instalar o Node

Sobre a versão

Important

Aqui estamos instalando a última versão LTS do NodeJS, mas você pode instalar a que achar melhor só trocando a versão. Mais informações aqui.

1. Faca o download e importaćão do Nodesource GPG key

sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg

2. Crie o repositório deb

NODE_MAJOR=20
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list

3. Atualize os repositórios e instale o node

sudo apt-get update
sudo apt-get install nodejs -y

Warning

Para corrigir o problema de permissão ao instalar pacotes globais com o npm siga as informações nesse link: Resolving eacces permissions

---

Usando o Linux Valet

Para disponibilizar os seus projetos em ambiente local de desenvolvimento você pode usar o Linux Valet.

Para fazer isso, instale o mesmo com o composer de forma global.

composer global require cpriego/valet-linux

Após, verifique que todas as dependências estão instaladas.

sudo apt install -y network-manager libnss3-tools jq xsel

Só então pode executar o comando pra instalar o valet.

valet install

Agora é só ir até a pasta onde seus projetos estão localizados e executar o comando valet park.

Veja a documentação oficial sobre o Laravel Valet.

• Thanks to Carlos Priego for making our lives even easier on Linux! ;)

Aliases

baixe os dois arquivos, .bash_aliases e .bash_funcions* na raiz do seu usuário e importe os dois dentro de .zshrc bem no final do arquivo.

if [ -f ~/.bash_aliases ]; then
    . ~/.bash_aliases
fi

if [ -f ~/.bash_functions ]; then
    . ~/.bash_functions
fi

Assim os alias e functions estarão disponíveis para o sistema.

---

*créditos à Aaroh Mankad pelas functions!

---

Important

WSL Considerações

Devido a algumas limitações na arquitetura do WSL, não é possível iniciar serviços automaticamente pelo systemd. Para contornar isso podemos iniciar esses serviços a partir do nosso arquivo .bashrc ou .zshrc e desabilitar a necessidade de perguntar a senha do sudo para esses serviços.

Edite o arquivo /etc/sudoers e adicione as seguintes linhas:

%sudo ALL=NOPASSWD: /etc/init.d/mysql
%sudo ALL=NOPASSWD: /etc/init.d/nginx
%sudo ALL=NOPASSWD: /etc/init.d/php8.1-fpm

Após isso edite seu arquivo .zshrc ou .bashrc e adicione as seguintes linhas:

sudo /etc/init.d/nginx start
sudo /etc/init.d/mysql start
sudo /etc/init.d/php8.1-fpm start

fonte: Criando um ambiente de desenvolvimento PHP com WSL