Создание и запуск проекта Laravel на Windows

Популярный PHP фреймворк Laravel

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

Ниже описывается создание и запуск приложения Laravel последней стабильной и заказной версий в операционной системе Windows на серверах Apache, IIS и встроенном сервере PHP. Для этих процедур предварительно должны быть установлены интерпретаторы PHP для функционирования фреймворка и инструмент Composer для комплексной загрузки необходимых компонентов фреймворка.

Проверка и подготовка Composer

Прежде чем создавать свой первый проект Laravel, убедитесь, что на вашем локальном компьютере установлены PHP и Composer . Непосредственно перед установкой Laravel рекомендуется обновить глобально установленный менеджер зависимостей Composer или использовать локально устанавливаемую версию композитора. Обновление глобального Composer происходит каждый раз при запуске Windows Installer, который можно скачать с официального сайта. Установка локального Composer всегда предполагает работу с последней версией композитора и после использования ее удаление.

Установка проекта Laravel

Команды запуска Composer для установки последней стабильной версии Laravel:
composer create-project laravel/laravel folder_name - установка Laravel в текущий каталог в указанную папку, рекомендуемый способ установки.
composer create-project laravel/laravel ./ - установка Laravel в текущий каталог.
composer create-project laravel/laravel ../folder_name - две точки означают установку Laravel во внешний каталог с указанным названием, выше уровня папки запуска окна командной строки.
composer create-project laravel/laravel D:/folder_name - установка в указанную папку по абсолютному пути.

Для установки конкретной версии Laravel, в команде установки необходимо указать номер версии фреймворка. Для версий Laravel значительно старших последней стабильной скорее всего потребуется установка и использование более старой версии PHP. Пример команды установки фреймворка с указанием версии 9.1:
composer create-project laravel/laravel example-app 9.1
или
composer create-project laravel/laravel=9.1 example-app

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

Запуск Laravel на сервере PHP

Хороший способ проверить успешность установки веб-фреймворка – это запуск его приложения в браузере. Для этого можно воспользоваться встроенным сервером PHP идущий в комплекте начиная с версии 5.4+ и предназначенный для помощи при разработках веб-приложений.

Запускается сервер PHP командой вспомогательного интерфейса Laravel под названием Artisan из папки размещения проекта фреймворка. Laravel требует чтобы все запросы от сервера направлялись на файл public/index.php и Artisan именно с такими настройками запускает сервер. Нахождение данного файла вне корневого каталога связано с безопасностью приложения.

Для запуска сервера необходимо открыть окно командной строки из папки проекта Laravel. Команды запуска сервера PHP посредством Artisan:
php artisan serve - по умолчанию сервер запустится и будет прослушивать адрес http://127.0.0.1:8000
или можно указать порт:
php artisan serve --port=8080
или хост:
php artisan serve --host=127.0.0.2 - веб-приложение запустится на http://127.0.0.2:8000/.
Или хост и порт:
php artisan serve --host=127.0.0.2 --port=8080 - при этом адрес запуска будет http://127.0.0.2:8080.
Если отсутствует глобально установленный PHP, вместо директивы php необходимо указывать абсолютный путь до файла php.exe локальной папки интерпретатора PHP. После этого по адресу, указанному в командах запуска сервера, можно запустить приложение Laravel в любом браузере.

Запуск Laravel на сервере Апачи

Сервер Apache прекрасно сотрудничает с интерпретатором PHP на любых платформах. Для запуска приложения Laravel требуется только перенаправить запросы сервера на файл public/index.php. Перенаправление можно осуществить в файле дополнительной конфигурации сервера Апачи .htaccess. Этот файл конфигурации следует разместить в корневой папке фреймворка Laravel. Установка сервера Apache на Windows и настройка работы Апачи и PHP - информация для случая затруднений запуска Laravel на тандеме Apache-PHP.

<IfModule mod_rewrite.c>
# Включение возможности перезаписи URL адресов
RewriteEngine On

# Направление всех запросов на папку /public
RewriteCond %{REQUEST_URI} !/public
RewriteRule ^(.*)$ public/$1 [L]

# Отключить короткие теги php, иначе могут быть проблемы с xml файлами.
#php_value short_open_tag 0
</IfModule>

Запуск Laravel сервере IIS

Laravel не только кроссплатформенный, но благодаря экосистеме PHP, еще и «кросс-серверный». Фреймворк полноценно работает на сервере IIS. В этом случае также необходимо указать IIS о направлении всех запросов на файл public/index.php. Сервер IIS тоже имеет соответствующий файл дополнительных настроек с названием web.config. Файл следует разместить в корневой папке фреймворка Laravel.

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
		<handlers accessPolicy="Read, Script">
            <remove name="PHP82FastCgi" />
            <add name="PHP82FastCgi" path="*.php" verb="*" modules="FastCgiModule" 
			scriptProcessor="C:\Program Files\IIS Express\PHP\v8.2\php-cgi.exe" 
			resourceType="File" requireAccess="Script" />   
		</handlers>
		<rewrite>
		<rules>
			<rule name="SPA fallback routing" stopProcessing="true">
				<match url=".*" />
				<conditions logicalGrouping="MatchAll">
					<add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
				</conditions>
				<action type="Rewrite" url="public\index.php" />
			</rule>
		</rules>
		</rewrite>
    </system.webServer>
</configuration>

Запуск Laravel в среде Visual Studio Code

Visual Studio Code - бесплатный редактор профессионального уровня, отлично подходит для разработок приложений на PHP. Построен на основе открытого исходного кода и работает на любых платформах. Описание и загрузка на официальном сайте Visual Studio Code - Code Editing.

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

При отсутствии установленных веб-серверов приложение можно запускать и отлаживать на сервере PHP. Для этого во вкладке Terminal (встроенное окно командной строки) необходимо ввести и выполнить команды запуска сервера PHP с помощью помощника Artisan описанные выше.

После запуска сервера приложение Laravel можно открыть в любом браузере по адресу запуска и продолжать разработку в Visual Studio Code. Скачать дополнительные расширения для разработки на PHP Laravel можно с сайта Extensions for Visual Studio Code

Исходник приложения на фреймворке Laravel

Для упрощения начала тестирования фреймворка Laravel ниже прикреплен исходник приложения. Исходник включает конфигурационные файлы .htaccess для работы на сервере Apache и web.config для запуска приложения на IIS. Исходник подготовлен для разработки в Visual Studio Code v1.85 и имеет файл launch.json для запуска Laravel в браузере на предварительно запущенном встроенном сервере PHP.