Forem: André Sousa

[PHP] - Desafio Alura - 7 Days of Code - Dia 2

André Sousa — Fri, 02 Jun 2023 17:08:41 +0000

No post anterior, falamos um pouco sobre a iniciativa 7 Days of Code e também foi dada uma visão geral sobre o desafio de PHP, bem como a estrutura geral do projeto com o qual estamos trabalhando.

Por enquanto, o código não está grande, porém, se não tomarmos cuidado, ele terá cada vez mais dívidas técnicas, causadas pela falta de boas práticas. Devemos nos atentar a isso, além de cumprir o desafio do dia. Dito isso...

Bora pro segundo dia!

Nossa segunda tarefa é bem simples: criar uma função que salve os dados dos usuários vindos do formulário de registro.

Os usuários cadastrados ficarão salvos em data/users.json. A extensão do arquivo já nos dá uma dica de funções que serão úteis para persistirmos os dados, como json_encode e json_decode.

Para isso, um novo arquivo foi criado: crud.php. Nele, implementei duas funções: a primeira, pega os dados vindos da requisição POST, insere no registro de usuários e grava os dados no arquivo.

A segunda função serve apenas para retornar a lista de usuários devidamente formatada (como array) para que possamos manipula-la mais facilmente, e também por ser uma funcionalidade que, provavelmente, será utilizada mais vezes. Dessa forma, evitamos a repetição de código.

crud.php

<?php

function crudCreate($user) {
    $usersList = getUsersList();

    $usersList[] = $user;

    $usersList = json_encode($usersList);

    file_put_contents(DATA_LOCATION, $usersList);
}

function getUsersList(): array {
    return json_decode(file_get_contents(DATA_LOCATION));
}

Outra alteração necessária foi no controller.php, mais especificamente na função doRegister(). Nele, eu precisei criar uma verificação para quando chegasse uma requisição via POST. Neste caso, o sistema deve realizar o registro do usuário e voltar para a tela de login. Caso contrário, ou seja, se for uma requisição via GET, deve apenas exibir a tela de registro.

function doRegister() {
    if (isset($_POST['person'])) {
        crudCreate($_POST['person']);
        header('Location: /?page=login');
    }

    renderView('register');
}

Com isso, finalizamos o segundo dia do desafio! Até a próxima!

[PHP] - Desafio Alura - 7 Days of Code - Dia 1

André Sousa — Thu, 01 Jun 2023 18:07:33 +0000

Nesta série de posts, vou apresentar a vocês minha trajetória durante a execução do desafio de PHP 7 Days of Code, uma iniciativa da Alura.

Tais desafios consistem da apresentação de um problema inicial que, geralmente, é uma simulação de uma demanda do mundo real. A cada dia, nós devemos cuidar de uma parte específica do projeto, implementando uma funcionalidade nova, resolvendo algum problema, ou os dois.

Para falar do primeiro dia, antes vou comentar brevemente sobre a estrutura inicial do projeto:

├── boot.php
├── config.php
├── 📁 data
│   └── users.json
├── index.php
├── 📁 resource
├── routes.php
├── 📁 view

boot.php: Carrega os arquivos necessários para a execução do projeto;
config.php: Declaração de constantes;
data/users.json: Nosso "banco de dados" local;
index.php: Ponto inicial do projeto;
resource/: Arquivos de imagem e de estilização;
routes.php: Chama a função específica do Controller (a ser implementado) de acordo com a página solicitada;
view/: Contém todos os arquivos de template, os quais serão mostrados de acordo com a rota acessada

A tarefa do primeiro dia consistiu apenas em separar a responsabilidade do arquivo routes.php que, além de checar qual página estava sendo requisitada, também mostrava o template correspondente.

routes.php

<?php
$page = ($_GET['page']??'login').'.view';
$content = file_get_contents(VIEW_FOLDER.$page);
echo $content;

Com isso, foi requisitada a criação de dois arquivos: controller.php e view.php. O Controller abriga as funções que serão chamadas pelo arquivo de rotas e executadas de acordo com a página solicitada. Já a View contém a função responsável pela exibição do conteúdo em tela de acordo com o template solicitado.

