Как установить laravel 8 на windows

Обновлено: 06.07.2024

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

Введение

Laravel – это элегантный, выразительный и гибкий PHP-фреймворк с упором на чистый код и скорость. Он позиционирует себя как «PHP-фреймворк для веб-мастеров». Это бесплатный PHP-фреймворк с открытым исходным кодом, созданный Тейлором Отвелом на основе архитектурной модели Model View Controller (MVC).

Создание веб-приложения с нуля может быть сложной задачей, особенно если вы новичок. Простое веб-приложение содержит различные маленькие и большие компоненты, и вам, возможно, надоест создавать эти компоненты каждый раз, когда вы разрабатываете приложение. Это скучный и повторяющийся процесс, и нет никакого смысла изобретать велосипед. Вот тогда вам на помощь и приходит фреймворк Laravel.

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

Чтобы вам было легче изучить Laravel, я написал это руководство специально для неопытной аудитории. Так вам будет проще следовать этому руководству и изучать Laravel.

Что вы должны знать перед использованием этого руководства по Laravel?

HTML/CSS (Естественно).
Понимание базового PHP.
Владение PHP на среднем уровне – это не обязательно, но если у вас есть время, изучите некоторые рядовые вещи: ООП в PHP, абстракцию и т. д.
Базовое понимание фреймворка MVC.
Усидчивость – несмотря на то, что изучать Laravel довольно легко, спустя какое-то время вам всё же придется испытать собственное терпение. По крайней мере, у меня были некоторые проблемы из-за того, что я знал PHP, но совсем не разбирался в фреймворках. Когда я изучал фреймворк или успешно завершал проекты, я всё равно путался с базовыми вещами, которые лежат в основе фреймворка MVC. Но я не сдавался.
Увлечение – да ладно вам, ведь веб-разработка – это весело! По крайней мере, когда используешь Laravel. Лучше всего получать наслаждение от своего познавательного путешествия.

Установка и настройка

Требования для установки Laravel 8

Перед установкой Laravel на вашу локальную платформу (Localhost) вам необходимо установить следующие программы:

Веб-сервер – Apache или nginx
>= PHP 7.3
Некоторые расширения PHP, которые можно установить заранее:

BCMath
Ctype
Fileinfo
JSON
Mbstring
OpenSSL
PDO
Tokenizer
XML

MySQL (или другие системы управления базой данных, вы даже можете использовать SQLite).
Composer
IDE (интегрированная среда разработки) будет очень полезна для разработки на Laravel. Я рекомендую VS Code или Atom. И то, и другое можно использовать совершенно бесплатно.

Пошаговая установка Laravel на локальном хосте:

Шаги для пользователей Mac:

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

Перейти в нужную папку;
Выполнить команду laravel new projectname.

Шаги для пользователей Windows:

Скачайте Composer и установите его.
После успешного завершения установки необходимо проверить, установлен ли он глобально. Откройте командную строку и введите команду «Composer», как показано ниже.

Перейти в нужную папку;
Зажать клавишу Shift + щелкнуть правой кнопкой мыши и выбрать пункт «Открыть командную строку здесь»;
Выполнить команду laravel new projectname/

В нашем примере выполняем:

Руководство по созданию простого CRUD-приложения для составления списка дел на Laravel

Лучший способ изучить программирование – практиковаться. Поэтому здесь мы будем изучать основы Laravel, разрабатывая простое веб-приложение, которое будет выполнять перечисленные ниже функции. В рамках этого руководства по Laravel:

Вы сможете зарегистрироваться и войти в веб-приложение;
Вы cможете добавлять задачи в свой список дел;
Вы cможете редактировать или удалять эти задачи;
Ваш список виден только вам, поэтому он использует аутентификацию через электронную почту и пароль.

Изучение структуры папок

Модели (Models) представляют сущности в базе данных, помогают запрашивать базу данных и возвращать данные.
Представления (View) – это страницы, которые будут отображаться при доступе к приложению. Элементы представлений используются для пользовательского интерфейса приложения.
Контроллеры (Controllers) обрабатывают запросы пользователей, получают необходимые данные от моделей и передают их представлениям. Контроллеры действуют как посредники между компонентами модели и представления для обработки бизнес-логики, а также входящего запроса.

После того как вы установили Composer и создали свое первое веб-приложение на основе Laravel, вы могли заметить папку приложения с разными файлами и папками внутри. Я знаю, если вы новичок, у вас может возникнуть много вопросов о том, для чего нужны эти папки и т. д. и т. п.

Давайте разберём некоторые из них

Пошаговое создание вашего первого приложения на Laravel

Создайте ваш проект

Если вы не создали свой проект в разделе установки, создайте его сейчас, выполнив следующую команду:

Настройте базу данных

Для нашего приложения нам понадобится база данных, поэтому лучше всего создать её в первую очередь. Laravel поддерживает четыре СУБД:

В этом примере мы будем пользоваться SQLite, так как её проще настроить и использовать. И вам не придется ничего устанавливать – нужно будет всего лишь создать один пустой файл. Другие СУБД должны быть установлены в вашей системе, только потом их можно настраивать соответствующим образом. Laravel позволяет файлу config/database.php настраивать базу данных, но лучше не хранить в нем учетные данные. Вместо этого вы можете использовать файл .env , в котором можно хранить различные типы учетных и других данных.

