Настройка SSL-сертификата на PHP-сервере с Let's Encrypt
HTTPS давно стал базовым требованием для сайтов на PHP: он защищает авторизацию, формы, cookies и обмен данными между браузером и сервером. Бесплатный центр сертификации Let's Encrypt позволяет получить доверенный SSL-сертификат без покупки лицензии и автоматизировать его продление.
Настройка обычно выполняется на уровне веб-сервера Apache или Nginx, а не внутри самого PHP. При этом приложению важно корректно определять защищённое соединение, формировать HTTPS-ссылки и передавать серверу необходимые заголовки. Ниже приведён практический сценарий для Linux-сервера с доменным именем и доступом по SSH.
Что проверить перед установкой
Сначала домен должен указывать на публичный IP-адрес сервера. Записи A и, при необходимости, AAAA проверяют через DNS-инструменты или команду dig. Если IPv6 настроен неправильно, центр сертификации может обратиться к серверу по адресу AAAA и завершить проверку ошибкой. В таком случае IPv6 нужно корректно настроить либо временно удалить соответствующую запись.
Сервер должен принимать входящие соединения на портах 80 и 443. Порт 80 нужен для первоначальной проверки домена и последующего перенаправления на HTTPS, а порт 443 используется для защищённого трафика. В брандмауэре обычно открывают HTTP и HTTPS командами, зависящими от дистрибутива, например:
sudo ufw allow 'Nginx Full'
Для Apache следует выбрать профиль Apache Full. До выпуска сертификата полезно убедиться, что сайт уже открывается по обычному HTTP, а виртуальный хост содержит правильный server_name или ServerName. Если приложение размещено в каталоге вроде /var/www/example.com/public, путь к нему должен совпадать с настройкой веб-сервера.
Установка Certbot и выпуск сертификата
Certbot — клиент ACME, который обращается к Let's Encrypt, подтверждает контроль над доменом и устанавливает полученные файлы сертификата. На современных Ubuntu чаще всего используют пакет из Snap, поскольку он содержит актуальную версию клиента:
sudo snap install core
sudo snap refresh core
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot
Для Apache можно сразу запустить автоматическую настройку виртуального хоста:
sudo certbot --apache -d example.com -d www.example.com
Для Nginx команда будет выглядеть так:
sudo certbot --nginx -d example.com -d www.example.com
Certbot предложит указать электронную почту, принять условия использования и выбрать поведение для HTTP-запросов. Рекомендуемый вариант — постоянное перенаправление на HTTPS. Если автоматическое изменение конфигурации нежелательно, сертификат можно получить отдельно через certbot certonly, а пути к файлам прописать вручную.
При успешной проверке файлы обычно сохраняются в каталоге /etc/letsencrypt/live/example.com/. Основные из них — fullchain.pem, содержащий сертификат вместе с цепочкой доверия, и privkey.pem, содержащий закрытый ключ. Права доступа к ключу должны оставаться ограниченными: его нельзя размещать в каталоге сайта или открывать для чтения обычным пользователям.
Подключение HTTPS в конфигурации PHP-сервера
При ручной настройке Nginx HTTPS-сервер обычно содержит такие параметры:
server {
listen 443 ssl http2;
server_name example.com www.example.com;
root /var/www/example.com/public;
index index.php index.html;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}
}
Отдельный HTTP-блок перенаправляет посетителей на защищённый адрес:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
После изменений конфигурацию проверяют до перезагрузки:
sudo nginx -t
sudo systemctl reload nginx
В Apache используются директивы SSLEngine on, SSLCertificateFile и SSLCertificateKeyFile, а перенаправление выполняется через модуль mod_rewrite или отдельный SSL-виртуальный хост. Не следует одновременно оставлять несколько противоречащих друг другу правил редиректа в .htaccess, конфигурации Apache и PHP-коде: это часто приводит к циклическим перенаправлениям.
Приложение должно понимать, что запрос пришёл по HTTPS. Для PHP за прокси или балансировщиком проверяют заголовок X-Forwarded-Proto, но доверять ему следует только от известного прокси. Иначе злоумышленник сможет подменить значение. В Laravel, Symfony и других фреймворках это настраивается через доверенные прокси и параметры URL-схемы.
Проверка работы и устранение типичных ошибок
После установки сертификата страницу проверяют в браузере, через curl и внешние анализаторы TLS. Команда покажет заголовки ответа и цепочку перенаправлений:
curl -I http://example.com
curl -I https://example.com
Ожидаемый результат — один редирект с HTTP на HTTPS и ответ сайта по защищённой схеме. Если браузер показывает смешанное содержимое, в HTML, CSS, JavaScript или настройках CMS остались ссылки вида http://. Их заменяют на относительные пути, HTTPS-адреса или используют безопасную настройку базового URL.
Ошибка connection refused обычно связана с закрытым портом, остановленным веб-сервером или неправильной записью DNS. Ошибка unauthorized при выпуске сертификата часто означает, что домен не указывает на этот сервер, каталог проверки недоступен или другой виртуальный хост перехватывает запросы к /.well-known/acme-challenge/.
Для PHP-сайта важно проверить cookies с флагами Secure и HttpOnly, корректную генерацию абсолютных ссылок и работу callback-адресов. Если приложение получает данные из внешних API или подключается к базам данных, HTTPS веб-сайта не заменяет шифрование этих соединений. Например, вопросы удалённого доступа к MySQL из приложений Delphi рассматриваются в материале о подключению MySQL через ODBC, где отдельно важны сетевые и серверные настройки.
Продление сертификата и безопасная эксплуатация
Сертификаты Let's Encrypt действуют 90 дней, поэтому ручное обновление неудобно и повышает риск простоя. В большинстве установок Certbot создаёт системный таймер. Его состояние проверяют так:
sudo systemctl status snap.certbot.renew.service
sudo certbot renew --dry-run
Тестовый запуск не заменяет реальное продление, но показывает, сможет ли клиент пройти проверку в будущем. После обновления сертификата веб-сервер иногда требуется перезагрузить, особенно если процесс держит старый сертификат в памяти. Это можно оформить hook-командой:
sudo certbot renew --deploy-hook "systemctl reload nginx"
Для Apache вместо Nginx указывают systemctl reload apache2. Журнал Certbot находится в /var/log/letsencrypt/, а журналы веб-сервера помогают определить причины ошибок ACME, отказов PHP-FPM и неожиданных редиректов.
| Компонент | Что настраивается | Как проверить |
|---|---|---|
| DNS | Записи A и AAAA домена | dig example.com |
| Брандмауэр | Открытые порты 80 и 443 | sudo ufw status |
| Let's Encrypt | Выпуск и обновление сертификата | sudo certbot renew --dry-run |
| Nginx или Apache | Сертификат, ключ, HTTPS-виртуальный хост | Тест конфигурации |
| PHP-приложение | Схема HTTPS, cookies, абсолютные ссылки | Проверка страниц и форм |
| Безопасность | Ограниченные права на privkey.pem |
ls -l /etc/letsencrypt/live/ |
Регулярно обновлять следует сам сервер, PHP, веб-сервер и Certbot. Закрытый ключ нельзя передавать в репозиторий, резервные копии нужно защищать, а доступ по SSH — ограничивать ключами и правилами брандмауэра. Для проверки внешних демонстрационных страниц и веб-инструментов можно использовать тематический каталог веб-ресурсов, однако итоговую диагностику собственного домена всегда выполняют с учётом его DNS, прокси и конфигурации PHP-сервера.