Romych: /* Необходимый минимум: Apache, MySQL и PHP */

2020-05-08T16:10:37Z

Необходимый минимум: Apache, MySQL и PHP

Нова сторінка

Для работы с Drupal веб-разработчику нужно настроить на своем компьютере такой набор приложений:

* Apache
* MySQL
* PHP

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

* phpMyAdmin — веб-интерфейс для управления MySQL;
* Composer — менеджер зависимостей для PHP, требуется для Drupal 8;
* uploadprogress — библиотека PHP для отображения процесса загрузки, нужна для Drupal;
* Drush — управление Drupal из командной строки;
* Git — для скачивания последних версий библиотек и модулей Drupal и управления версиями вашего кода;
* Node.js и npm — сервер JavaScript приложений и менеджер пакетов, необходимы для Sass и Gulp;
* Sass и Gulp — продвинутый синтаксис и препроцессор CSS.

Установим и настроим все это максимально быстро и с минимальным количеством действий.

Инструкция протестирована на Ubuntu 15.04 и Debian 8.2.

== Необходимый минимум: Apache, MySQL и PHP ==

Установите [[Apache]], [[MySQL]] и [[PHP]]:

<source lang="bash">
sudo apt install apache2 mysql-server php
</source>

Добавьте <code>ServerName localhost</code> в конфиг Apache:

<source lang="bash">
sudo sh -c "echo 'ServerName localhost' >> /etc/apache2/apache2.conf"
</source>

Проверьте конфиг Apache: <code>apachectl -t</code> — должно появиться сообщение <code>Syntax OK</code>.

Добавьте вашего пользователя в группу <code>www-data</code>. Это важно для Apache, например, когда Drupal загружает на сайт файлы.

<source lang="bash">
sudo usermod -a -G www-data $(whoami)
</source>

Включите модуль Apache <code>mod_rewrite</code> для создания человекопонятных URL:

<source lang="bash">
sudo a2enmod rewrite
sudo apachectl restart
</source>

Создайте тестовый файл для проверки PHP:

<source lang="bash">
sudo sh -c 'echo "<?php phpinfo(); ?>" >> /var/www/html/info.php'
</source>

Проверьте Apache: http://localhost

Проверьте PHP: http://localhost/info.php

<div class="hint">Если нет графического интерфейса (например, при работе через SSH) — можно протестировать в командной строке с использованием консольного браузера <code>links</code>:

<source lang="bash">
sudo apt install links
xdg-open http://localhost
xdg-open http://localhost/info.php
</source>
</div>

Уже после этого этапа можно полноценно работать с локальными сайтами.