В корневой папке Laravel по умолчанию находится файл .env .

В этом файле вы найдете код, похожий на следующий:

Замените все шесть строк, приведенные выше на одну строку, указанную ниже, то есть измените значение db_connection на sqlite и удалите остальные строки db, как здесь:

Теперь в папке базы данных создайте файл database.sqlite (это файл базы данных с расширением .sqlite)

Создайте аутентификацию

Laravel также предоставляет «скелет» для аутентификации. Это означает, что всё, связанное с аутентификацией: вход пользователя, регистрация, потеря пароля, двухфакторная аутентификация и т.д. будет создаваться заранее, если вам это необходимо. Это называется Laravel Jetstream .

Есть два способа добавить Jetstream в ваше новое Laravel-приложение. Если вы еще не создали проект, добавьте флажок

для новой команды Laravel:

Так как выше мы уже создали проект, вы можете установить его с помощью установочного пакета. Сначала установите пакет Jetstream , используя следующую команду:

Jetstream в Laravel поддерживает два стека

Liveware или Inerta. Поскольку мы хотим, чтобы этот проект был простым, давайте воспользуемся Livewire и установим Jetstream с помощью следующей команды:

Затем запустите «npm install && npm run dev» , чтобы создать свои объекты.

На данном этапе мы закончили с настройкой и можем приступать непосредственно к созданию приложения.

Миграции

Первый шаг в разработке любого приложения – это создание базы данных. Laravel предлагает отличный способ разработки таблиц и схемы базы данных, а также даёт возможность легко переносить их в разные системы, которые называются «Миграции».

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

Ничего страшного, если это объяснение показалось вам непонятным. Поверьте, скоро у вас всё получится. Просто читайте дальше.

Выполните следующую команду:

Вы найдёте только что созданную миграцию в папке /database/migrations.

Теперь давайте добавим еще два столбца в таблицу задач, отредактировав только что созданный файл миграции.

В новом столбце с именем «description» будет храниться описание задачи, а в столбце с именем «user_id» будет храниться идентификатор пользователя, создавшего задачу. Мы добавили «-> unsigned () -> index ()» после user_if, потому что это внешний ключ из таблицы пользователей.

Теперь мы закончили с созданием схемы базы данных. Чтобы использовать эту схему для создания таблиц в базе данных, выполните следующую команду. Команда migrate обновит изменения, внесенные в схему, в базе данных.

Модели -Eloquent

Eloquent – это ORM (система объектно-реляционного отображения) для Laravel, которая позволяет свободно применять active-record для работы с базой данных. Каждая таблица базы данных может иметь соответствующую модель Eloquent. Модель Eloquent представляет объекты базы данных. Она может использоваться для запроса данных, а также для вставки и обновления данных в таблице. Итак, давайте с помощью команды make: model создадим модель для нашей таблицы задач.

Эта команда создаст модель задачи в папке приложения, как показано ниже.

Отношение «один-ко-многим»

Отношения используются для соединения таблиц. Eloquent даёт возможность связать свои модели через отношения Eloquent. Отношение «один ко многим» означает, что одна модель владеет несколькими объемами другой модели. В нашем примере: у одного пользователя может быть много задач, поэтому между таблицей пользователей и таблицей задач существует связь «один ко многим». Отношения Eloquent очень легко определить и использовать. И преимущество заключается в том, что вам вообще не нужно запускать запросы. Eloquent свяжет модели между собой, поэтому вам придется использовать только функции.

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

Модель задачи (файл task.php находится в app/task.php):

Модель пользователя (файл user.php находится в app/user.php):

Команда Tinker в Artisan (необязательно)

В Laravel существует интерфейс командной строки, известный как Artisan. Artisan содержит различные команды, и среди них – Tinker, которую мы собираемся обсудить. Tinker позволяет вам взаимодействовать со всем вашим Laravel- приложением через окно консоли без необходимости доступа к веб-интерфейсу. Основным преимуществом Tinker является то, что вы можете тестировать отношения, отлаживать данные и получать доступ к Eloquent ORM, задачам, тестам, событиям и т. д. Поэтому мы также будем использовать команду Tinker в нашем руководстве по Laravel. Допустим, вы зарегистрировались в приложении и создали две задачи. Теперь вы проверяете эти задачи прямо в окне консоли, как показано ниже:

Tinker напрямую обращается к базе данных, так что это отличный инструмент для тестирования функций, а также данных.

Контроллеры

Контроллеры используются для распределения трафика между представлениями и моделями. Они могут сгруппировать несколько логических схем обработки запросов в один класс. Таким образом, как правило, они получают весь запрос и, исходя из своей логики, перенаправляют или возвращают соответствующие данные. В нашем примере мы уже подходим к интерфейсу, поэтому мы должны создать контроллеры, через которые сможем обрабатывать запросы, поступающие в наше приложение. Выполните следующую команду, чтобы создать контроллер для задач:

