Проверка конфига apache на ошибки

С помощью опции -t вы можете проверить правильность конфигурации веб-сервера без запуска Apache:

c:ServerbinApache24binhttpd.exe -t

Пример вывода:

Syntax OK

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

Кроме проверки дефолтного конфигурационного файла можно проверить файл настроек расположенной в любом месте в системе. Для этого используйте опцию -f, после которой укажите файл для проверки:

c:ServerbinApache24binhttpd.exe -f c:ServerbinApache24conftest_httpd.conf -t

Пример вывода, если в конфигурации обнаружена ошибка:

AH00526: Syntax error on line 60 of C:/Server/bin/Apache24/conf/test_httpd.conf:
Invalid command 'Lis7ten', perhaps misspelled or defined by a module not included in the server configuration

Как узнать, какие конфигурационные файлы использует Apache

Чтобы узнать, какой файл настроек использует Apache, а также где находится конфигурационный файл Apache, используйте сочетание опций -t -D DUMP_INCLUDES:

c:ServerbinApache24binhttpd.exe -t -D DUMP_INCLUDES

Пример вывода:

Included configuration files:
  (*) C:/Server/bin/Apache24/conf/httpd.conf

Как узнать все виртуальные хосты на сервере

Для показа всех настроенных на сервере виртуальных хостов Apache, запустите с опцией -t -D DUMP_VHOSTS:

c:ServerbinApache24binhttpd.exe -t -D DUMP_VHOSTS

Как узнать, с какими настройками запущен Apache

Для показа всех значений директив веб-сервера, запустите его с опциями -t -D DUMP_RUN_CFG:

c:ServerbinApache24binhttpd.exe -t -D DUMP_RUN_CFG

Пример вывода:

ServerRoot: "C:/Server/bin/Apache24"
Main DocumentRoot: "C:/Server/data/htdocs/"
Main ErrorLog: "C:/Server/bin/Apache24/logs/error.log"
Mutex default: dir="C:/Server/bin/Apache24/logs/" mechanism=default
Mutex rewrite-map: using_defaults
PidFile: "C:/Server/bin/Apache24/logs/httpd.pid"
Define: DUMP_RUN_CFG
Define: SRVROOT=c:/Server/bin/Apache24

Кстати, можно использовать опцию -S, которая является сокращением для сочетаний -t -D DUMP_VHOSTS -D DUMP_RUN_CFG.

Как узнать все загруженные модули Apache

Чтобы вывести список модулей веб-сервера (например, чтобы узнать, подхватились ли настройки включающие PHP модуль) запустите программу с опциями -t -D DUMP_MODULES:

c:ServerbinApache24binhttpd.exe -t -D DUMP_MODULES

Пример вывода:

Loaded Modules:
 core_module (static)
 win32_module (static)
 mpm_winnt_module (static)
 http_module (static)
 so_module (static)
 access_compat_module (shared)
 actions_module (shared)
 alias_module (shared)
 allowmethods_module (shared)
 asis_module (shared)
 auth_basic_module (shared)
 authn_core_module (shared)
 authn_file_module (shared)
 authz_core_module (shared)
 authz_groupfile_module (shared)
 authz_host_module (shared)
 authz_user_module (shared)
 autoindex_module (shared)
 cgi_module (shared)
 dir_module (shared)
 env_module (shared)
 include_module (shared)
 isapi_module (shared)
 log_config_module (shared)
 mime_module (shared)
 negotiation_module (shared)
 rewrite_module (shared)
 setenvif_module (shared)
 php7_module (shared)

Вместо длинной записи -t -D DUMP_MODULES можно использовать сокращение -M.

Как узнать настройки, с которыми скомпилирован Apache

При компиляции веб-сервера Apache устанавливаются некоторые параметры, в том числе значение некоторых настроек по умолчанию. Чтобы увидеть их все, используйте опцию -V:

c:ServerbinApache24binhttpd.exe -V

Пример вывода:

Server version: Apache/2.4.39 (Win64)
Apache Lounge VC15 Server built:   May 29 2019 11:22:50
Server's Module Magic Number: 20120211:84
Server loaded:  APR 1.7.0, APR-UTIL 1.6.1
Compiled using: APR 1.7.0, APR-UTIL 1.6.1
Architecture:   64-bit
Server MPM:     WinNT
  threaded:     yes (fixed thread count)
    forked:     no
Server compiled with....
 -D APR_HAS_SENDFILE
 -D APR_HAS_MMAP
 -D APR_HAVE_IPV6 (IPv4-mapped addresses disabled)
 -D APR_HAS_OTHER_CHILD
 -D AP_HAVE_RELIABLE_PIPED_LOGS
 -D DYNAMIC_MODULE_LIMIT=256
 -D HTTPD_ROOT="/apache"
 -D SUEXEC_BIN="/apache/bin/suexec"
 -D DEFAULT_PIDLOG="logs/httpd.pid"
 -D DEFAULT_SCOREBOARD="logs/apache_runtime_status"
 -D DEFAULT_ERRORLOG="logs/error.log"
 -D AP_TYPES_CONFIG_FILE="conf/mime.types"
 -D SERVER_CONFIG_FILE="conf/httpd.conf"

