Как создать и развернуть приложение на Laravel: быстрый и простой деплой с Apps

Сегодня мы рассмотрим кейс, как быстро развернуть приложения на Laravel в экосистеме Timeweb Cloud Apps. Laravel — это современный PHP-фреймворк, который значительно упрощает создание веб-приложений, предоставляя встроенные инструменты для работы с HTML-шаблонами, маршрутизацией и взаимодействием с базами данных. 

Архитектура Laravel улучшает производительность и SEO, поскольку поисковые системы могут легко индексировать страницы, а пользователи моментально получают доступ к необходимой информации за счет серверного рендеринга страниц (не нагружая клиент большим количеством JS-кода).

Рассматривать деплой приложения на Laravel мы будем на примере сайта-визитки из трех страниц, редактируемыми новостями и микро-админкой. 

Вам потребуется около 5-7 минут для деплоя подготовленного demo-сайта и еще 10 минут — для рассмотрения деталей кода. В результате вы получите:

• Готовый сайт (с простым визуальным оформлением) + публичный URL с SSL сертификатом.
• Научитесь быстро подключать авторизацию пользователей.
• Научитесь делать запросы к БД.
• Узнаете варианты использования Laravel для различных полезных бытовых кейсов, а также узнаете, какую пользу представляет данный фреймворк для IT-специалистов.

Вот так будет выглядеть ваше приложение:

Для упрощения данного гайда мы не делали сложный дизайн, чтобы вы могли легко применить свои шаблоны, одновременно имея уже настроенный рабочий сайт.

Что нам потребуется

• Зарегистрированный аккаунт на Github, Gitlab или Bitbucket.
• Зарегистрированный аккаунт на платформе Timeweb Cloud.
• Знание фреймворка Laravel (подразумевается, что вы хотя бы бегло знакомы с основами фреймворка и PHP).

Кейсы: кому будет полезна данная инструкция

1. Web-дизайнерам одностраничных и многостраничных сайтов, которым важны SEO-оптимизация и скорость.
2. Разработчикам корпоративных систем для быстрой разработки админок и внутренних корпоративных систем. Laravel обеспечит безопасность, так как все секреты и бизнес-логика скрыты на backend и не доступны хакерам извне.
3. Разработчикам API-систем для быстрой разработки действующих прототипов с системой доступов по ключу или паролю, а также с системой самообновляющихся токенов.
4. Разработчикам систем, требующим большого кол-ва однотипных endpoint для горизонтального скалирования проектов.
5. Разработчикам ботов на основе Laravel, поскольку многие обладают очень удобными админками.
6. Всем, кто использует в проектах webhook и различные комбинации баз данных.
7. Студентам и школьникам для обучения работы с ORM, так как Laravel стал практически классиком и популяризатором такого подхода к работе с таблицами.

Деплой приложения на Laravel

Мы подготовили для вас приложение (сайт-визитку с админкой новостей) для демонстрации простоты деплоя Laravel-приложений на нашем сервисе Timeweb Cloud Apps. Итак, приступим.

Шаг 1: Копирование шаблона

• Откройте в браузере страницу репозитория с шаблоном подготовленного демо-приложения и нажмите кнопку «Fork», чтобы скопировать его в свой аккаунт Github.

Сохраните репозиторий, название репозитория можете оставить таким же.

Шаг 2: Деплой приложения на Timeweb apps

Поскольку вы уже зарегистрированы в Timeweb Cloud, перейдите в панели в раздел Apps → Создать и выберите тип приложения «Laravel 8.3».

Теперь вам нужно подключить свой GitHub аккаунт, чтобы платформа могла отслеживать изменения в проекте и автоматически запускать деплой. Дополнительные настройки не требуются — просто нажмите кнопку «Подключить аккаунт» и выберите ваш репозиторий в Github.

Во время подключения вам будет предложено окно авторизации GitHub. Введите свой код авторизации и нажмите кнопку «Подтвердить».

Далее укажите репозиторий, к которому вы подключаете систему Timeweb Cloud Apps:

Также убедитесь, что переключатель установлен на «Сборка по последнему коммиту».

Вы успешно выполнили два необходимых шага. Далее прокрутите страницу вниз и установите два параметра:

1. Добавьте команду сборки, которая запускает Seeder (добавление первоначальных данных в таблицы):

php artisan db:seed --force

2. Установите название вашего приложения, например «Демо-сайт на Laravel8».

Теперь нажмите кнопку «Запустить деплой» и наблюдайте за процессом.

Платформа Timeweb Cloud Apps на ваших глазах соберет приложение, покажет вам весь процесс компиляции приложения и деплоя на сервер. Первая сборка займет около 5-7 минут, дальнейшие обновления занимают менее 20 секунд.