Маршрутизация

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

Авторизоваться;
Зарегистрироваться;
Показать список всех наших задач;
Добавить новые задачи;
Удалить существующие задачи.

Laravel Jetstream добавляет вход и регистрацию, поэтому теперь нам нужно позаботиться только о трех маршрутах.

Laravel предоставляет различные файлы маршрутов внутри папки / routes для разных случаев использования. Например, настройка маршрутизации для API будет находиться в файле « /routes/api.php », а настройка маршрутизации для нашего веб-приложения будет находиться в «/routes/web.php».

Теперь давайте отредактируем файл web.php . Ниже вы увидите отредактированную версию этого файла. Внесите соответствующие изменения:

Здесь мы внесли два изменения:

Мы сгруппировали все маршруты, чтобы можно было применять auth: sanctum и проверенное промежуточное программное обеспечение ко всем маршрутам, тем самым давая доступ к этим страницам только проверенным пользователям, вошедшим в систему.
Мы изменили маршрут для панели управления, который теперь будет передавать запрос в функцию index в TaskController . Также мы создали маршруты для других действий.

Представления – шаблоны Blade

blade.php (панель управления покажет список задач);
blade.php (форма, которая позволит вам добавить новую задачу);
blade.php (форма, которая позволит вам отредактировать любую задачу).

Laravel включает в себя довольно удобный макет, который содержит панель навигации под названием app.blade.php , расположенную в папке Views / layouts . С помощью механизма Blade в Laravel вы cможете разделить свои страницы на подсекции, а также использовать раздел панели навигации по умолчанию в новых представлениях.

Теперь в папке / resources / views создайте файлы add.blade.php и edit.blade.php с разметкой, приведенной ниже.

В файле dashboard.blade.php также замените весь код на тот, который приведен выше. Представления мы отредактируем позже, после определения функций нашего контроллера с помощью привязки модели к маршруту.

Привязка модели к маршруту (Route-Model Binding)

В Laravel есть множество удивительных функций, которые делают веб-разработку простой, чистой и менее трудоемкой. Одна из наиболее заметных функций подобного рода – привязка модели к маршруту (Route-Model Binding). Это механизм для внедрения экземпляра модели в ваши маршруты. Это значит, вы можете передавать объект модели в маршруты, а также в представления по маршрутам. Эта функция поможет вам легко получить значения объекта в представлении. Ничего страшного, если это объяснение кажется непонятным. Со временем вы все поймёте.

Теперь давайте добавим в TasksController.php функции, обрабатывающие указанные выше маршруты. Они должны выглядеть так, как показано ниже:

Как вы можете видеть, я передаю в функцию объект «Task $ task», а также объект «Request $ request» с помощью механизма привязки модели маршрута.

Редактируем представления

Теперь функции контроллера настроены и возвращают соответствующие представления с прикрепленными объектами модели. Итак, теперь нужно отредактировать наши представления, чтобы они, если нужно, показывали форму и необходимые данные, используя объекты модели, переданные по маршрутам.

Откройте файл dashboard.blade.php и отредактируйте его следующим образом:

Механизм шаблонов Blade позволяет нам использовать PHP внутри HTML, не заключая его в «<? Php?>».

Откройте файл add.blade.php и отредактируйте его следующим образом:

Откройте файл edit.blade.php и отредактируйте его, как показано ниже:

После редактирования этого представления мы собираем все части воедино, так что теперь сможем протестировать своё приложение.

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

Запускаем проект на Localhost

Чтобы запустить проект, запустите в окне терминала команду php artisan serve. Убедитесь, что вы находитесь в корне вашего приложения в терминале.

Обязательно прочтите инструкции, прежде чем копировать код с github .

Что делать с этим проектом дальше:

Существует множество вещей, которые можно добавить в этот проект, например:

Проверка формы:
Разрешение пользователю создавать несколько списков с несколькими задачами;
Профиль пользователя;
И многое другое.

Заключение

Надеюсь, что это руководство по Laravel помогло вам понять основы Laravel, а также мотивировало вас учиться дальше. Пожалуйста, поделитесь своим мнением о Laravel и об этом руководстве. А также вы можете делиться в комментариях к этой статье вашими вопросами и проблемами. Будем рады вам помочь. Спасибо.

Пожалуйста, оставьте свои отзывы по текущей теме материала. За комментарии, подписки, дизлайки, отклики, лайки низкий вам поклон!

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

Laravel стремится обеспечить потрясающий опыт разработчика, предоставляя при этом мощный функционал: тщательное внедрение зависимостей, выразительный уровень абстракции базы данных, очереди и запланированные задачи, модульное и интеграционное тестирование и многое другое.

Независимо от того, новичок ли вы в PHP, веб-фреймворках или имеете многолетний опыт, Laravel – это фреймворк, который может расти вместе с вами. Мы поможем вам сделать первые шаги в качестве веб-разработчика или подскажем, как вы поднимите свой опыт на новый уровень. Нам не терпится увидеть, что вы построите.

Почему именно Laravel?

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

Прогрессивный фреймворк