controller.php

<?php

function doRegister() {
    renderView('register');
}

function doLogin() {
    renderView('login');
}

function doNotFound() {
    renderView('not_found');
    http_response_code(404);
}

view.php

<?php

function renderView($template) {
    $content = file_get_contents(VIEW_FOLDER . $template . '.view');
    echo $content;
}

A refatoração em routes.php consistiu em criar um switch para a variável $page. Dessa forma, eu posso controlar melhor o que fazer em cada caso, além de melhorar a leitura do código. Também retirei as linhas de código que mostravam o conteúdo na tela e joguei para view.php.

routes.php depois da refatoração

<?php

$page = ($_GET['page'] ?? 'login');

switch ($page) {
    case 'login':
        doLogin();
        break;

    case 'register':
        doRegister();
        break;

    default:
        doNotFound();
        break;
}

Dessa forma, concluímos o primeiro dia do desafio. Nada muito complicado, porém ainda há muitas funcionalidades e melhorias a serem implementadas. Te vejo na próxima ou nos comentários!

Configurando um ambiente de desenvolvimento no Ubuntu 22.04

André Sousa — Wed, 01 Mar 2023 19:34:58 +0000

TLDR
Neste artigo, eu mostro meu processo para instalação e configuração do meu ambiente de desenvolvimento web logo após uma instalação limpa do Ubuntu 22.04.

Sumário

Introdução
Começando
Configurando o Git
Visual Studio Code
PHPStorm
Instalando a pilha LAMP (Apache, MySQL e PHP)
- Apache
- PHP
- MySQL
Docker
NodeJS
Bônus: Hyper Terminal e Oh-My-Zsh
- Hyper
- Oh My Zsh
Conclusão

Introdução

Finalmente tomei coragem e instalei o Ubuntu 22.04 na minha máquina. O problema em si não é formatar o PC, mas sim ter que configurar todo o ambiente depois da instalação limpa, principalmente para quem programa.

Dessa forma, decidi criar este artigo como uma espécie de roteiro com todas as aplicações e/ou pacotes a serem instalados (e como instalá-los) para que, das próximas vezes, este processo tome o menor tempo possível. E, claro, se ajudar alguém que estiver lendo este artigo, ficarei muito feliz.

Começando

Primeiro de tudo, atualize o gerenciador de pacotes e instale aqueles mais básicos:

sudo apt update

sudo apt-get install curl unzip git

Crie também uma pasta Apps/ na sua pasta pessoal. Nela, iremos guardar todos os arquivos do tipo AppImage:

$ ~/mkdir Apps

Configurando o Git

A configuração inicial e mais básica do Git é dada pelo seu nome e email:

$ git config --global user.name "Meu Nome"

$ git config --global user.email "meu@email.com"

Visual Studio Code

Vá até a página de download do VSCode e escolha a opção .deb. Após a finalização do download, entre no terminal, navegue até a pasta em que o arquivo se encontra e o instale com o seguinte comando:

$ sudo dpkg -i nome_do_arquivo.deb

PHPStorm

Vá até a página de download do PHPStorm e baixe o arquivo.

O processo de instalação do PHPStorm é um pouco diferente, mas nós criamos a pasta Apps/ exatamente para este momento. Execute a seguinte sequência de comandos (em seguida eu explico o que cada um deles faz):

#1
$ mv PhpStorm-2022.3.2.tar.gz ~/Apps

#2
$ sudo tar -zxf PhpStorm-2022.3.2.tar.gz

#3
$ rm PhpStorm-2022.3.2.tar.gz

#4
$ ./PhpStorm-2022.3.2/bin/phpstorm.sh

Move o arquivo compactado para dentro de Apps/;
Extrai a pasta do PHPStorm de dentro do arquivo compactado;
Remove o arquivo compactado. Não precisaremos dele mais;
Executa o script que inicia o programa.

