Требования¶

Grav намеренно спроектирован так, чтобы предъявлять минимум требований. Вы можете без труда запустить Grav на своём локальном компьютере, как и на 99 % хостинг-провайдеров. Если под рукой есть ручка, запишите следующие системные требования Grav:

Веб-сервер (Apache, Nginx, LiteSpeed, Lightly, IIS и т. д.)
PHP 8.3.11 или выше
хм… собственно, это всё (но для комфортной работы всё же ознакомьтесь с требованиями к PHP)!

Grav построен на обычных текстовых файлах для вашего контента. База данных не нужна.

Внимание

Для оптимальной производительности настоятельно рекомендуется пользовательский кэш PHP, например APCu, Memcached или Redis. Впрочем, не волнуйтесь: обычно они уже входят в ваш хостинговый пакет!

Веб-серверы¶

Grav настолько прост и универсален, что для него даже не нужен веб-сервер. Его можно запустить прямо на встроенном веб-сервере PHP, если у вас установлен PHP 8.3.11 или более поздняя версия.

Тестирование на встроенных веб-серверах — полезный способ проверить установку Grav и немного поработать над разработкой, но он не рекомендуется для действующего сайта и даже для сложных задач разработки. Мы описали этот способ в руководстве по установке.

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

macOS¶

MAMP/MAMP Pro поставляется с Apache, MySQL и, конечно, PHP. Это отличный способ получить больше контроля над версией PHP, настраивать виртуальные хосты и пользоваться другими полезными фичами, например автоматической обработкой динамического DNS.
DDEV — среды разработки PHP на Docker.
AMPPS — программный стек от Softaculous, включающий Apache, PHP, Perl, Python… В нём есть всё необходимое (и даже больше) для разработки на Grav.
Brew Apache/PHP — альтернативный подход, позволяющий получить полностью настраиваемую установку с различными версиями PHP.

Windows¶

Laragon — портативная, изолированная, быстрая и мощная универсальная среда разработки для PHP, Node.js и многого другого. Она быстрая, лёгкая, простая в использовании и легко расширяется.
XAMPP предоставляет Apache, PHP и MySQL в одном простом пакете.
EasyPHP предлагает пакет для персонального веб-хостинга, а также более мощную версию для разработчиков.
MAMP для Windows — давний фаворит на Mac, теперь доступный и для Windows.
IIS с PHP — быстрый способ запустить PHP в Windows.
DDEV — среды разработки PHP на Docker.
AMPPS — программный стек от Softaculous, включающий Apache, PHP, Perl, Python… В нём есть всё необходимое (и даже больше) для разработки на Grav.
Подсистема Linux — отличный способ запустить окружение, похожее на Linux, в Windows.

Примечание переводчика

Из собственного опыта могу порекомендовать Open Server Panel (Windows) и Laravel Herd (Windows, MacOS)

Linux¶

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

Требования к Apache¶

Хотя большинство дистрибутивов Apache поставляются со всем необходимым, для полноты приведём список требуемых модулей Apache:

mod_rewrite
mod_ssl (если вы хотите запускать Grav под SSL)
mod_mpm_itk_module (если вы хотите запускать Grav под отдельной учётной записью пользователя)

Также убедитесь, что в блоках <Directory> и/или <VirtualHost> установлено AllowOverride All, чтобы файл .htaccess обрабатывался правильно и правила перезаписи вступали в силу.

Требования к IIS¶

Хотя IIS считается веб-сервером, готовым к работе «из коробки», некоторые изменения всё же нужно внести.

Чтобы Grav работал на сервере IIS, необходимо установить URL Rewrite. Это можно сделать с помощью Microsoft Web Platform Installer прямо из IIS. Также URL Rewrite можно установить, зайдя на iis.net.

Требования к PHP¶

Большинство хостинг-провайдеров и даже локальных установок LAMP имеют PHP, предварительно настроенный со всем необходимым для работы Grav «из коробки». Однако некоторые установки Windows и даже дистрибутивы Linux — локальные или на VPS (это я смотрю на тебя, Debian!) — поставляются с очень минимальной сборкой PHP. Поэтому вам может потребоваться установить или включить следующие модули PHP:

curl (клиент для работы с URL, используется GPM)
ctype (проверка классов символов, используется валидацией и symfony/yaml)
dom (используется для разбора и очистки HTML)
gd (графическая библиотека для обработки изображений)
json (используется Symfony/Composer/GPM)
libxml (базовый XML-парсер для dom и simplexml)
mbstring (поддержка многобайтовых строк)
openssl (библиотека защищённых сокетов, используется GPM)
session (используется для входа и flash-сообщений)
simplexml (используется для разбора и очистки медиафайлов SVG)
zip (используется Composer и GPM для распаковки пакетов)

Необязательные, но рекомендуемые:

fileinfo (точное определение MIME-типа для загрузок и медиафайлов)
intl (форматирование с учётом локали на многоязычных сайтах)
exif (чтение ориентации и данных камеры из изображений)
pdo_sqlite (включает более быстрое хранилище индекса страниц на больших сайтах)

Чтобы включить поддержку openssl и (рас)паковки zip, найдите в файле php.ini вашего дистрибутива Linux строки вроде:

;extension=openssl.so
;extension=zip.so

и удалите ведущую точку с запятой.

Необязательные модули¶

apcu для повышения производительности кэша
opcache для повышения производительности PHP
yaml — PECL Yaml обеспечивает нативную обработку YAML и может значительно повысить производительность
xdebug полезен для отладки в среде разработки

Права доступа¶

Чтобы Grav работал корректно, ваш веб-сервер должен иметь соответствующие права доступа к файлам для записи журналов, кэша и т. д. При использовании CLI (интерфейса командной строки) или GPM (менеджера пакетов Grav) пользователь, запускающий PHP из командной строки, также должен иметь соответствующие права на изменение файлов.

По умолчанию Grav устанавливается с правами 644 для файлов и 755 для папок. У большинства хостинг-провайдеров конфигурация обеспечивает веб-серверу, работающему с PHP, возможность создавать и изменять файлы в вашей учётной записи. Это значит, что Grav работает из коробки у подавляющего большинства хостинг-провайдеров.

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

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

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

ps aux | grep -v root | grep apache | cut -d\  -f1 | sort | uniq

Теперь узнайте, к какой группе принадлежит этот пользователь, выполнив эту команду (примечание: замените USERNAME на имя пользователя Apache, найденное в предыдущей команде):

groups USERNAME

(примечание: замените GROUP на группу, под которой работает ваш Apache, найденную в предыдущей команде: [www-data, apache, nobody и т. д.]):

chgrp -R GROUP .
find . -type f | xargs chmod 664
find ./bin -type f | xargs chmod 775
find . -type d | xargs chmod 775
find . -type d | xargs chmod +s
umask 0002

Если нужно использовать права суперпользователя, вместо этого выполните find … | sudo xargs chmod ….

Требования¶

Веб-серверы¶

macOS¶

Windows¶

Linux¶

Требования к Apache¶

Требования к IIS¶

Требования к PHP¶

Необязательные модули¶

Права доступа¶

Рекомендуемые инструменты¶

PhpStorm¶

Текстовые редакторы¶

Редакторы Markdown¶

FTP-клиенты¶

Git¶