Нам нравится называть Laravel «прогрессивным» фреймворком. Под этим мы подразумеваем, что Laravel растет вместе с вами. Если вы только делаете первые шаги в веб-разработке, обширная библиотека документации, руководств и видеоуроков Laravel поможет вам изучить основы, не перегружая себя.

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

Масштабируемый фреймворк

Laravel невероятно масштабируем. Благодаря удобному для масштабирования характеру PHP и встроенной поддержке быстрых распределенных систем кеширования, таких как Redis, горизонтальное масштабирование с Laravel очень просто. Фактически, приложения Laravel легко масштабируются для обработки сотен миллионов запросов в месяц.

Требуется экстремальное масштабирование? Такие платформы, как Laravel Vapor, позволяют запускать приложение Laravel в практически неограниченном масштабе с использованием новейшей бессерверной технологии AWS.

Фреймворк сообщества

Laravel объединяет лучшие пакеты в экосистеме PHP, чтобы предложить наиболее надежный и удобный для разработчиков фреймворк. Кроме того, тысячи талантливых разработчиков со всего мира внесли свой вклад в фреймворк. Кто знает, возможно, вы даже станете соучастником Laravel.

Ваш первый проект на Laravel

Мы хотим, чтобы начать работу с Laravel было как можно проще. Существует множество вариантов разработки и запуска проекта Laravel на вашем собственном компьютере. Хотя вы, возможно, захотите изучить эти варианты позже, но Laravel предлагает Sail – встроенное решение для запуска вашего проекта Laravel с помощью Docker.

Docker – это инструмент для запуска приложений и служб в небольших, легких «контейнерах», которые не мешают установленному на вашем локальном компьютере программному обеспечению или его конфигурации. Это означает, что вам не нужно беспокоиться о конфигурировании или настройке сложных инструментов разработки, таких как веб-серверы и базы данных на вашем персональном компьютере. Для начала вам нужно всего лишь установить Docker Desktop.

Laravel Sail – это легкий интерфейс командной строки для взаимодействия с конфигурацией Docker по умолчанию в Laravel. Sail обеспечивает отличную отправную точку для создания приложения Laravel с использованием PHP, MySQL и Redis без предварительного опыта работы с Docker.

Уже знаком с Docker? Не волнуйтесь! Все в Sail можно перенастроить с помощью файла docker-compose.yml , входящего в Laravel.

Начало работы в macOS

Если вы разрабатываете на Mac и Docker Desktop уже установлен, то вы можете использовать простую команду терминала для создания нового проекта Laravel. Например, чтобы создать новое приложение Laravel в каталоге с именем example-app , вы можете запустить следующую команду в своем терминале:

Конечно, вы можете изменить example-app в этом URL на что угодно. Каталог приложения Laravel будет создан в каталоге, из которого вы выполняете команду.

После создания проекта вы можете перейти в каталог приложения и запустить Laravel Sail. Laravel Sail предлагает простой интерфейс командной строки для взаимодействия с конфигурацией Docker по умолчанию в Laravel:

При первом запуске команды up Sail на вашем компьютере будут созданы контейнеры приложений Sail. Это может занять несколько минут. Не волнуйтесь, последующие попытки запустить Sail будут намного быстрее.

Чтобы продолжить изучение Laravel Sail, просмотрите его полную документацию.

Начало работы в Windows

Прежде чем мы создадим новое приложение Laravel на вашем компьютере с Windows, обязательно установите Docker Desktop. Затем вы должны убедиться, что подсистема Windows для Linux 2 (WSL2) установлена и включена. WSL позволяет запускать двоичные исполняемые файлы Linux прямо в Windows 10. Информацию о том, как установить и включить WSL2, можно найти в документации Среда разработки.

После установки и включения WSL2 вы должны убедиться, что Docker Desktop настроен на использование серверной части WSL2.

Теперь вы готовы создать свой первый проект Laravel. Запустите Терминал Windows и начните новый сеанс терминала для вашей операционной системы WSL2 Linux. Затем вы можете использовать простую команду терминала для создания нового проекта Laravel. Например, чтобы создать новое приложение Laravel в каталоге с именем example-app , вы можете запустить следующую команду в своем терминале:

Чтобы продолжить изучение Laravel Sail, просмотрите его полную документацию.

Разработка в подсистеме WSL2

Конечно, вам нужно будет иметь возможность изменять файлы приложения Laravel, которые были созданы в вашей установке WSL2. Для этого мы рекомендуем использовать редактор Microsoft Visual Studio Code и его собственное расширение Remote Development.

После установки этих инструментов вы можете открыть любой проект Laravel, выполнив из корневого каталога вашего приложения команду code . с помощью Терминала Windows.

Начало работы в Linux

Если вы разрабатываете в Linux и Docker Desktop уже установлен, то вы можете использовать простую команду терминала для создания нового проекта Laravel. Например, чтобы создать новое приложение Laravel в каталоге с именем example-app , вы можете запустить следующую команду в своем терминале:

Чтобы продолжить изучение Laravel Sail, просмотрите его полную документацию.

Выбор служб Sail