Инструкция по настройке работы сайтов не в <code>/var/www/</code>, а в домашней папке пользователя: [[Apache#Настройка хранения сайтов в домашней папке]].

== phpMyAdmin ==

Установить <code>phpMyAdmin</code> - веб-интерфейс для управления MySQL:

<source lang="bash">
sudo apt install phpmyadmin
</source>

Проверить phpMyAdmin: http://localhost/phpmyadmin

== Composer ==

<code>Composer</code> — это современный менеджер зависимостей PHP. Он необходим Drupal, начиная с версии Drupal 8.

Установить Composer:

<source lang="bash">
sudo apt install composer
</source>

Проверить версию установленного Composer: <code>composer --version</code>

== uploadprogress ==

uploadprogress — это библиотека PHP для отслеживания прогресса загрузки файла на сервер. Без этой библиотеки в статусе Drupal <code>admin/reports/status</code> может выводиться сообщение об ошибке.

Установка библиотеки <code>uploadprogress</code>:

sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php-uploadprogress

== Drush ==

<code>Drush</code> (акроним словосочетания "Drupal Shell") — это must-have инструмент вебмастеров Drupal. Drush позволяет из командной строки выполнять множество действий над Drupal, например установку сайта, очистку кэша, смену паролей, создание резервной копии и многое другое.

Есть [[Drush | несколько способов]] установки Drush — например, через PEAR или Composer. Так как для Drupal 8 все равно требуется Composer, то используем этот вариант.

<source lang="bash">
sudo git clone --branch 8.x https://github.com/drush-ops/drush.git /opt/drush
cd /opt/drush
sudo composer install
sudo ln -s /opt/drush/drush /usr/local/bin/drush
</source>

Проверить версию установленного Drush:

<source lang="bash">
drush version
</source>

== Git ==

Git — система управлениями версиями кода. Разработчику Drupal нужно иметь Git для двух задач:

# скачивать последние версии библиотек и модулей из удаленных репозиториев, таких, как http://drupal.org или http://github.com;
# сохранять в собственном репозитории промежуточные версии проектов (сайтов), над которыми ведется работа.

Установить Git:

<source lang="bash">
sudo apt-get install git
</source>

Проверить версию установленного Git:

git --version

== Node.js и npm ==

<code>Node.js</code> — платформа для разработки серверных приложений на языке JavaScript. Напрямую при работе с Drupal она не используется, но она требуется для установки Sass, Gulp и других крутых штук, применяемых в современной верстке сайтов.

Вместе с Node.js потребуется <code>npm</code> — менеджер пакетов, который поддерживает пакеты для Node.js, Gulp, Grunt, jQuery и других популярных платформ.

Установим официальный репозиторий и оба приложения — Node.js и npm.

<source lang="bash">
curl -sL https://deb.nodesource.com/setup_5.x | sudo -E bash -
sudo apt-get install nodejs
</source>

Проверить версию:

<source lang="bash">
node -v
npm -v
</source>

== Sass ==

Sass — это препроцессорный язык с синтаксисом SCSS. Проще говоря, это CSS с расширенными и более удобными возможностями. Но т.к. код SCSS все-таки не чистый CSS и его нельзя напрямую давать браузеру, то он сначала обрабатывается препроцессором, после чего браузеру отдается стандартный, хорошо оптимизированный CSS.

Установка Sass:

<source lang="bash">
sudo apt-get install ruby-sass
</source>

Проверить версию:

<source lang="bash">
sass -v
</source>

== Gulp ==

<code>Gulp</code> — сборщик кода Sass/SCSS. Он запускается в фоне и, пока вы работаете с шаблонами сайта, следит за изменениями в ваших файлах SCSS и на лету пересобирает их в понятный браузеру и оптимизированный по размеру CSS.

У вас уже должны быть установлены <code>Node.js</code>, <code>NPM</code> и <code>Sass</code>, как описано выше.

Установите Gulp:

<source lang="bash">
sudo npm install -g gulp
</source>

Параметр <code>-g</code> означает, что Gulp будет установлен глобально, т.е. в общесистемную папку.

Дальнейшая настройка Gulp делается локально, в папке вашего проекта.

Проверить версию:

gulp -v

== Короче говоря ==

Установить всё:

<source lang="bash">
sudo apt-get install -y curl; curl -sL https://deb.nodesource.com/setup_5.x | sudo -E bash -
sudo apt-get install -y apache2 php5 php-pear mysql-server php5-dev phpmyadmin dnsmasq composer git nodejs ruby-sass
composer global require drush/drush:dev-master
sed -i '1i export PATH="$HOME/.composer/vendor/bin:$PATH"' $HOME/.bashrc; source $HOME/.bashrc
sudo pecl install uploadprogress; sudo sh -c 'echo "extension=uploadprogress.so" >> /etc/php5/apache2/php.ini'
sudo sh -c 'echo "<?php phpinfo(); ?>" >> /var/www/html/info.php'
sudo a2enmod rewrite; sudo usermod -a -G www-data $(whoami); sudo service apache2 restart
sudo sh -c 'echo "\naddress=/loc/127.0.0.1\nlisten-address=127.0.0.1" >> /etc/dnsmasq.conf'
sudo service dnsmasq restart
sudo npm install -g gulp
</source>

Проверить:

<source lang="bash">
sudo apt-get install links
xdg-open http://localhost
xdg-open http://localhost/info.php
xdg-open http://localhost/phpmyadmin
ping -c 4 qwerty.loc
apache2 -v
php -v
drush version
git --version
node -v
npm -v
sass -v
gulp -v
</source>

Quickstart Drupal Development Environment on Linux - Історія редагувань

Romych: /* Необходимый минимум: Apache, MySQL и PHP */