Neste momento, você provavelmente está com o PHPStorm aberto. Para que não seja necessário ir até a pasta raíz toda vez que você for iniciar a IDE, temos duas opções:

Na barra de ferramentas vá até Tools > Create Command-line Launcher. O programa indicar o caminho em que o script será criado. Você pode definir o nome que você quiser em vez do nome sugerido pela IDE, por exemplo /usr/local/bin/phpstorm em vez de /usr/local/bin/pstorm, como sugerido;
Ou então, ir até Tools > Create Desktop Entry. Dessa forma, o PHPStorm ficará disponível no menu de aplicativos do Ubuntu, e então você poderá fixá-lo na Dock.

Instalando a pilha LAMP (Apache, MySQL e PHP)

Apache

O próximo passo é instalar o servidor web Apache para que possamos desenvolver as aplicações em PHP. Muito simples:

$ sudo apt-get install apache2

Quando a instalação tiver finalizado, acesse o endereço localhost no navegado. Se você vir essa página, é porque deu tudo certo:

Caso ainda não tenha dado certo, pode ser que o serviço do Apache não tenha sido inicializado. Neste caso, execute o seguinte comando e verifique o navegador novamente:

$ sudo service apache2 start

PHP

Para instalar o PHP, o pacote php-cli já basta. Porém, para desenvolvermos aplicações, precisaremos de alguns pacotes adicionais:

$ sudo apt-get install php-cli php-xdebug php-curl php-mbstring php-json php-mysql

MySQL

A instalação do MySQL é mais simples, basta um único pacote:

$ sudo apt-get install mysql-server

Para mais detalhes sobre a configuração do MySQL, recomendo este tutorial da Digital Ocean. Ele está bem completo em relação à parte de criação de usuário e segurança da instalação.

Docker

Essa instalação compreende tanto o Docker Engine, quanto o Docker Compose. Adicione a chave GPG do repositório:

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Adicione o repositório do Docker:

$ echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Atualize o gerenciador de pacotes e instale os pacotes do Docker:

sudo apt update

sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin

Após isso, é necessário que você adicione seu usuário ao grupo do Docker para não precisar utilizar o sudo sempre que for executar algum comando Docker:

sudo usermod -aG docker $USER

newgrp docker

NodeJS

Para instalar o NodeJS completo, precisamos, primeiramente, do nvm (Node Version Manager):

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.3/install.sh | bash

Em seguida, instale a última versão LTS do NodeJS:

nvm install --stable

Bônus: Hyper Terminal e Oh-My-Zsh

Tendo concluído os passos anteriores, a configuração do nosso ambiente de desenvolvimento, no geral, está pronta. Este passo é opcional, visto que não é essencial para o desenvolvimento, mas pode nos trazer algumas funcionalidades novas e, claro, uma aparência mais agradável ao terminal.

Hyper

Para baixar o Hyper, acesse este link. Assim como fizemos com o PHPStorm, mova o arquivo AppImage para ~/Apps. No meu caso, alterei o atalho de teclado nas configurações para executar o arquivo do Hyper ao invés do terminal:

Oh-My-Zsh

O Oh My Zsh é um framework para o zsh, que por sua vez, é uma alternativa ao terminal bash padrão. Esse framework serve, basicamente, para gerenciar as configurações do zsh. Com isso, podemos instalar plugins e temas facilmente no terminal.

Primeiro, faça o download do zsh:

sudo apt-get install zsh

Depois, torne ele seu terminal padrão:

chsh -s $(which zsh)

Para as alterações surtirem efeito, encerre sua sessão e relogue no sistema. Após isso, a saída para o comando echo $SHELL deverá ser /usr/bin/zsh.

Finalmente, para instalar o Oh My Zsh, basta rodar o seguinte comando:

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Conclusão

Talvez este passo-a-passo tenha ficado um pouco grande, mas certamente levarei menos tempo para instalar tudo na próxima vez do que levei para escrever aqui! Espero que te ajude de alguma forma também e, se tiver alguma dúvida ou sugestão, não deixe de comentar. Ficarei feliz em responder!

Até a próxima!