При создании нового приложения Laravel через Sail вы можете использовать строковую переменную запроса with , чтобы выбрать, какие службы должны быть настроены в файле docker-compose.yml вашего нового приложения. Доступны следующие службы mysql , pgsql , mariadb , redis , memcached , meilisearch , selenium и mailhog :

Если вы не укажете желаемые службы, то будет сконфигурирован стек по умолчанию из mysql , redis , meilisearch , mailhog и selenium .

Установка через Composer

Если на вашем компьютере уже установлены PHP и Composer, то вы можете создать новый проект Laravel напрямую с помощью Composer. После того, как приложение было создано, вы можете запустить локальный сервер разработки Laravel с помощью команды serve Artisan CLI:

Установщик Laravel

В качестве альтернативы, вы можете использовать установщик Laravel, включив его в глобальную зависимость Composer:

Чтобы исполняемый файл laravel мог быть обнаружен вашей системой, удостоверьтесь в правильном расположении каталога bin менеджера пакетов Composer, задаваемый системной переменной $PATH . Расположение каталога зависит от вашей операционной системы, но типичными могут быть:

Для удобства установщик Laravel также может создать репозиторий Git для вашего нового проекта. Чтобы указать, что вы хотите создать репозиторий Git, передайте флаг --git при создании нового проекта:

Эта команда инициализирует новый репозиторий Git для вашего проекта и автоматически зафиксирует базовый каркас Laravel. Флаг --git предполагает, что вы правильно установили и настроили Git. Можно также использовать параметр --branch , чтобы задать имя ответвления:

Вместо использования флага --git вы можете использовать параметр --github , чтобы создать репозиторий Git и, соответствующий ему, частный репозиторий на GitHub:

Можно использовать параметр --organization для создания репозитория под определенной организацией GitHub:

Начальная конфигурация

Все файлы конфигурации для фреймворка Laravel хранятся в каталоге config . Каждый параметр имеет комментарии, поэтому не стесняйтесь просматривать файлы и знакомиться с доступными вам вариантами.

Laravel практически не требует дополнительной настройки из коробки. Вы можете начать разработку! Однако вы можете просмотреть файл config/app.php и его комментарии. Он содержит несколько параметров, таких как часовой пояс и локаль, которые вы можете изменить в соответствии с вашим приложением.

Конфигурация на основе окружения

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

Ваш файл .env не должен быть привязан к системе контроля версий вашего приложения, поскольку каждому разработчику / серверу, использующему ваше приложение, может потребоваться другая конфигурация окружения. Более того, это будет угрозой безопасности в случае, если злоумышленник получит доступ к вашему репозиторию системы управления версиями, поскольку любые конфиденциальные учетные данные будут раскрыты.

Для получения дополнительной информации о конфигурации на основе файла .env и окружения ознакомьтесь с полной документацией по конфигурации.

Конфигурация каталога

Laravel всегда должен обслуживаться из корня «веб-каталога», настроенного для вашего веб-сервера. Вы не должны пытаться обслуживать приложение Laravel из поддиректории относительно «веб-каталога». Такая попытка может открыть доступ к конфиденциальным файлам, существующим в вашем приложении.

Следующие шаги

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

То, как вы хотите использовать Laravel, также будет определять следующие шаги на вашем пути. Существует множество способов использования Laravel, и мы рассмотрим два основных варианта использования фреймворка ниже.

Laravel как клиент-серверный фреймворк

Laravel может служить клиент-серверным фреймворком. Под «клиент-серверным фреймворком» мы подразумеваем, что вы собираетесь использовать Laravel для маршрутизации запросов к вашему приложению и отрисовки интерфейса через шаблоны Blade или с использованием гибридной технологии одностраничного приложения, такой как Inertia.js. Это наиболее распространенный способ использования фреймворка Laravel.

Если вы планируете использовать Laravel именно таким образом, вы можете ознакомиться с нашей документацией по маршрутизации, представлениям или Eloquent ORM. Кроме того, вам может быть интересно узнать о таких пакетах сообщества, как Livewire и Inertia.js. Эти пакеты позволяют использовать Laravel в качестве фреймворка полного стека, при этом пользуясь многими преимуществами UI, предоставляемыми одностраничными JavaScript-приложениями.

Если вы используете Laravel в качестве фреймворка полного стека, мы также настоятельно рекомендуем вам научиться компилировать CSS и JavaScript вашего приложения с помощью Laravel Mix.

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

Laravel в качестве сервера API

Laravel также может служить серверной частью API для одностраничного JavaScript-приложения или мобильного приложения. Например, вы можете использовать Laravel в качестве серверной части API для своего Next.js приложения. В этом контексте вы можете использовать Laravel для обеспечения аутентификации и хранения / получения данных для вашего приложения, а также пользуясь преимуществами мощных служб Laravel, таких как очереди, электронная почта, уведомления и многое другое.

Если вы планируете использовать Laravel именно так, то вы можете ознакомиться с нашей документацией по маршрутизации, пакету Laravel Sanctum и Eloquent ORM.

Фреймворк Laravel имеет несколько системных требований. Всем этим требованиям удовлетворяет виртуальная машина Laravel Homestead, поэтому настоятельно рекомендуется использовать Homestead в качестве локальной среды разработки Laravel.

