Как запустить Yii2 Advanced на Apache в Windows 11

Чтобы запустить шаблон Yii2 Advanced на Apache в Windows 11, необходимо правильно настроить виртуальные хосты для frontend и backend, отредактировать файл hosts и убедиться, что Apache имеет права доступа к директориям проекта. Основная проблема обычно заключается в неверной настройке виртуальных хостов или отсутствии записей в файле hosts для доступа к frontend.test и backend.test.

Содержание

• Структура шаблона Yii2 Advanced
• Настройка виртуальных хостов Apache
• Редактирование файла hosts в Windows 11
• Права доступа и конфигурация
• Проверка и тестирование
• Устранение распространенных проблем

Структура шаблона Yii2 Advanced

Шаблон Yii2 Advanced имеет трехуровневую архитектуру с разделением на frontend и backend:

yii2-app-advanced/
├── backend/
│   └── web/         # Корневая директория для backend.test
├── frontend/
│   └── web/         # Корневая директория для frontend.test
└── common/          # Общие компоненты

Каждый компонент (frontend и backend) имеет свою собственную директорию web, которая должна быть установлена как DocumentRoot в конфигурации Apache. Эта структура требует отдельной настройки виртуальных хостов для корректной работы.

Настройка виртуальных хостов Apache

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

Для Apache 2.4 (установленного через XAMPP или WAMP) необходимо отредактировать файл конфигурации виртуальных хостов:

<VirtualHost *:80>
    ServerName frontend.test
    DocumentRoot "C:/path/to/yii2-app-advanced/frontend/web"
    <Directory "C:/path/to/yii2-app-advanced/frontend/web">
        Require all granted
        RewriteEngine on
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule . index.php
    </Directory>
</VirtualHost>

<VirtualHost *:80>
    ServerName backend.test
    DocumentRoot "C:/path/to/yii2-app-advanced/backend/web"
    <Directory "C:/path/to/yii2-app-advanced/backend/web">
        Require all granted
        RewriteEngine on
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule . index.php
    </Directory>
</VirtualHost>

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

Для более старых версий Apache 2.2 используйте следующую конфигурацию:

<VirtualHost *:80>
    ServerName frontend.test
    DocumentRoot "C:/path/to/yii2-app-advanced/frontend/web"
    <Directory "C:/path/to/yii2-app-advanced/frontend/web">
        Order allow,deny
        Allow from all
        RewriteEngine on
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule . index.php
    </Directory>
</VirtualHost>

<VirtualHost *:80>
    ServerName backend.test
    DocumentRoot "C:/path/to/yii2-app-advanced/backend/web"
    <Directory "C:/path/to/yii2-app-advanced/backend/web">
        Order allow,deny
        Allow from all
        RewriteEngine on
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule . index.php
    </Directory>
</VirtualHost>

Важно: Эта конфигурация должна быть добавлена в файл httpd-vhosts.conf, который обычно находится в:

• C:/xampp/apache/conf/extra/httpd-vhosts.conf (для XAMPP)
• C:/MAMP/bin/apache/conf/extra/httpd-vhosts.conf (для MAMP)

Редактирование файла hosts в Windows 11

Чтобы доменные имена frontend.test и backend.test разрешались на локальный IP-адрес, необходимо отредактировать системный файл hosts:

1. Откройте Блокнот от имени администратора
2. Откройте файл C:/Windows/System32/drivers/etc/hosts
3. Добавьте следующие строки:

127.0.0.1    frontend.test
127.0.0.1    backend.test

4. Сохраните файл (файл hosts не имеет расширения)

Совет: Если вы не можете сохранить файл hosts, попробуйте сохранить его с расширением .txt, а затем переименовать обратно в hosts без расширения.

Права доступа и конфигурация

Настройка прав доступа

Убедитесь, что Apache имеет права на чтение файлов в директориях frontend/web и backend/web. Это можно настроить через свойства папок или изменить владельца файлов.

Проверка модуля mod_rewrite

Убедитесь, что модуль mod_rewrite включен в Apache. Проверьте файл httpd.conf на наличие строки:

LoadModule rewrite_module modules/mod_rewrite.so

Если строка закомментирована (#LoadModule...), раскомментируйте ее и перезапустите Apache.

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

В директориях frontend/web и backend/web должны присутствовать файлы .htaccess с правильной конфигурацией для обработки красивых URL:

RewriteEngine on

# If a directory or a file exists, use the request directly
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# Otherwise forward the request to index.php
RewriteRule . index.php

Проверка и тестирование

Порядок действий

1. Перезапустите Apache после внесения изменений в конфигурацию
2. Откройте браузер и перейдите на http://frontend.test
3. Проверьте работу приложения и красивых URL
4. Повторите тест для http://backend.test

Ожидаемые результаты

• frontend.test должен отображать frontend-часть приложения
• backend.test должен отображать backend-часть приложения
• Красивые URL должны работать корректно (например, /site/login вместо ?r=site/login)

Устранение распространенных проблем

Проблема: “It works!” вместо приложения

Причина: DocumentRoot указывает на стандартную директорию Apache вместо директории проекта.

Решение: Проверьте конфигурацию виртуальных хостов и убедитесь, что DocumentRoot указывает на правильные директории frontend/web и backend/web.

Проблема: 404 Not Found

Причина: Отключен mod_rewrite или неверная конфигурация .htaccess.

Решение: Включите mod_rewrite и проверьте содержимое .htaccess файлов в директориях web.

Проблема: Доступ запрещен

Причина: Неверные права доступа к директориям проекта.

Решение: Настройте права доступа для пользователя, под которым работает Apache (обычно это apache или www-data).

Проблема: Доменные имена не разрешаются

Причина: Отсутствие записей в файле hosts.

Решение: Добавьте записи для frontend.test и backend.test в файл hosts и перезапустите браузер.

Источники

1. Официальная документация Yii 2 Advanced Project Template - Installation
2. Yii2-app-advanced on single domain (Apache, Nginx) - Wiki
3. How To Configure Apache For Yii2-Advance - Yii Forum
4. GitHub - yii2-advanced-one-domain-config
5. How to add a custom virtual host on Windows 11 - DEV Community
6. How to setup Apache virtual host on Windows using XAMPP

Заключение

Запуск шаблона Yii2 Advanced на Apache в Windows 11 требует правильной настройки виртуальных хостов, редактирования файла hosts и обеспечения прав доступа к директориям проекта. Основные шаги включают:

1. Настройка отдельных виртуальных хостов для frontend.test и backend.test
2. Добавление записей в файл hosts для разрешения доменных имен
3. Включение модуля mod_rewrite для обработки красивых URL
4. Проверка прав доступа к директориям web
5. Тестирование работы приложений после перезапуска Apache

Если следовать этим инструкциям, вы сможете успешно запустить и настроить шаблон Yii2 Advanced на локальном сервере Apache в Windows 11.