Установка Grav

Установка Grav это довольно тривиальный процесс. На самом деле, это не совсем установка.

Вариант 1: Установка из ZIP-архива

Самый простой путь установки Grav - это скачать ZIP архив и распаковать его:

1. Скачайте самый последний архив из Загрузок
2. Распакуйте ZIP-файл в корневую директорию вашего веб-сервера, например ~/webroot/grav

Если вы скачали и распаковали ZIP-файл и потом планируете перенести его содержимое непосредственно в корневую директорию, то обязательно переносите всю папку, потому что она содержит некоторые скрытые файлы (такие как .htaccess), которые не будут выбраны по умолчанию. Пропуск этих скрытых файлов может вызвать проблемы в работе Grav.

Вариант 2: Установка с GitHub

Альтернативным методом является клонирование Grav из репозитория GitHub, и далее запуск простого скрипта установки зависимостей:

1. Склонируйте репозиторий Grav с GitHub в корневую директорию вашего веб-сервера, например ~/webroot/grav. Запустите терминал или консоль, перейдите в корневую директорию:

   $ cd ~/webroot
   $ git clone https://github.com/getgrav/grav.git

2. Установите зависимости плагинов и темы, используя Grav CLI приложение bin/grav:

   $ cd ~/webroot/grav
   $ bin/grav install

   Это автоматически склонирует необходимые зависимости напрямую с GitHub в эту установку Grav.

Веб-сервер

Apache/IIS/Nginx

Использование Grav с веб-сервером типа Apache, IIS или Nginx сводится к простой распаковке Grav в папку корневой директории. Все что нужно, это наличие PHP 5.4 или выше, так что убедитесь в том, что ваш веб-сервер соответствует этому требованию. Больше информации о требованиях Grav вы найдете в документе Требования.

Например, если ваша корневая веб-директория ~/public_html, то вы можете распаковать архив в эту папку и попасть на неё по адресу http://localhost. Если вы распаковали в ~/public_html/grav, то можете попасть на неё по адресу http://localhost/grav.

Встроенный веб-сервер PHP

Предупреждение! Использование встроенного веб-сервера PHP предназначено только для быстрого тестирования! Также из-за отсутствия функционала роутинга многие из плагинов Grav просто не буду работать. Поэтому используйте надлежащий веб-сервер!

Установить и запустить Grav невероятно легко. Вы может сделать это без установки и настройки веб-сервера! Убедитесь в том, что версия PHP не ниже 5.4, написав в терминале:

$ php -v

Это выведет отчет о версии и билде, например:

PHP 5.4.24 (cli) (built: Jan 19 2014 21:32:15)
Copyright (c) 1997-2013 The PHP Group
Zend Engine v2.4.0, Copyright (c) 1998-2013 Zend Technologies

Чтобы попробовать Grav, в терминале пройдите в папку, в которую вы распаковали установочный пакет Grav и напишите:

$ php -S localhost:8000

Это запустит встроенный PHP веб-сервер. Потом перейдите по адресу http://localhost:8000 и вы должны увидеть Grav.

Успешная установка

При первой загрузке Grav пре-компилирует некоторые файлы. Если сейчас вы обновите ваш браузер, то вы получите более быструю, закэшированную версию.

В предыдущих примерах значок $ представляет командную строку. Он может выглядеть по разному на разных платформах.

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

Проблемы установки и настройки

Если найдены какие-то проблемы во время начальной загрузки страницы (или после события сброса кэша), то вы можете увидеть страницу ошибок:

Помощь по решению этих ошибок вы можете найти в разделе Устранение проблем.

Обновления Grav

Автоматическое обновление

Предпочтительный метод для обновления Grav - это использовать Менеджер пакетов Grav (Grav Package Manager - GPM). Все что нужно сделать, это перейти в корень вашего Grav веб-сайта и написать:

bin/gpm selfupgrade

Полную информацию вы найдете в документации по Grav GPM. Если вы установили плагин админ панели, то встроенный в него GPM будет проверять и уведомлять о наличии обновлений.

Ручное обновление

Процесс ручного обновления Grav следующий:

1. Сделайте бэкап вашего сайта используя команду bin/grav backup или просто заархивируйте весь Grav сайт и особенно папку user/.
2. Скачайте пакет обновления из раздела Загрузки. Важно скачать именно пакет обновлений, а не весь Grav Core.
3. Распакуйте пакет обновлений поверх существующей установки Grav и он скопирует все обновления в системной парке ядра.
4. Очистите кэш Grav, используя команду bin/grav clear-cache, чтобы убедиться в том, что все закэшированные и скомпилированные файлы воссоздались заново.

Важно не копировать пакет установки Grav Core поверх вашего текущего сайта, так как это может переписать вашу папку user/, чтоб приведет к потере ваших данных.