Instalar Laravel no alojamento partilhado LWS em poucos passos simples

Procédure

O que é o Laravel?

Laravel é uma estrutura web de código aberto escrita em PHP que lhe permite desenvolver aplicações web de forma rápida, eficiente e estruturada. Foi criada por Taylor Otwell em 2011 e, desde então, tornou-se uma das estruturas PHP mais populares e amplamente utilizadas.

Laravel é baseado no modelo MVC (Model-View-Controller), que separa a lógica de apresentação da aplicação. Inclui muitas funcionalidades úteis, como a autenticação, a gestão de sessões, o encaminhamento, a migração de bases de dados e muito mais. Tem também uma sintaxe elegante e expressiva, que permite aos programadores codificar mais rapidamente e de forma mais agradável.

O Laravel tem também uma grande comunidade de programadores que contribuem regularmente para o seu desenvolvimento, garantindo uma documentação completa e actualizada, bem como inúmeros recursos e ferramentas disponíveis online para ajudar os programadores a resolver problemas ou a encontrar respostas às suas perguntas.

A quem se destina o Laravel?

O Laravel destina-se a qualquer pessoa ou empresa que pretenda desenvolver aplicações Web em PHP de forma rápida, eficiente e estruturada. Isto pode incluir programadores principiantes ou experientes, pequenas ou grandes empresas, start-ups, freelancers ou agências de desenvolvimento.

Devido à sua sintaxe clara e expressiva, à sua grande comunidade de programadores activos e às suas muitas funcionalidades incorporadas, o Laravel é uma escolha popular para o desenvolvimento de aplicações Web de todas as dimensões e complexidades. É também uma escolha comum para a criação de projectos baseados na nuvem ou na Internet das Coisas, bem como para o desenvolvimento de aplicações móveis através de APIs.

Em suma, Laravel é para qualquer pessoa ou empresa que queira desenvolver aplicações web PHP modernas, escaláveis e de fácil manutenção de uma forma eficiente e estruturada. No entanto, recomenda-se um conhecimento mínimo de Objectos PHP e da utilização de Frameworks para se sentir confortável a desenvolver com Laravel.

Como posso instalar facilmente o Laravel no meu alojamento Linux LWS Panel?

A instalação do Laravel no seu alojamento é muito fácil através do Autoinstalador LWS.

Para o fazer, siga este procedimento:

1. Entre na sua área de cliente do LWS Panel.

2. Está agora na página que lista os seus alojamentos e domínios.

3. Aceda à gestão do seu alojamento através do botão Gerir

4. Na categoria Software, clique no botão Auto-installer

5. Na listagem na parte inferior da página, em Available Frameworks, clique em Laravel.

6. Seleccione onde pretende instalar o seu site Laravel e clique em OK.

7. O Laravel está agora instalado no seu alojamento.

Como configuro o meu site Laravel?

Agora que o seu site Laravel foi instalado, vamos ver alguns dos elementos que podem ser configurados.

1. Criar um .htaccess

A primeira coisa a configurar é o ficheiro .htaccess na raiz do seu site. O coração do Laravel está localizado na pasta /public, pelo que terá de redirecionar o seu site para esta pasta.

Para isso, volte a gerir o seu serviço no painel do cliente LWS, vá para a categoria Ficheiros e clique no botão Gestor de ficheiros.

Em seguida, clique na ligação + ficheiro no topo da página e, no modal, introduza .htaccess como nome e confirme.

Procure o ficheiro que acabou de criar e clique nele para aceder ao editor de ficheiros. Copie e cole o conteúdo abaixo neste ficheiro e, em seguida, clique em Guardar:

/*RewriteEngine On RewriteRule ^(.*)$ public/ [L]

2. Modificar as variáveis de ambiente

Nesta secção, vamos ver algumas configurações que não precisam necessariamente de ser alteradas, mas que dependerão das suas necessidades específicas. Ainda no gerenciador de arquivos, na raiz do seu site, você vai encontrar um arquivo chamado .env, que contém uma série de itens de configuração, como informações de conexão com o banco de dados. No caso de uma instalação do Laravel utilizando o nosso Auto-installer, a base de dados já estará configurada, pelo que não será necessário intervir a este nível.

Por outro lado, se quiser enviar e-mails a partir do seu site, pode configurá-lo através de um endereço de e-mail que tenha criado previamente no seu serviço, que é o que vamos ver. Parto do princípio de que sabe como criar um endereço de correio eletrónico no seu serviço, se não souber, pode sempre seguir esta documentação.

Então vamos abrir o ficheiro .env e configurar esta parte do código como mostrado abaixo:

/* Deixe SMTP */ MAIL_MAILER=smtp /* Introduza o servidor do seu endereço de correio, por exemplo para mim mail61.lwspanel.com */ MAIL_HOST=mail61.lwspanel.com /* A porta será sempre 465 */ MAIL_PORT=465 /* Introduza o seu endereço de correio eletrónico */ MAIL_USERNAME=contact@nomdedomaine.com /* Introduza a palavra-passe da sua caixa de correio */ MAIL_PASSWORD=gHUè-&Jk45 /* Certifique-se de que introduz ssl aqui */ MAIL_ENCRYPTION=ssl /* Corresponde ao endereço que será apresentado como remetente */ MAIL_FROM_ADDRESS="contact@nomdedomaine.com" /* Corresponde ao nome que aparecerá ao lado do endereço de correio eletrónico do remetente*/ /* Aqui ${APP_Name} será o nome que deu ao seu site anteriormente neste ficheiro */ /* Pode colocar outras coisas entre os "" se desejar */ MAIL_FROM_NAME="${APP_NAME}""".

Em seguida, guarde as suas alterações utilizando o botão no canto superior direito. Não recomendo fazer quaisquer outras alterações, uma vez que o resto já está bem configurado.

Entendendo a arquitetura do Laravel

Agora que o nosso site Laravel está corretamente configurado, vamos passar à fase de criação das nossas primeiras páginas. Antes de começarmos a codificar, é importante perceber como funciona uma framework, e o Laravel em particular, bem como a sua arquitetura. De uma forma simples, é essencial compreender a utilização de vistas, controladores, modelos e rotas. Isto permitir-lhe-á organizar melhor o seu código e separar as diferentes responsabilidades da sua aplicação.

A vista Num projeto Laravel, uma "vista" é uma representação visual dos dados que pretende apresentar ao utilizador. Por outras palavras, é a parte da sua aplicação web que é responsável por apresentar a informação. No Laravel, as visualizações são frequentemente escritas usando o mecanismo de modelo Blade. Com o Blade, é possível incluir variáveis PHP no HTML, usar loops e condições para gerar elementos repetitivos e até mesmo estender layouts básicos para reutilizá-los em várias páginas. No Laravel, as visualizações são colocadas na pasta resources/views e os ficheiros têm a extensão .blade.php.

O controlador Numa estrutura como o Laravel, um controlador é uma classe que actua como uma interface entre o utilizador e a aplicação. Quando um utilizador faz um pedido, o controlador obtém os dados necessários a partir do modelo, efectua o processamento necessário e envia a resposta adequada para a visualização. Por outras palavras, o controlador é um elemento-chave na arquitetura MVC (Model-View-Controller) de uma estrutura. Separa as preocupações da aplicação, dividindo as responsabilidades entre os diferentes componentes. O modelo gere os dados, a vista trata da apresentação e o controlador gere a lógica empresarial. Esta separação facilita a manutenção da aplicação, permitindo que sejam feitas alterações a um componente sem afetar os outros. O controlador melhora, portanto, a legibilidade, a flexibilidade e a modularidade do seu código. No Laravel, os controladores são colocados na pasta app/Http/Controllers.

O modelo: Num projeto Laravel, um "modelo" é uma classe que representa uma tabela na sua base de dados. É através dos modelos que pode interagir com a base de dados da sua aplicação. Para compreender o que é um modelo, tomemos o exemplo de uma aplicação de gestão de utilizadores. Se tiver uma tabela "utilizadores" na sua base de dados, pode criar um modelo "Utilizador" que represente esta tabela. Este modelo estaria associado à tabela 'users' e conteria métodos para aceder, criar, atualizar ou apagar utilizadores na base de dados. No Laravel, os modelos são colocados na pasta app/Models.

A rota: Num projeto Laravel, uma "rota" é uma forma de definir como a sua aplicação Web deve responder a um pedido de um utilizador para um URL específico. Por exemplo, se o visitante pedir o URL domainname.co.uk/, a rota interpretará isso e redireccionará o visitante para a página correcta, neste caso a página inicial. As rotas são configuradas no ficheiro routes/web.php.

Criando suas primeiras páginas no Laravel

Agora que já vimos a arquitetura do Laravel, podemos passar à configuração das nossas primeiras páginas.

Para o nosso exemplo, vamos criar uma página que exibe uma lista de utilizadores. Vamos assumir que tem uma tabela 'users' na sua base de dados, com três utilizadores fictícios para o nosso exemplo. Aqui estão os passos a seguir para configurar esta página:

1. Criar o modelo

Agora precisamos de criar um modelo para aceder aos dados da nossa base de dados e, em particular, à tabela "utilizadores". Isto pode ser feito facilmente utilizando o terminal Web do nosso serviço através do Painel de Cliente LWS. Para aceder ao terminal Web, vá à gestão do seu serviço e clique em "Terminal SSH" na secção "Software". Utilizando esta interface de linha de comando, pode criar rapidamente o seu modelo.

Escreva esta linha de comando :

php artisan make:model Utilizador -m

O seu ficheiro modelo para a tabela "utilizadores" foi criado com sucesso no seu site. Isto significa que pode agora aceder aos dados da tabela "users" utilizando este modelo no seu código Laravel.

2. Criando um controlador

Também precisamos criar o controlador que recuperará a lista de usuários em uma variável e, em seguida, redirecionará a solicitação para a visualização apropriada. Por uma questão de clareza, vamos chamar a este ficheiro "UserController.php", para indicar que este controlador é responsável pela gestão dos utilizadores. Este ficheiro deve ser criado na pasta app/Http/Controllers e terá o seguinte aspeto

/* Controlador: app/Http/Controllers/UserController.php */  $users ]); } }

3. Criando a view

Agora que o modelo e o controlador foram criados, podemos passar para a criação da view.

No nosso caso, como vamos trabalhar com utilizadores, vamos criar uma pasta 'user' no diretório da vista, na qual vamos criar a nossa primeira página, que será o índice. O caminho completo da vista será, portanto, "resources/views/user/listing.blade.php", e terá o seguinte conteúdo:

* Página : ressources/views/user/listing.blade.php */

/*Criação da lista usando as tags ul e li */

• /* Navegamos na lista de usuários contida na variável $users dada pelo controller */ @foreach($users as $user) /* Mostramos o nome do usuário indicando o nome da coluna correspondente na base de dados */
  • {{$user->name}}
  • @endforeach

4. Criar a rota

Agora que já criámos a vista, o controlador e o modelo, basta dizer ao Laravel que queremos mostrar a página de "listagem" dos utilizadores no URL "mondomaine.fr/user".

Para isso, precisamos de criar uma rota, que mapeia um determinado URL para um controlador e um método específicos. As rotas são definidas no ficheiro "web.php", localizado na pasta "routes".

/* Rotas : routes/web.php */ 

Concluímos todos os passos necessários para configurar uma página simples de lista de utilizadores que extrai dados da nossa base de dados. No entanto, este é apenas um exemplo muito simples do que o Laravel pode fazer em termos de criação de páginas. Existem muitos outros recursos e métodos que ainda não exploramos. Para saber mais sobre o Laravel, recomendamos a leitura da documentação oficial do Laravel.

Adicionar bibliotecas / pacotes ao Laravel

Para dar um passo adiante, vamos ver como adicionar bibliotecas ou pacotes ao Laravel. Embora o Laravel já ofereça várias ferramentas, pode ser útil adicionar funcionalidades adicionais usando pacotes para evitar o desenvolvimento de funcionalidades que já existem. Vamos usar o terminal SSH do nosso serviço no painel do cliente LWS novamente.

Vamos tomar a barra de debug como exemplo. Como utilizador de CakePHP, aprecio particularmente esta funcionalidade quando estou em modo de desenvolvimento. Como essa funcionalidade não está disponível como padrão no Laravel, eu gostaria de adicioná-la ao meu site. Depois de pesquisar na internet, descobri a ferramenta Laravel Debugbar no GitHub, que vou instalar. Para isso, basta seguir as instruções fornecidas na página da ferramenta e digitar o seguinte comando no Terminal Web:

composer require barryvdh/laravel-debugbar --dev

Vou então à minha Área de Cliente e faço a gestão do meu serviço.

Depois, na secção Software, vou ao Terminal SSH

Para iniciar a instalação, basta ir à pasta onde se encontra o site Laravel. Neste caso, o site está instalado na raiz, pelo que não é necessária qualquer ação especial. No entanto, se o site foi instalado em uma pasta chamada Laravel, o seguinte comando deveria ter sido usado para ir para a pasta correspondente:

cd Laravel

Tudo o que tem de fazer agora é introduzir o comando acima mencionado e executá-lo.

Depois disso, vários itens aparecerão no terminal. Não se preocupe, isso é perfeitamente normal. O Composer recupera os arquivos necessários para instalá-los no seu site e executar as ações necessárias, e essas linhas simplesmente representam todo o processo.

Quando a instalação estiver concluída, pode utilizar a ferramenta diretamente no seu site quando estiver no modo de desenvolvimento.