В процессе деплоя сервер разворачивает все зависимости и запускает миграции БД, однако в нашем демо-приложении миграции не включены, мы просто положили в репозиторий готовую базу sqlite3, чтобы демо сайт сразу выглядел заполненным.

Ну что же, поздравляем! Спустя несколько минут ваше приложение на Laravel успешно развернуто на сервисе Timeweb Cloud Apps, и теперь вы можете использовать его без необходимости настройки хостинга. 

Важное замечание

В своих проектах, которые вы в будущем будете выкладывать на сервис Timeweb Cloud Apps, обязательно добавляйте следующий код в файл app/Providers/AppServiceProvider.php:

public function boot()
{
  URL::forceScheme('https');
}

Это связано с тем, что при деплое платформа автоматически переводит проект на HTTPS-домен и генерирует ключи SSL. Если вы не добавите данный код в свой проект, страницы с вызовами AJAX-запросов будут работать некорректно, так как будут обращаться к HTTP-путям, и Laravel будет думать, что таких путей не существует (например, при submit форм ввода).

Как устроено приложение на Laravel

Внешний вид и функционал

Визуально ваше приложение состоит из трех блоков:

• сайт визитка: front, который видят посетители и поисковые системы
• админка для добавления новостей
• авторизация для админки

Вот так выглядит шаблон сайта:

Так выглядит простая админка добавления новостей (она находится по адресу https://ваш_url/admin/news/create):

Добавление пользователя (администратора)

Наш демо-проект соблюдает безопасность, и страницы админки открываются только авторизованным пользователям со статусом is_admin=1. Своего пользователя вы можете создать следующим образом.

Откройте файл database/seeders/AdminUserSeeder.php и внесите собственные логин и пароль в методе run.

public function run()
{
	DB::table('users')->insert([
    	'name' => 'Admin 2',
    	'email' => 'admin2@example.com',
    	'password' => Hash::make('ваш_пароль'),
       'is_admin' => 1,
	]);
}

Далее в терминале запустите команду

php artisan db:seed --class=AdminUserSeeder

Теперь у вас есть новый администратор, и вы можете запушить изменения на сервер (см. инструкцию выше). В данном случае, для создания коммита у вас должны измениться два файла: AdminUserSeeder.php и database/database.sqlite.

После сохранения изменений в GitHub можете смело идти редактировать новости на свой публичный сайт.

Запуск приложения на локальном компьютере

Для локального запуска приложения и дальнейшей разработки (доработки) наберите в командной строке следующую команду: php artisan serve и откройте в браузере адрес http://127.0.01:8000/.

Исходники приложения

Структура файлов

Откройте редактор или IDE (например, VS Code или Zed) и загрузите ваш проект. Структура каталогов вашего приложения выглядит следующим образом:

Основной каталог, содержащий логику приложения, — это App. Назначение остальных каталогов, которые нас интересуют: 

• /app — каталог, который содержит контроллеры (бизнес-логику приложения), а также модели используемых таблиц (в нашем случае это Users и News).
• /resources — содержит стили, JS-файлы и, собственно, сами шаблоны страниц Laravel в формате Blade (это основной каталог, где вы можете редактировать визуальное представление страниц).
• /routes/web.php — здесь прописаны пути к страницам админки и сайта, а также правила авторизации (например, страницы сайта отдаются всем, а админка только авторизованным пользователям).

Контроллеры

Далее, давайте рассмотрим директорию /app/Http/Controllers и разберем логику работы контроллеров. Для начала откройте файл SiteController.php.

Как видно из кода, он содержит методы рендеринга страниц согласно URL: /, /about и /contact, при этом главная страница открывается с передачей в нее массива новостей из таблицы News (последние пять записей с обратной сортировкой по дате). Здесь нет ничего особенного — стандартный рендеринг страниц с передачей массивов данных для шаблонов Blade. По аналогии, вы можете добавить обработку других URL из вашего проекта, загрузить для них данные и запустить рендер шаблонов.

Далее рассмотрим файл NewsController.php, который содержит логику добавления новых новостей для сайта:

Метод create просто рендерит форму для ввода новостей, а вот метод store, который вызывается при submit новой новости, сначала делает проверку, затем вызывает метод из модели News:create, который и сохраняет вашу новую запись с новостью в таблицу News, а затем выводит очищенную форму с диалогом Success.

Модель таблицы News

В Laravel модели используются для представления таблиц базы данных и взаимодействия с ними. Примером такой модели является класс News, который связывается с таблицей, содержащей новости:

class News extends Model {
	use HasFactory;

	protected $fillable = [
    	'title',  	 
    	'content',	 
    	'created_at',  
    	'updated_at',
	];
}

Описание кода

Класс News расширяет базовый класс Model, предоставляемый Laravel, чтобы получить доступ к функциональности ORM. Это позволяет легко работать с записями в базе данных, выполняя операции создания, чтения, обновления и удаления.

Массив $fillable определяет, какие поля можно массово назначать. В данном случае, это title, content, created_at и updated_at. Этот массив защищает от массового заполнения нежелательных полей, гарантируя, что только перечисленные атрибуты будут сохраняться в базу данных. 

Для тренировки вы можете убрать из кода created_at и updated_at и попробовать обновить эти поля. Вы не сможете это сделать.

Модель таблицы Users

Модель User в Laravel представляет собой класс, связанный с таблицей пользователей в базе данных, и используется для управления процессом аутентификации и авторизации.

Описание кода

Класс User находится в пространстве имен App\Models и использует несколько встроенных классов Laravel:

Авторизация 

Контроллер App\Http\Controllers\Auth\AdminAuthController.php предназначен для управления процессом аутентификации администраторов, включая отображение формы входа, обработку логина и выход из системы.

Тело функции:

class AdminAuthController extends Controller
{
  public function showLoginForm()
  {
	return view('auth.admin_login');
  }

  public function login(Request $request)
  {
	// Проверка учетных данных с использованием базы данных
	$credentials = $request->only('email', 'password');

	if (Auth::attempt($credentials)) {
  	// Проверяем, является ли пользователь администратором
  	$user = Auth::user();
  	if ($user->is_admin) {
    	session(['is_admin' => true]); // Сохраняем информацию о том, что пользователь админ
    	return redirect()->route('admin.news.create')->with('success', 'Вы успешно вошли в админку!');
  	} else {
    	Auth::logout();
    	return redirect()->back()->withErrors(['email' => 'У вас нет прав администратора.']);
  	}
	}
	return redirect()->back()->withErrors(['email' => 'Неверные учетные данные.']);
  }

	public function logout()
	{
  	session()->forget('is_admin'); // Удаляем сессию
  	return redirect('/')->with('success', 'Вы вышли из админки!');
	}
}

Описание кода

Шаблоны страниц

HTML (Blade)  шаблоны наших страниц находятся в папке resources/views/site. Здесь мы не будем размещать весь громоздкий код HTML, вы можете сами зайти и посмотреть в своем редакторе.

Логика шаблонов проста: мы делаем HTML-структуру, где вставляем данные в нужные места. Например, на главной страницы новости рендерятся следующим образом (файл resources/views/site/index.blade.php):

<div class="row">
  <div class="col-md-12">
	<h2 class="text-center">Новости</h2>

	@foreach($news as $item)
  	<div class="card mb-3">
    	<div class="card-body">
      	<h5 class="card-title">{{ $item->title }}</h5>
      	<p class="card-text">{{ Str::limit($item->content, 100) }}</p>
      	<span class="text-muted news-date">{{ $item->created_at->format('d.m.Y') }}</span>
    	</div>
  	</div>
	@endforeach

	@if($news->isEmpty())
  	<p class="text-center">Нет новостей для отображения.</p>
	@endif
  </div>
</div>

Из кода видно, что для рендера новостей мы запускаем цикл @foreach($news as $item, который берет данные из переменной-массива $news, полученной из контроллера, и вставляет поля в HTML-шаблон: <h5 class="card-title">{{ $item->title }}</h5>. Это достаточно стандартная логика Laravel, поэтому здесь мы не будем подробно описывать все ее механизмы.

Остальные шаблоны страниц устроены аналогично: получаем переменные из контроллера и рендерим их значения в нужных HTML-блоках.

Заключение

В этой статье мы рассмотрели, как создать простое приложение на Laravel и развернуть (задеплоить) его в публичном доступе, не прибегая к использованию собственных серверов и без необходимости покупки сложного хостинга.

Для новичков важно отметить, что Laravel — это современный фреймворк для PHP, который существенно упрощает создание веб-приложений, делая этот процесс быстрее и удобнее, а самое главное безопаснее. Он способствует высокой производительности приложений, улучшает видимость в поисковых системах. Его не сложно освоить, особенно если у вас уже есть базовые знания в веб-разработке на PHP, и он подходит как для начинающих разработчиков, так и для профессионалов, поскольку имеет огромное комьюнити и хорошую документацию.

Мы, в свою очередь, помогаем вам упростить развертывание вашего кода в интернете: здесь вы сможете получить безопасные публичные ссылки на проекты, бесплатные SSL-сертификаты и многое другое. Для быстрого старта мы рекомендуем воспользоваться Timeweb Cloud Apps — это идеальная платформа для запуска приложений.