Однако, если вы не используете Homestead, вам необходимо убедиться, что ваш сервер соответствует следующим требованиям:

PHP >= 7.3
BCMath PHP Extension
Ctype PHP Extension
Fileinfo PHP Extension
JSON PHP Extension
Mbstring PHP Extension
OpenSSL PHP Extension
PDO PHP Extension
Tokenizer PHP Extension
XML PHP Extension

Установка Laravel

Laravel использует Composer для управления своими зависимостями. Итак, перед использованием Laravel убедитесь, что на вашем компьютере установлен Composer.

Через установщик Laravel

Сначала загрузите установщик Laravel с помощью Composer:

Обязательно поместите общесистемный каталог bin поставщика Composer в переменную $PATH , чтобы исполняемый файл laravel мог быть обнаружен вашей системой. Этот каталог существует в разных местах в зависимости от вашей операционной системы; однако некоторые общие местоположения включают:

Вы также можете найти глобальный путь установки composer'а, запустив composer global about и выполнив поиск с первой строки.

После установки команда laravel new создаст новую установку Laravel в указанном вами каталоге. Например, laravel new blog создаст каталог с именем blog , содержащий новую установку Laravel со всеми уже установленными зависимостями Laravel:

Want to create a Laravel project with login, registration, and more features already built for you? Check out Laravel Jetstream.

Через Composer Create-Project

В качестве альтернативы вы также можете установить Laravel, выполнив команду Composer create-project в своем терминале:

Локальный сервер разработки

Более надежные варианты локальной разработки доступны через Homestead и Valet.

Конфигурация

Публичный каталог

Файлы конфигурации

Все файлы конфигурации для фреймворка Laravel хранятся в каталоге config . Каждый параметр задокументирован, поэтому не стесняйтесь просматривать файлы и знакомиться с доступными вариантами использования.

Разрешения директорий

После установки Laravel вам может потребоваться настроить некоторые разрешения. Каталог storage и каталог bootstrap/cache должны быть доступны для записи вашим веб-сервером, иначе Laravel не запустится. Если вы используете виртуальную машину Homestead, эти разрешения уже должны быть уже установлены.

Ключ приложения

Следующее, что вам нужно сделать после установки Laravel, - это установить для ключа приложения случайную строку. Если вы установили Laravel через Composer или установщик Laravel, этот ключ уже был установлен для вас с помощью команды php artisan key:generate .

Обычно эта строка должна состоять из 32 символов. Ключ можно задать в конфигурационном файле .env . Если вы не скопировали файл .env.example в новый файл с именем .env , вам следует сделать это сейчас. Если ключ приложения не установлен, ваши пользовательские сеансы и другие зашифрованные данные не будут в безопасности!

Дополнительная конфигурация

Laravel почти не нуждается в другой конфигурации после установки из коробки. Вы можете начать разработку! Однако вы можете просмотреть файл config/app.php и его документацию. Он содержит несколько параметров, таких как часовой пояс ( timezone ) и языковой стандарт ( locale ), которые вы можете изменить в соответствии с вашим приложением.

Вы также можете настроить несколько дополнительных компонентов Laravel, например:

Конфигурация веб-сервера

Конфигурация каталога

Laravel всегда должен запускаться из корня «веб-каталога», настроенного для вашего веб-сервера. Вы не должны пытаться запускать приложение Laravel из подкаталога «веб-каталога». Попытка сделать это может открыть доступ к конфиденциальным файлам, присутствующим в вашем приложении.

Красивые URL (ЧПУ)

Apache

Laravel включает файл public/.htaccess , который используется для предоставления URL-адресов без обозначения файла index.php в пути. Перед запуском Laravel с Apache обязательно включите модуль mod_rewrite , чтобы файл .htaccess обрабатывался сервером.

Если файл .htaccess , поставляемый с Laravel, не работает с вашей установкой Apache, попробуйте следующий вариант:

Nginx

Если вы используете Nginx, следующая директива в конфигурации вашего сайта будет направлять все запросы на фронт-контроллер index.php :

При использовании Homestead или Valet, красивые URL-адреса (ЧПУ) будут настроены автоматически.

Приветствую вас, друзья!

Сегодня мы продолжаем знакомство с Laravel PHP framework, которое началось в предыдущей статье, посвящённой обзору особенностей данного фреймворка.

А сегодня мы от сухой теории переходим к практике и произведём установку Laravel на веб-сервер, чтобы наконец-то приступить к разработке сайта.

Framework, как и программы, имеет свои системные требования для полноценной работы. Они, правда, слегка отличаются от софтовых, т.к. заключаются не в особенностях железа (объём ОЗУ, частота процессора и т.д.), а в наличии необходимых программ и их версий.

Вот с этого мы и начнём процесс установки Laravel.

Установка Laravel – системные требования

Итак, вот полный перечень требований к веб-серверу, на который мы будет устанавливать Laravel и создавать сайты на его базе:

PHP >= 5.6.4
OpenSSL PHP Extension
PDO PHP Extension
Mbstring PHP Extension
Tokenizer PHP Extension
XML PHP Extension

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

