Для установки XAMPP на Ubuntu нужно скачать .run-инсталлятор с официального сайта, сделать его исполняемым и запустить от имени администратора [1].
[Пошаговая установка]
1. Скачайте установщик. Перейдите на страницу загрузки Apache Friends и выберите версию для Linux (64-bit) с нужной версией PHP (например, 8.2.12). Файл сохранится в папку Загрузки (~/Downloads). Это может быть файл наподобие xampp-linux-x64-8.2.12-0-installer.run [3].
2. Откройте терминал и перейдите в папку со скачанным файлом, сделайте файл исполняемым:
cd ~/Downloads
chmod +x xampp-linux-x64-*-installer.run
3. Запустите графический мастер установки:
sudo ./xampp-linux-x64-*-installer.run
Далее следуйте инструкциям на экране (нажимайте Forward / Next, оставляя параметры по умолчанию). Сборка установится в директорию /opt/lampp.
[Управление сервером и полезные пути]
• Корневая папка для ваших сайтов: /opt/lampp/htdocs/ (по умолчанию открывается по адресу http://localhost в браузере).
• Запуск всех служб (Apache, MariaDB, ProFTPD):
sudo /opt/lampp/lampp start
• Остановка или перезапуск:
sudo /opt/lampp/lampp stop
sudo /opt/lampp/lampp restart
• Графическая панель управления (как в Windows):
sudo /opt/lampp/manager-linux-x64.run
• Удаление XAMPP (если потребуется):
sudo /opt/lampp/uninstall
[Настройка виртуальных хостов]
Чтобы настроить виртуальные хосты в XAMPP на Ubuntu, например для домена mysite.local (чтобы сайты открывались по локальным доменам вроде mysite.local, как в Denwer), нужно включить поддержку файла httpd-vhosts.conf, прописать конфигурацию сайта и добавить локальный домен в системный файл hosts.
1. Создайте папку для сайта
Создайте директорию проекта внутри htdocs (или в любом удобном месте, например в домашней папке) и добавьте тестовый файл:
sudo mkdir -p /opt/lampp/htdocs/mysite.local
echo "< h1>It works!< /h1>" | sudo tee /opt/lampp/htdocs/mysite.local/index.php
2. Включите виртуальные хосты в Apache
2.1. Откройте основной конфиг Apache:
sudo nano /opt/lampp/etc/httpd.conf
2.2. Найдите строку (в nano поиск вызывается через Ctrl + W):
#Include etc/extra/httpd-vhosts.conf
2.3. Уберите символ решетки # в начале строки, чтобы получилось:
Include etc/extra/httpd-vhosts.conf
2.4. Сохраните файл (Ctrl + O, затем Enter) и выйдите (Ctrl + X).
3. Пропишите конфигурацию вашего домена
3.1. Откройте файл настроек виртуальных хостов:
sudo nano /opt/lampp/etc/extra/httpd-vhosts.conf
3.2. Добавьте в конец файла следующий блок (первый блок для localhost нужен, чтобы не перестал открываться стандартный дашборд XAMPP и phpMyAdmin):
< VirtualHost *:80>
DocumentRoot "/opt/lampp/htdocs"
ServerName localhost
< /VirtualHost>
< VirtualHost *:80>
DocumentRoot "/opt/lampp/htdocs/mysite.local"
ServerName mysite.local
ServerAlias www.mysite.local
< Directory "/opt/lampp/htdocs/mysite.local">
Options Indexes FollowSymLinks ExecCGI Includes
AllowOverride All
Require all granted
< /Directory>
< /VirtualHost>
Замечание: если вы размещаете проекты не в /opt/lampp/htdocs/, а в своей домашней папке /home/имя_пользователя/projects/..., дополнительно откройте /opt/lampp/etc/httpd.conf и в строках User daemon / Group daemon замените daemon на ваше имя пользователя в Ubuntu, иначе Apache выдаст ошибку 403 Forbidden.
4. Привяжите домен в файле /etc/hosts
4.1. Откройте системный файл hosts:
sudo nano /etc/hosts
4.2. Добавьте в конец файла строку:
127.0.0.1 mysite.local www.mysite.local
4.3. Сохраните и закройте файл.
5. Перезапустите XAMPP. Примените изменения перезапуском служб:
sudo /opt/lampp/lampp restart
Теперь при переходе по адресу http://mysite.local в браузере откроется ваш локальный сайт.
[Автозапуск XAMPP при включении Ubuntu]
Чтобы добавить XAMPP в автозапуск Ubuntu, проще всего создать системную службу systemd, которая будет автоматически запускать и корректно останавливать сервер при включении и выключении компьютера.
Пошаговая настройка через systemd:
1. Создайте файл службы xampp.service:
sudo nano /etc/systemd/system/xampp.service
2. Вставьте в него следующую конфигурацию:
[Unit]
Description=XAMPP Server
After=network.target
[Service]
Type=forking
ExecStart=/opt/lampp/lampp start
ExecStop=/opt/lampp/lampp stop
RemainAfterExit=yes
[Install]
WantedBy=multi-user.target
Замечание: параметр After=network.target гарантирует, что XAMPP запустится только после инициализации сетевых интерфейсов.
3. Сохраните файл (Ctrl + O, затем Enter) и закройте редактор (Ctrl + X).
4. Обновите конфигурацию systemd и включите автозапуск:
sudo systemctl daemon-reload
sudo systemctl enable xampp.service
5. Проверьте работу службы. Если XAMPP сейчас остановлен, запустите его через новую службу и проверьте статус:
sudo systemctl start xampp.service
sudo systemctl status xampp.service
В статусе должна появиться зелёная надпись active (exited).
Полезные команды для управления службой. Теперь вы можете управлять XAMPP как стандартным системным сервисом Ubuntu:
• Отключить автозапуск (если передумаете):
sudo systemctl disable xampp.service
• Перезапустить XAMPP:
sudo systemctl restart xampp.service
• Остановить XAMPP:
sudo systemctl stop xampp.service
[Размещение хостов в домашнем каталоге]
Разберём обе задачи: сначала перенесём папку проектов в домашнюю директорию (чтобы забыть про sudo при работе с кодом), а затем настроим доверенный локальный HTTPS без предупреждений браузера.
Часть 1. Размещение проектов в домашней папке (без sudo)
По умолчанию Apache в XAMPP работает от имени пользователя daemon, у которого нет прав на чтение вашей домашней папки. Чтобы это исправить, запустим Apache от вашего имени.
1. Создайте папку для проектов в домашней директории (без sudo):
mkdir -p ~/projects/mysite.local
echo "< h1>Works from Home!< /h1>" > ~/projects/mysite.local/index.php
2. Смените пользователя Apache в конфиге. Для этого откройте основной файл конфигурации:
sudo nano /opt/lampp/etc/httpd.conf
Найдите строки (через Ctrl + W -> User daemon):
User daemon
Group daemon
Замените daemon на ваше имя пользователя в Ubuntu (узнать его можно командой whoami в терминале):
User ваше_имя_пользователя
Group ваше_имя_пользователя
Сохраните (Ctrl + O, Enter) и выйдите (Ctrl + X).
3. Укажите новый путь в виртуальном хосте. Откройте httpd-vhosts.conf:
sudo nano /opt/lampp/etc/extra/httpd-vhosts.conf
Замените путь /opt/lampp/htdocs/mysite.local на полный путь к вашей папке (обязательно пишите /home/имя_пользователя/..., символ ~ в конфигах Apache не работает):
< VirtualHost *:80>
DocumentRoot "/home/ваше_имя_пользователя/projects/mysite.local"
ServerName mysite.local
ServerAlias www.mysite.local
< Directory "/home/ваше_имя_пользователя/projects/mysite.local">
Options Indexes FollowSymLinks ExecCGI Includes
AllowOverride All
Require all granted
< /Directory>
< /VirtualHost>
Примечание: если вы используете phpMyAdmin, после смены User иногда сбиваются права на папку сессий PHP. Если phpMyAdmin выдаст ошибку сессии, выполните sudo chmod -R 777 /opt/lampp/temp или смените владельца папки /opt/lampp/temp на себя.
Часть 2. Локальный HTTPS без предупреждений браузера (через mkcert)
По умолчанию все ссылки сервера XAMPP открываются без сертификата, с префиксом http:// (не https://). Обычный самоподписанный сертификат заставляет браузеры ругаться на небезопасное соединение. Утилита mkcert создает локальный центр сертификации, которому система и браузеры доверяют автоматически.
1. Установите mkcert и утилиту для работы с хранилищем сертификатов браузеров:
sudo apt update
sudo apt install -y libnss3-tools mkcert
2. Создайте локальный корневой сертификат (делается один раз):
mkcert -install
3. Сгенерируйте сертификаты для вашего домена. Создайте папку для сертификатов в XAMPP и сгенерируйте туда ключи:
sudo mkdir -p /opt/lampp/etc/ssl/local
sudo mkcert -cert-file /opt/lampp/etc/ssl/local/mysite.local.pem -key-file \
/opt/lampp/etc/ssl/local/mysite.local-key.pem mysite.local www.mysite.local
4. Добавьте HTTPS-блок в настройки виртуальных хостов. Откройте файл виртуальных хостов:
sudo nano /opt/lampp/etc/extra/httpd-vhosts.conf
Добавьте в конец файла конфигурацию для порта 443:
< VirtualHost *:443>
DocumentRoot "/home/ваше_имя_пользователя/projects/mysite.local"
ServerName mysite.local
ServerAlias www.mysite.local
SSLEngine on
SSLCertificateFile "/opt/lampp/etc/ssl/local/mysite.local.pem"
SSLCertificateKeyFile "/opt/lampp/etc/ssl/local/mysite.local-key.pem"
< Directory "/home/ваше_имя_пользователя/projects/mysite.local">
Options Indexes FollowSymLinks ExecCGI Includes
AllowOverride All
Require all granted
< /Directory>
< /VirtualHost>
5. Перезапустите XAMPP и проверьте:
sudo /opt/lampp/lampp restart
Перезапустите браузер (чтобы он подхватил новый корневой сертификат) и откройте https://mysite.local — в адресной строке появится «замочек» без ошибок безопасности.
[Права доступа к папке htdocs для удобного редактирования файлов без sudo]
Чтобы редактировать файлы в стандартной папке /opt/lampp/htdocs без sudo, нужно передать права владельца этой директории вашему пользователю Ubuntu, сохранив при этом доступ для веб-сервера Apache.
Способ 1. Сменить владельца папки на вашего пользователя (рекомендуемый вариант)
Если вы разрабатываете локально в одиночку, самый простой и чистый вариант — сделать себя владельцем htdocs, а в качестве группы оставить daemon (от имени которого по умолчанию работает Apache).
1. Передайте права на htdocs вашему пользователю:
sudo chown -R $USER:daemon /opt/lampp/htdocs
Замечание: переменная $USER автоматически подставит имя вашей текущей учетной записи в Ubuntu).
2. Настройте права на чтение и запись (чтобы вы могли создавать/менять файлы, а Apache — читать их и записывать кэш или загрузки при необходимости):
sudo find /opt/lampp/htdocs -type d -exec chmod 775 {} +
sudo find /opt/lampp/htdocs -type f -exec chmod 664 {} +
3. Установите флаг setgid на папку htdocs. Это гарантирует, что все новые файлы и папки, которые вы создадите в будущем, автоматически унаследуют группу daemon:
sudo chmod g+s /opt/lampp/htdocs
Способ 2. Сделать символическую ссылку в домашнюю папку
Для быстрого доступа из файлового менеджера или терминала можно вывести ярлык на htdocs прямо в вашу домашнюю директорию:
ln -s /opt/lampp/htdocs ~/htdocs
Теперь вы сможете открывать папку с сайтами по короткому пути ~/htdocs в VS Code, PhpStorm или проводнике без поиска по системному разделу /opt.
Важный нюанс, если вы меняли пользователя Apache ранее. Если до этого вы в файле /opt/lampp/etc/httpd.conf меняли User daemon и Group daemon на свое имя пользователя, в первой команде используйте вашу группу вместо daemon:
sudo chown -R $USER:$USER /opt/lampp/htdocs
[Отладка PHP]
Чтобы настроить Xdebug для PHP из состава XAMPP, нужно скомпилировать расширение под встроенную версию PHP (так как в XAMPP на Linux оно не идет из коробки), прописать его в php.ini и подключить прослушивание порта 9003 в вашей IDE.
Шаг 1. Установка инструментов для сборки
Для компиляции расширения потребуются компилятор и инструменты разработки:
sudo apt update
sudo apt install -y build-essential autoconf
Шаг 2. Сборка и установка Xdebug под PHP из XAMPP
1. Узнайте точную версию PHP и путь к модулям в XAMPP:
/opt/lampp/bin/php -v
Замечание: убедитесь, что используется именно PHP из /opt/lampp/bin/.
2. Скачайте исходный код Xdebug 3 (актуальная ветка для PHP 8.x):
cd ~/Downloads
wget https://xdebug.org
tar -xvzf xdebug-3.4.1.tgz
cd xdebug-3.4.1
Замечание: если у вас установлена старая версия XAMPP с PHP 7.4, то вместо 3.4.1 скачайте xdebug-3.1.6.tgz.
3. Скомпилируйте расширение с помощью phpize из XAMPP:
/opt/lampp/bin/phpize
./configure --with-php-config=/opt/lampp/bin/php-config
make
sudo make install
После выполнения sudo make install в терминале отобразится путь, куда скопировался файл xdebug.so (обычно /opt/lampp/lib/php/extensions/no-debug-non-zts-XXXXXXXX/).
Шаг 3. Настройка php.ini в XAMPP
1. Откройте файл конфигурации PHP:
sudo nano /opt/lampp/etc/php.ini
2. Перейдите в самый конец файла (Ctrl + End или стрелками) и добавьте следующие строки:
[xdebug]
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
Замечание: параметр xdebug.start_with_request=yes запускает отладку при каждом запросе — это избавляет от необходимости ставить расширения в браузер. Если отладка замедляет работу, замените yes на trigger.
3. Сохраните файл (Ctrl + O, Enter) и перезапустите XAMPP:
sudo /opt/lampp/lampp restart
4. Проверьте, что модуль подключился (в выводе должна появиться строка with Xdebug v3...):
/opt/lampp/bin/php -v
Шаг 4. Настройка IDE
Вариант А: VS Code
1. Установите официальное расширение PHP Debug (автор: Xdebug).
2. Откройте папку вашего проекта (~/projects/mysite.local) в VS Code.
3. Перейдите на вкладку Run and Debug (Ctrl + Shift + D), нажмите create a launch.json file и выберите PHP.
4. Убедитесь, что в созданном файле .vscode/launch.json указан порт 9003:
{
"version": "0.2.0",
"configurations": [
{
"name": "Listen for Xdebug",
"type": "php",
"request": "launch",
"port": 9003
}
]
}
5. Поставьте точку останова (красную точку слева от номера строки в PHP-файле), нажмите F5 (запустится режим ожидания подключения) и обновите страницу сайта в браузере — выполнение остановится на выбранной строке.
Вариант Б: PhpStorm
1. В PhpStorm настройка почти полностью автоматическая: откройте ваш проект.
2. Перейдите в Settings (Ctrl + Alt + S) -> PHP -> Debug и убедитесь, что в блоке Xdebug указан Debug port: 9003.
3. В правом верхнем углу окна PhpStorm нажмите на иконку телефонной трубки Start Listening for PHP Debug Connections (она должна стать зеленой).
4. Поставьте точку останова в коде и обновите страницу в браузере — PhpStorm сам перехватит запрос и предложит сопоставить пути к файлам (нажмите Accept).