Практичний гайд з установки та оновлення до PHP 8.5 на Debian та Ubuntu за підходом Ayesh Karunaratne

Матеріал розбирає покроковий підхід Ayesh Karunaratne до установки PHP 8.5 на Debian, Ubuntu та похідні дистрибутиви за допомогою готових пакетів з репозиторію Ondřej Surý. Далі — структурована інструкція з коментарями та типові місця, де адміністратори найчастіше помиляються.

1. Що змінюється при переході на PHP 8.5

Автор описує PHP 8.5 як реліз з помітними покращеннями продуктивності, новим синтаксисом Pipe та новими розширеннями, але без радикальних ламких змін порівняно з PHP 8.4.

PHP 8.5 сумісний з 8.4 для більшості застосунків, але вводить нові директиви та змінює статус деяких розширень.
Жодних розширень не вилучено та не розпаковано з ядра порівняно з 8.4 — це важливо для стабільності legacy-проєктів.
opcache більше не вважається «додатковим» — він завжди вбудований. Окремого пакета на кшталт php8.5-opcache не буде, але опкеш можна вимкнути налаштуваннями.
Додаються два нові core-розширення: uri та lexbor — вони завжди присутні в збірці.
Нова директива max_memory_limit обмежує максимальне значення memory_limit, якщо її увімкнути. За замовчуванням вона вимкнена.
Опція CLI php -z остаточно видалена — вона й раніше не працювала коректно, і є сумісні альтернативи завантаження модулів.
INI-директиву disable_classes видалено.

За даними автора, PHP 8.5 отримуватиме оновлення безпеки загалом протягом 4 років, з яких перші 2 роки включають також виправлення помилок. Перед будь-яким оновленням автор наполягає на обов'язковому резервному копіюванні — описані кроки зазвичай не видаляють файли, але помилки конфігурації або скрипти після оновлення можуть зламати продакшн.

2. Фіксуємо поточну PHP-конфігурацію перед оновленням

Якщо ви оновлюєте існуючу інсталяцію, перший практичний крок у підході автора — зібрати інформацію про те, які розширення та пакети PHP вже встановлені. Це дозволить віддзеркалити їх у PHP 8.5.

2.1. Зберегти список увімкнених розширень (`php -m`)

Команда php -m показує всі завантажені розширення поточної версії PHP. Автор пропонує одночасно вивести їх на екран і зберегти в файл:

php -m | tee php-m-output.txt

Файл php-m-output.txt надалі допоможе перевірити, чи всі потрібні модулі активовані після переходу на PHP 8.5.

2.2. Зафіксувати встановлені пакети PHP через dpkg

Щоб відновити не тільки активні модулі, а й самі пакети, автор використовує dpkg -l з фільтром по назві:

dpkg -l | grep php | tee dpkg-l-output.txt

У результаті ви отримуєте dpkg-l-output.txt з усіма пакетами, що містять php у назві. Пізніше зручно замінювати шаблон phpX.Y-* на php8.5-*, орієнтуючись саме на цей список.

3. Додаємо репозиторій Ondřej Surý з PHP 8.5

Ключова особливість підходу автора — використання не стандартних репозиторіїв дистрибутива, а відомого стороннього репозиторію Ondřej Surý, який багато років є де-факто стандартом для PHP на Debian/Ubuntu.

За станом на Ubuntu 24.10 PHP 8.5 ще не постачається «з коробки», тому без цього кроку apt просто не знайде потрібні пакети.

3.1. Ubuntu — підключення PPA `ondrej/php`

Автор використовує класичну схему через add-apt-repository з виставленою локаллю, щоб уникнути проблем з кодуванням:

sudo LC_ALL=C.UTF-8 add-apt-repository ppa:ondrej/php # Press enter to confirm.
sudo apt update

Після цього apt update підтягне списки пакетів з нового джерела.

3.2. Debian — налаштування DPA з підписаним репозиторієм

Для Debian описаний трохи довший процес: потрібно встановити базові утиліти, завантажити та встановити keyring і додати окремий файл у /etc/apt/sources.list.d/:

sudo apt-get update
sudo apt-get -y install lsb-release ca-certificates curl apt-transport-https

# Download and add the signing key
sudo curl -sSLo /tmp/debsuryorg-archive-keyring.deb https://packages.sury.org/debsuryorg-archive-keyring.deb
sudo dpkg -i /tmp/debsuryorg-archive-keyring.deb
sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'
sudo apt-get update

Важливий момент — використання signed-by=/usr/share/keyrings/deb.sury.org-php.gpg у записі репозиторію, що прив'язує пакети до конкретного ключа. Це стандартна сучасна практика для безпечного додавання сторонніх джерел.

4. Установка PHP 8.5 і розширень

Після додавання репозиторію всі подальші дії виконуються звичайними командами apt install. Всі пакети PHP 8.5 мають префікс php8.5-, тому можуть співіснувати з іншими гілками PHP.

4.1. Установка CLI-двійкового файлу PHP 8.5

Базовий крок — встановити CLI-версію:

1. Що змінюється при переході на PHP 8.5

2. Фіксуємо поточну PHP-конфігурацію перед оновленням

2.1. Зберегти список увімкнених розширень (php -m)

2.2. Зафіксувати встановлені пакети PHP через dpkg

3. Додаємо репозиторій Ondřej Surý з PHP 8.5

3.1. Ubuntu — підключення PPA ondrej/php

3.2. Debian — налаштування DPA з підписаним репозиторієм

4. Установка PHP 8.5 і розширень

4.1. Установка CLI-двійкового файлу PHP 8.5

4.2. Установка типових розширень

5. Налаштування PHP-FPM і інтеграція з веб-сервером

5.1. Установка PHP-FPM 8.5

5.2. Прив'язка до Apache, Nginx та Caddy

6. Додаткові розширення та інструменти розробки

6.1. Інструменти налагодження та покриття коду

7. Міграція конфігурації з попередніх версій PHP

8. Видалення старих версій PHP після успішної міграції

9. Запуск PHP 8.5 поруч з іншими версіями

10. Короткий повтор ключових кроків з посиланнями

Статті по темі

2.1. Зберегти список увімкнених розширень (`php -m`)

3.1. Ubuntu — підключення PPA `ondrej/php`