Способы установки Laravel

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

Install Laravel через Composer

Если же на вашем рабочем ПК до сих пор ещё не установлен Composer, то настоятельно рекомендую его инсталлировать. Благодаря ему не только можно легко и удобно установить Laravel, но и, пожалуй, это один из способов (самый распространённый и описываемый в каждой инструкции) установки пакетов Laravel, к которым мы в будущем обязательно прибегнем для быстрого и удобного расширения базового функционала движка.

Установка Composer

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

Если вы используете ОС Windows, то для установки Composer можно воспользоваться инсталлятором, который, кроме установки, также редактирует системную переменную $PATH, благодаря чему консольную команду composer возможно вызывать глобально, вне зависимости от того, в какой папке вы находитесь.

Всё же не лишним будет перезапустить компьютер после установки, чтобы изменения переменной $PATH воспринялись ОС.

Если же вы работаете из-под другой ОС (Linux, MacOS), то в вашем случае для установки существует ещё и консольный вариант:

При данном варианте возможно выбирать целевую директорию, в которой будет установлен Composer, его версию и название файла, который по умолчанию называется composer.phar.

Иногда это бывает удобно, когда вы используете несколько версий PHP, и для каждой необходима своя версия Composer.

Также не забудьте изменить переменную $PATH и перезагрузить компьютер 🙂

Установка Laravel

После успешной установки Composer на ваш сервер в консоли переходим в папку, где будет располагаться будущий сайт. Я при разработке сайтов пользуюсь ОС Windows и замечательной программкой OpenServer, поэтому я создам Laravel проект прямо в каталоге сайтов OpenServer, предназначенном для этих нужд:

Далее устанавливаем Laravel следующей командой:

Самый последний параметр – название каталога сайта, в который будет установлен Laravel. В моём случае это «Laravel5Portfolio», вы можете написать вместо него своё название.

Данная команда автоматически скачивает Laravel в указанную папку и запустит процесс установки. Остаётся только наблюдать.

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

Он хранится в файле .env в корне проекта в виде 32-символьного значения переменной APP_KEY. Ежели она пустая, запустите в консоли artisan-команду key:generate.

По идее, если вы следовали инструкциям выше, на данном этапе проблем с ключом у вас возникнуть не должно, поэтому интерфейс artisan и список его команд мы рассмотрим немного позже.

Установка Laravel с помощью установщика

Итак, ещё один способ установки Laravel, потребующий наличия Composer.

Отличия от предыдущего заключаются в ещё одном лишнем шаге установки, целью которого является декларация глобальной команды laravel, при вызове которой будет происходить установка Laravel в определённую директорию, включая все необходимые зависимости.

Итак, если решили воспользоваться данным способом, то, прежде всего, нам необходимо будет скачать установщик Laravel следующей консольной командой:

Далее, как и при установке Composer, необходимо будет отредактировать системную переменную $PATH, о чём я уже говорил. Это нужно для декларации глобальной консольной команды, благодаря которой новый Laravel проект будет создаваться следующим способом:

В данном примере, после вызова команды в определённой директории, в которую можно попасть путём ввода команды cd путь_к_директории, будет создана папка blog, в которую установится последняя версия Laravel PHP framework.

Ручная установка Laravel

Установка Laravel с помощью Composer проста, понятна, а потому и рекомендуема. Но всё же, данный способ не является единственным, чтобы развернуть Laravel у себя на компьютере.

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

Ну, а далее следует стандартная распаковка zip-архива в директорию, где будет располагаться будущий сайт.

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

Кстати! При данном способе установки не забудьте после распаковки архива перейти в консоли в папку проекта и запустить следующую команду:

С помощью неё вы установите файлы самого фреймворка, хранящиеся в папке vendor, и прочие компоненты, идущие в Laravel из коробки, которые не храняться в Laravel репозиториях благодаря соответствующему правилу в файле .gitignore, расположенному в корне проекта.

Установка Laravel через Git с GitHub

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

Для этого запускаем Git Bash (Git консоль) в любой директории вашего ПК (лучше всего запустить её сразу в каталоге веб-сервера, содержащего папки сайтов) и вводим следующую команду:

После запуска команды вы получите файлы фреймворка у себя на компьютере. И не забудьте, как и в предыдущем способе, запустить composer update для установки недостающих ресурсов. Без них запустить и воспользоваться фреймворком у вас не получится.

Особенности установки Laravel на виртуальную машину

Наверное, если не все, то многие из вас слышали о виртуальных машинах, которые возможно создавать путём установки специальных программ (виртуализаторов) на вашу основную операционную систему (ОС) реального компьютера.

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

Плюсов в данном подходе масса:

Данную виртуальную среду разработки можно получить как при помощи установки отдельного ПО (например, Docker) либо используя надстройки для уже используемых программ-виртуализаторов.

Если у вас уже имеется установленные виртуализаторы и вы любите ими пользоваться, то для начала работы с Laravel уже есть всё необходимое в коробке.

Установка Laravel Homestead

При этом вы получаете набор необходимого для запуска сайта ПО без его реальной установки. Такой подход, кстати, рекомендуют сами разработчики Laravel в официальной документации по установке Laravel:

Vagrant является программной обёрткой для существующих виртуализаторов (Oracle VirtualBox, VMWare, Parallels и т.д.), т.е. для того, чтобы организовать виртуальную среду разработки для работы с Laravel данным способом, придётся:

Установить виртуализатор;
Установить Vagrant;
Установить Laravel Homestead.

После всех данных действий вы получите следующий список ПО без их физической установки:

Ubuntu 16.04
Git
PHP 7.1
Nginx
MySQL
MariaDB
Sqlite3
Postgres
Composer
Node (With Yarn, Bower, Grunt, and Gulp)
Redis
Memcached
Beanstalkd
Mailhog
ngrok

Если у вас уже есть виртуализатор с настроенной виртуальной машиной, то данный способ не предоставит вам особых сложностей.

Если же у вас ничего нет, то потребуется достаточно много телодвижений, т.к. помимо установки требуемых программ для ОС Windows ещё необходимо будет включить аппаратную виртуализацию в BIOS (VT-x). Это, пожалуй, единственный минус данного подхода.

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

В случае с тем же Docker, для каждого нового проекта придётся снова производить конфигурацию модулей. Причём, всё это происходит в консольном режиме с использованием команд API Docker.

В общем, Docker мне пока что показался бессмысленным и абсолютно не понравился, поэтому я решил вернуться к OpenServer.

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

Итак, я рассказал вам, как устанавливать Laravel, а также рассмотрел все возможные способы, какими установка Laravel может быть произведена. Причём, данные способы работают не только при установке на локальный веб-сервер, но могут быть применены и при разворачивании Laravel приложений с нуля прямо на хостинге.

Как же теперь проверить, что мы всё сделали правильно?

Самый простой способ проверки работоспособности Laravel даже не потребует от вас наличия настроенного веб сервера. Минимальным требованием является наличие установленного PHP.

В таком случае для запуска Laravel можно будет воспользоваться встроенным в PHP сервером разработки с помощью artisan команды serve:

Итак, если вы всё сделали правильно, то в окне браузера вы увидите приветственный экран Laravel:

Если вы его не увидели, то изучайте выдаваемые ошибки, которые вы сможете найти как прямо в браузере, так и в логах вашего веб-сервера. Пишите о них в комментариях и я постараюсь вам помочь.

Поэтому подписывайтесь на обновления проекта, чтобы получать на email уведомления о выходе новых публикаций. А также жду всех вас в нашем сообществе Вконтакте, где, помимо анонсов новых статей вы сможете задать интересующий вас вопрос по поводу разработки, правок на существующие сайты, а также по их продвижению в поисковой выдаче.

Laravel на сегодняшний день является довольно популярным веб-фреймворком, с открытым исходным кодом. Используя данный веб-фреймворк вы можете создавать веб-приложения, основанные на паттернах MVC. Перед началом разработки с Laravel, его следует установить на свой рабочий компьютер. В данном посту мы рассмотрим один из самых простых путей установки Laravel на Windows.

Установка Composer в директорию сайта

Установка будет производиться в терминале. Я использую в качестве редактора Visual Studio Code, в нём уже есть встроенный терминал, через который можно выполнять команды. Вы можете использовать любую другую среду разработки, которая вам по душе.

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

После выполнения всех команд в папке проекта должен появиться файл composer.phar. Теперь самое время установить сам Laravel.

Установка Laravel глобально и локально

Для работы с Laravel его процесс установки можно разделить на два шага, первый – установка фреймворка глобально, второй – развёртывание его локально, в папке проекта. Стоит обратить внимание на то, что глобальная установка выполняется разово. Последующие повторные установки Laravel устанавливать его глобально не нужно, а разворачивать его лишь в папке проекта с помощью локальной установки.

Шаг 1. Устанавливаем Laravel глобально через терминал:

Шаг 2. Устанавливаем Laravel локально через терминал:

Здесь в качестве «example-app» вы даёте имя папки, в которой будет находится файлы вашего проекта. В итоге у вас будет создана директория в которой будут находиться файлы пустого проекта.

После установки Laravel нам потребуется установить Node.js. Установленный Node.js позволит работать файлу «миксу», который будет собирать CSS и JS. Если говорить кратко, то это технология SASS, для работы с CSS, а также склеивания JS-файлов.

Установка Node.js для Laravel

После того как установили Node.js на компьютер, теперь мы можем установить все зависимости для Laravel.
Переходим в папку проекта перед выполнением команды npm.

В этой папке есть файл «package.json» в котором прописаны все зависимости для работы проекта.
Установка всех зависимостей выполняется следующей командой:

Это более короткая запись «npm istall». Выполнив установку всех зависимостей, в папке сайта так же появится новая директория «node_modules», в которой собственно и будут находиться дополнительные компоненты для полноценной работы с Laravel.

На этом процесс установки закончен. В Laravel есть встроенная утилита, которая называется «artisan». Эта утилита так же запускает встроенные веб-сервер Laravel, для этого следует выполнить команду:

Полный список доступных команд artisan можно посмотреть, выполнив команду в терминале:

Читайте также: