O sobraldev é um portifólio de projetos automatizado, assim é possível gerenciar e deixar sempre atualizado a página sem ter a preocupação de alteração no código.
- Laravel: 10.10
- Composer: 2.5.8
- PHP: 8.1
- Livewire: 3.4
- Tinker: 2.8
- Bibliotecas: Bootstrap e Tailwind
- Windows: 11
- Tela principal, onde o usuário possuir informações da barra de navegação e as novidades que são anunciadas no carrossel de imagens
- Visão geral de projetos e tecnologias, onde o usuário pode conferrir as tecnologias que são geralmente utilizadas nos projetos, além da seção projetos que ao abrir um deles contém mais detalhes sobre atráves de uma modal:
- Detalhes do projeto, o usuário pode conhecer mais projeto selecionado por meio do acompanhamento de cada processo, asssim ele pode ver as tecnologias utilizada em cada etapa, como também ver ele em execução, abrir o seu repositório entre outras opções:
- Projetos cientificos, caso o usuário tenha interresse em conhecer mais sobre os projetos cientificos desenvolvidos por Marcos Sobral, temos está seção, onde contém os principais artigos e projetos desenvolvidos no momentos:
- Tela de login
- Tela de gerenciamento de Carrossel
- Tela de gerenciamento das Tecnologias
- Tela de gerenciamento de Projetos Cientificos
- Tela de gerenciamento de Projetos
- Tela de gerenciamento dos Processos do projeto
As instruções de instalação estão disponíveis para ambos sistemas: Windows e Linux
Clique para expandir!
Para a implantação e correto funcionamento do sistema, é necessário a instalação e configuração de alguns pré-requisitos, junto a esse processo serão adicionados passos marcados com "opcional", estes são voltados para serem seguidos pelo pessoal de desenvolvimento do sistema.
É necessário instalar o PHP 8 ou superior. A instalação do PHP se baseia nos seguintes passos, que também podem ser vistos nessa página externa.
- Acessar o site de download do PHP e baixar o arquivo compactado do PHP
- Descompactar o arquivo em qualquer lugar no armazenamento do computador como por exemplo:
C:\php\ - Renomear arquivo
php.ini-developmentparaphp.ini - Dentro do arquivo
php.ini, descomentar as seguintes linhas, ou seja, remover o ";" do início de cada linha:
;extension=fileinfo
;extension=pdo_mysql
- Configurar a variável de ambiente para adicionar o caminho para PHP Link
- Testar versão do PHP no terminal com o comando:
php -v
Passo recomendado para poder digitar localhost na URL do navegador e acessar o servidor local.
- Abrir o bloco de notas como administrador
- Abrir o arquivo
C:\Windows\System32\drivers\etc\hosts - Adicionar/Descomentar a seguinte linha
127.0.0.1 localhost
- Salvar o arquivo
https://getcomposer.org/download/
A instalação do VSCode é um passo recomendado para que toda a equipe de desenvolvimento utilize o mesmo editor de código-fonte
https://git-scm.com/download/win
Passo recomendado para desenvolvimento, pois possibilita a execução do comando git clone, git push, entre outros. Caso esse passo não seja executado, quando o documento executar um comando "git clone", se fara necessário manualmente baixar do github a versão compactada dos arquivos. Além disso, será necessário descompactar no local correto assim como informado nos passos seguintes.
https://docs.microsoft.com/en-us/windows/wsl/install
https://www.docker.com/get-started/
- Criar pasta para o projeto. Neste documento, será referenciado como
[projeto] - Executar o seguinte comando dentro da pasta
[projeto]\:
git clone https://github.com/Laradock/laradock.git
- Dentro de
[projeto]\laradock\, criar uma cópia de.env.examplenomeada.env - Configurar o arquivo
[projeto]\laradock\.envpara ter a seguinte linha
PHP_VERSION=8.1
- Clonar o repositório do sistema, executando dentro de
[projeto]\o seguinte comando:
git clone https://github.com/RsiIFTO/SantaMalas
- Dentro de
[projeto]\SantaMalas\, criar uma cópia de.env.examplenomeada.env - Abrir a pasta do
[projeto]\SantaMalas\, usando o terminal e executar os seguintes comandos:
composer install
php artisan key:generate
Nota : Se o docker tiver containers do laradock de uma instalação anterior, é necessário executar os seguintes comandos na pasta
[projeto]\laradock\, antes do passo seguinte:
docker-compose build php-fpm docker-compose build workspace docker-compose down"
- Abrir a pasta do
[projeto]\laradock\usando o terminal e executar o seguinte comando:
docker-compose up -d nginx mysql phpmyadmin redis workspace
- Dentro do arquivo
[projeto]\SantaMalas\.env, altere as seguintes linhas para os dados valores se estiverem diferentes, salve e mantenha o arquivo aberto:
DB_HOST=127.0.0.1
DB_PASSWORD=root
- Com o terminal na pasta
[projeto]\SantaMalas\, execute o seguinte comando:
php artisan migrate:fresh --seed
- Altere o arquivo
.envnovamente, altere a linha e salve:
DB_HOST=mysql
Clique para expandir!
Para a implantação e correto funcionamento do sistema, é necessário a instalação e configuração de alguns pré-requisitos, junto a esse processo serão adicionados passos marcados com "opcional", estes são voltados para serem seguidos pelo pessoal de desenvolvimento do sistema.
Abra um terminal e utilize o seguinte comando:
sudo apt install git -y
e insira a senha do usuário.
Dependente da versão a ser instalada e dos pacotes disponíveis para instalação, pose ser necessário alterar a versão inserida pelo comando, o comando a seguir é para a instalação do PHP 8.1 junto de algumas extensões necessárias:
sudo apt install php8.1 php8.1-common php8.1-curl php8.1-xml php8.1-mbstring php8.1-mysql php8.1-cli php8.1-opcache -y
- Testar versão do PHP no terminal com o comando:
php -v
AVISO: Não se pode utilizar comando sudo apt install composer, já que este instala uma versão desatualizada do mesmo e causará erros.
https://getcomposer.org/download/
```
sudo mv ./composer.phar /usr/local/bin composer
```
A instalação do VSCode é um passo recomendado para que toda a equipe de desenvolvimento utilize o mesmo editor de código-fonte
A instalação do Docker no Linux se divide em partes, sendo elas:
- Executar os seguintes comandos, substituindo "
[projeto]" pelo nome da pasta que será criada.
mkdir [projeto] && cd "$_"
git clone https://github.com/Laradock/laradock.git
cd laradock && cp .env.example .env
sed -i s/PHP_VERSION=7.4/PHP_VERSION=8.1/ .env
Esses comandos fazem o seguinte:
- cria uma pasta
- clonar Laradock
- configurar versão do php do laradock
Executar os seguintes comandos dentro de [projeto]:
sudo apt install php8.1-curl php8.1-dom php8.1-pdo-mysql unzip
git clone https://github.com/RsiIFTO/SantaMalas
cd SantaMalas && cp .env.example .env
composer install
php artisan key:generate
Nota : Se o docker tiver containers do laradock de uma instalação anterior, é necessário executar os seguintes comandos na pasta
[projeto]\laradock\, antes do passo seguinte:docker-compose build php-fpm docker-compose build workspace docker-compose down"
- Abrir a pasta do
[projeto]\laradock\usando o terminal e executar o seguinte comando:
docker-compose up -d nginx mysql phpmyadmin redis workspace
DB_HOST=mysql
Com o docker funcionando, pode-se executar dentro de [projeto]\laradock\:
docker-compose up -d nginx mysql phpmyadmin redis workspace
dentro de [projeto]\laradock\:
docker-compose restart
dentro de [projeto]\laradock\:
docker-compose stop
Inicia-se a instalação do projeto por meio da clonagem do projeto existente com o uso de git:
git clone <repositorio>
e mudando o diretório de trabalho para a pasta do projeto baixado com:
cd <nome-do-projeto>
Executar os seguintes comandos dentro de [projeto] caso estiver no Linux, se tiver no windows bastar apenas fazer uma cópia do arquivo [env.example] e renomear para [env]:
cd projeto && cp .env.example .env
Em seguinte é criada a pasta vendor dentro do projeto utilizado o comando:
composer install
Podem ocorrer um tipo de erro nessa parte que é a falta de algum módilo de PHP no sistema. esse tipo de erro irá mostrar diversas linhas de erro porém no início irá também falar qual(ais) extensão(ões) falta(m) com algo como "ext-< extensao >" e para resolver o erro, é utilizado o seguinte comando:
sudo apt install php8.1-<extensao>
Por exemplo, se no erro estiver "ext-curl", comando de instalar será "sudo apt install php8.1-curl"
php artisan key:generate
Clique para expandir!
- Dentro do arquivo
[projeto]\malas\.env, altere as seguintes linhas para os dados valores:
DB_HOST=127.0.0.1
DB_PASSWORD=root
- Com o terminal na pasta
[projeto]\malas\, execute o seguinte comando:
php artisan migrate
- Altere o arquivo
.envnovamente, altere a linha e salve:
DB_HOST=mysql
Clique para expandir!
- Primeiro passo é está Dentro do arquivo
[projeto]\malas\.env, altere as seguintes os dados valores:
APP_URL=http://localhost.<nomedoprojeto>
- Segundo passo é abrir a pasta
[projeto]\laradock\ngnix\sites\defaut.confe altere a linha que contém :root /var/www/public;, assim informe o diretório do seu projeto1 e a pasta public :
server_name localhost;
root /var/www/public/malas/desenvolvimento/public;
- Terceiro passo ainda dentro da pasta
[projeto]\laradock\ngnix\sites\app.conf.examplefazer uma cópia do arquivo e altere o nome do arquivo para<nome do segundo projeto>.conf, dentro desse arquivo altere a linha que contém :root /var/www/public;, assim informe o diretório do seu projeto1 e a pasta public:
server_name localhost;
root /var/www/public/malas/teste/public;
- ultimo passo, abra o seguinte arquivo
C:\Windows\System32\drivers\etc\hosts.adicione abaixo da linha descomentada127.0.0.1 localhost:
127.0.0.1 localhost.<nomedoprojeto>
Clique para expandir!
Cheque se o serviço do apache2 está rodando no computador e se positivo, utilize os seguintes comandos para parar e desabilitar o apache2 de iniciar no sistema:
sudo systemctl stop apache2
sudo systemctl disable apache2
Teste novamente a inicialização do laravel.
Caso apareça um erro relacionado ao sail, será necessário executar o comando:
php artisan sail:install
e inserir os numeros separados por vírgula dos servições que vai querer instalar, a instalação padrão é 1,3,5,7,8
Após instalação, volte ao teste de inicialização do laravel.
Erro de permissão " There is no existing directory at "/storage/logs" and it could not be created: Permission denied "
Caso apareça esse erro, basta executar os seguintes comandos:
php artisan route:clear
php artisan config:clear
php artisan cache:clear
ou
dentro da pasta do projeto utilizando o gerenciador de arquivos do linux, selecionar a pasta storage e aperte o botão direito do mouse e clique em propriedades, após clique em permissões e vá na ultima opção que é Alterar permissões dos arquivos contidos na pasta. Dessa forma altere as opções apenas leitura e acessar arquivo para leitura e escrita e criar e excluir arquivo, por fim clique em mudar.
Caso apareça este seguinte erro:
git pull --tags origin main
remote: HTTP Basic: Access denied. The provided password or token is incorrect or your account has 2FA enabled and you must use a personal access token instead of a password. See https://gitlab.com/help/topics/git/troubleshooting_git#error-on-git-fetch-http-basic-access-denied
fatal: Authentication failed for 'https://gitlab.com/George-Trindade/desenvolvimento.git/'
esse erro é comum de acontecer quando estiver fazendo git push ou git pull pela primeira vez no projeto, para sua resolução é necessário que o usuário faça uma autenticação global onde é utilizada esses comandos:
git config --global user.name <seu nome de usuário no gitlab ou hub>
git config --global user.email <informa seu email do gitlab/hub>
ou exemplo mais real
git config --global user.name joao-lima
git config --global user.email joaolima@gmail.com
PHP Warning: require(C:\src\laravel\public\desenvolvimento/vendor/autoload.php): Failed to open stream: No such file or directory in C:\src\laravel\public\desenvolvimento\artisan on line 18
Resolução:
composer update --no-scripts
Resolução: Alterar DB_HOST=127.0.0.1 para DB_HOST=mysql
DB_HOST=mysql
E-mail: marcossobraldev@gmail.com