Как узнать скомпилированные модули Apache

Для показа скомпилированных модулей Apache сделайте запуск с опцией -l:

c:ServerbinApache24binhttpd.exe -l

Пример вывода:

Compiled in modules:
  core.c
  mod_win32.c
  mpm_winnt.c
  http_core.c
  mod_so.c

HTTP-сервер Apache — самый популярный веб-сервер в мире. Это бесплатный кроссплатформенный HTTP-сервер с открытым исходным кодом, обеспечивающий мощные функции, которые могут быть расширены с помощью самых разных модулей.

Если вы разработчик или системный администратор, скорее всего, вы регулярно имеете дело с Apache.

В этом руководстве мы рассмотрим наиболее важные и часто используемые команды Apache, включая запуск, остановку и перезапуск Apache.

Подготовка

Мы предполагаем, что вы вошли в систему как root или пользователь с привилегиями sudo. Команды в этом руководстве должны работать в любом современном дистрибутиве Linux, таком как Ubuntu 18.04, CentOS 7 и Debian 9 .

В Ubuntu и Debian служба Apache называется apache2 , тогда как в системе на основе Red Hat, такой как CentOS, имя службы Apache — httpd .

Если вы используете CentOS, просто замените apache2 на httpd в приведенных ниже командах.

Запустите Apache

Запустить Apache довольно просто. Просто введите следующую команду.

sudo systemctl start apache2

В случае успеха команда не производит никакого вывода.

Если вы используете более старый дистрибутив Linux без systemd, для запуска Apache введите:

sudo service apache2 start

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

sudo systemctl enable apache2

Остановить Apache

Остановка Apache позволяет быстро завершить основной процесс Apache и все дочерние процессы, даже если есть открытые соединения.

Чтобы остановить Apache, выполните одну из следующих команд:

sudo systemctl stop apache2sudo service apache2 stop

Перезагрузите Apache

Параметр перезапуска — это быстрый способ остановить, а затем запустить сервер Apache.

Используйте одну из следующих команд для перезапуска:

sudo systemctl restart apache2sudo service apache2 restart

Это команда, которую вы, вероятно, будете использовать наиболее часто.

Перезагрузить Apache

Вам необходимо перезагрузить или перезапустить Apache всякий раз, когда вы вносите изменения в его конфигурацию.

При перезагрузке основной процесс apache завершает работу дочерних процессов, загружает новую конфигурацию и запускает новые дочерние процессы.

Чтобы перезагрузить Apache, используйте одну из следующих команд:

sudo systemctl reload apache2sudo service apache2 reload

Проверить конфигурацию Apache

Каждый раз, когда вы вносите изменения в файл конфигурации сервера Apache, рекомендуется протестировать конфигурацию перед перезапуском или перезагрузкой службы.

Используйте следующую команду, чтобы проверить конфигурацию Apache на наличие синтаксических или системных ошибок:

sudo apachectl -t

Результат будет выглядеть так:

Syntax OK

Если есть ошибки, команда выводит подробное сообщение.

Просмотр статуса Apache

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

sudo systemctl status apache2

Результат будет выглядеть примерно так:

● apache2.service - The Apache HTTP Server
   Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: 
  Drop-In: /lib/systemd/system/apache2.service.d
           └─apache2-systemd.conf
   Active: active (running) since Wed 2019-05-29 21:16:55 UTC; 6s ago
  Process: 938 ExecStop=/usr/sbin/apachectl stop (code=exited, status=0/SUCCESS)
  Process: 956 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCES
 Main PID: 997 (apache2)
    Tasks: 55 (limit: 1152)
   CGroup: /system.slice/apache2.service
           ├─ 997 /usr/sbin/apache2 -k start
           ├─ 999 /usr/sbin/apache2 -k start
           └─1000 /usr/sbin/apache2 -k start

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

Иногда вам может потребоваться узнать версию вашего Apache, чтобы вы могли отладить проблему или определить, доступна ли определенная функция.

Вы можете проверить свою версию Apache, запустив:

sudo apache2 -v

Server version: Apache/2.4.29 (Ubuntu)
Server built:   2019-04-03T13:22:37

Параметр -V (верхний регистр) показывает версию Apache вместе с параметром конфигурации.

sudo apache2 -V

Выводы

В этом руководстве мы показали вам некоторые из наиболее важных команд Apache. Если вы хотите узнать больше о командной строке Apache, посетите документацию Apache.

Если у вас есть какие-либо вопросы или отзывы, не стесняйтесь оставлять комментарии.

After making changes to the Apache configuration file, testing the configuration before implementing it is a good practice.

To test the Apache configuration file for errors, use the following command:

apachectl configtest

If the configuration file is fine, this command will return Syntax Ok. Otherwise, it will return detailed information about the error discovered.

If apachectl is not in your PATH and you do not know where it is, refer to the tech recipe Find a file by name to find the location of apachectl, then run it with the fully qualified path. Note the following example:

/usr/local/apache/bin/apachectl configtest