Производительность

Данная инструкция содержит рекомендации по настройке PHP 8.4 и PostgreSQL 18 для повышения производительности iEXExchanger.

Настройки предназначены для проектов, работающих на FastPanel. Готовые профили позволяют подобрать значения по мощности сервера без ручного расчёта каждого параметра.

Не выбирайте профиль выше фактических характеристик сервера. Завышенные значения могут привести к нехватке оперативной памяти и нестабильной работе PHP-FPM или PostgreSQL.

Где находятся настройки

1

Настройки PHP

Откройте FastPanel: «Управление» — «PHP»

Выберите используемую версию:

PHP 8.4

Затем откройте настройки переменных PHP.

Параметры также можно изменить отдельно для Backend-сайта. Для этого откройте карточку:

app.ВАШ_ДОМЕН

Перейдите в раздел «Настройки PHP».

2

Настройки PostgreSQL

Откройте FastPanel: «Настройки» — «Базы данных»

Затем перейдите в «Серверы баз данных».

Выберите локальный сервер:

PostgreSQL 18 local

Нажмите «Настроить переменные».

Изменение переменных через FastPanel доступно только для локального сервера PostgreSQL. Для внешнего сервера параметры настраиваются непосредственно на сервере базы данных.

---

Как выбрать профиль

Профиль	Характеристики сервера
Минимальный	2 vCPU, 4 ГБ ОЗУ
Рекомендуемый	4 vCPU, 8 ГБ ОЗУ
Высокая производительность	8 vCPU, 16 ГБ ОЗУ
Максимальная производительность	от 16 vCPU, от 32 ГБ ОЗУ

Если сервер имеет промежуточный объём памяти, используйте ближайший меньший профиль.

Например, для сервера с 12 ГБ ОЗУ сначала используйте профиль на 8 ГБ. После проверки работы отдельные параметры можно увеличить.

Профиль «Минимальный»

Подходит для:

• тестовых проектов;
• небольших обменников;
• проектов с низкой нагрузкой;
• серверов без большого количества заявок и посетителей.

1

Сервер

2 vCPU
4 ГБ ОЗУ
40 ГБ NVMe SSD
PHP 8.4
PostgreSQL 18

Сервер с 4 ГБ ОЗУ рекомендуется использовать только для тестирования или небольшой нагрузки.

2

PHP 8.4

memory_limit=512M

post_max_size=220M
upload_max_filesize=200M

max_execution_time=60
max_input_time=60

max_input_vars=10000

realpath_cache_size=4096K
realpath_cache_ttl=600

opcache.enable=1
opcache.memory_consumption=128
opcache.interned_strings_buffer=16
opcache.max_accelerated_files=20000
opcache.max_wasted_percentage=10
opcache.save_comments=1

opcache.validate_timestamps=1
opcache.revalidate_freq=2

opcache.jit=off
opcache.jit_buffer_size=0

3

PostgreSQL 18

shared_buffers = '512MB'
effective_cache_size = '1536MB'

work_mem = '4MB'
maintenance_work_mem = '128MB'
autovacuum_work_mem = '64MB'

max_connections = 50

min_wal_size = '512MB'
max_wal_size = '2GB'

checkpoint_completion_target = 0.9
wal_compression = on

autovacuum = on

Профиль «Рекомендуемый»

Подходит большинству проектов iEXExchanger.

Профиль обеспечивает нормальный запас ресурсов для PHP, PostgreSQL и операционной системы без чрезмерного потребления памяти.

1

Сервер

4 vCPU
8 ГБ ОЗУ
80 ГБ NVMe SSD
PHP 8.4
PostgreSQL 18

2

PHP 8.4

memory_limit=768M

post_max_size=220M
upload_max_filesize=200M

max_execution_time=120
max_input_time=120

max_input_vars=20000

realpath_cache_size=8192K
realpath_cache_ttl=600

opcache.enable=1
opcache.memory_consumption=256
opcache.interned_strings_buffer=32
opcache.max_accelerated_files=50000
opcache.max_wasted_percentage=10
opcache.save_comments=1

opcache.validate_timestamps=1
opcache.revalidate_freq=2

opcache.jit=off
opcache.jit_buffer_size=0

3

PostgreSQL 18

shared_buffers = '1GB'
effective_cache_size = '3GB'

work_mem = '4MB'
maintenance_work_mem = '256MB'
autovacuum_work_mem = '128MB'

max_connections = 75

min_wal_size = '1GB'
max_wal_size = '4GB'

checkpoint_completion_target = 0.9
wal_compression = on

autovacuum = on

Профиль «Высокая производительность»

Подходит для:

• крупных обменников;
• большого количества направлений;
• активной работы административной панели;
• большого количества одновременных заявок;
• высокой нагрузки на API и базу данных.

1

Сервер

8 vCPU
16 ГБ ОЗУ
160 ГБ NVMe SSD
PHP 8.4
PostgreSQL 18

2

PHP 8.4

memory_limit=1024M

post_max_size=520M
upload_max_filesize=500M

max_execution_time=180
max_input_time=180

max_input_vars=30000

realpath_cache_size=16384K
realpath_cache_ttl=600

opcache.enable=1
opcache.memory_consumption=512
opcache.interned_strings_buffer=64
opcache.max_accelerated_files=100000
opcache.max_wasted_percentage=10
opcache.save_comments=1

opcache.validate_timestamps=1
opcache.revalidate_freq=2

opcache.jit=off
opcache.jit_buffer_size=0

3

PostgreSQL 18

shared_buffers = '3GB'
effective_cache_size = '8GB'

work_mem = '8MB'
maintenance_work_mem = '512MB'
autovacuum_work_mem = '256MB'

max_connections = 100

min_wal_size = '1GB'
max_wal_size = '8GB'

checkpoint_completion_target = 0.9
wal_compression = on

autovacuum = on

Профиль «Максимальная производительность»

Подходит для проектов с очень высокой нагрузкой.

Используйте этот профиль только на сервере с достаточным количеством оперативной памяти, производительным процессором и Enterprise NVMe.

1

Сервер

16+ vCPU
32+ ГБ ОЗУ
Enterprise NVMe SSD
PHP 8.4
PostgreSQL 18

2

PHP 8.4

memory_limit=1536M

post_max_size=1050M
upload_max_filesize=1000M

max_execution_time=300
max_input_time=300

max_input_vars=50000

realpath_cache_size=32768K
realpath_cache_ttl=600

opcache.enable=1
opcache.memory_consumption=512
opcache.interned_strings_buffer=64
opcache.max_accelerated_files=100000
opcache.max_wasted_percentage=10
opcache.save_comments=1

opcache.validate_timestamps=1
opcache.revalidate_freq=2

opcache.jit=off
opcache.jit_buffer_size=0

3

PostgreSQL 18

shared_buffers = '6GB'
effective_cache_size = '18GB'

work_mem = '16MB'
maintenance_work_mem = '1GB'
autovacuum_work_mem = '512MB'

max_connections = 150

min_wal_size = '2GB'
max_wal_size = '12GB'

checkpoint_completion_target = 0.9
wal_compression = on

autovacuum = on

---

Что означают настройки PHP

memory_limit

Ограничивает максимальную память одного PHP-скрипта.

Пример:

memory_limit=768M

Параметр не ускоряет PHP напрямую. Он разрешает выполнять операции, которым требуется больше памяти.

Не используйте на рабочем сервере:

memory_limit=-1

PHP должен иметь ограничение памяти.

post_max_size

Ограничивает общий размер POST-запроса.

Значение должно быть больше upload_max_filesize.

Пример:

post_max_size=220M
upload_max_filesize=200M

upload_max_filesize

Ограничивает размер одного загружаемого файла.

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

max_execution_time

Ограничивает время выполнения одного веб-запроса.

Пример:

max_execution_time=120

Увеличение параметра не делает запрос быстрее. Оно только разрешает ему выполняться дольше.

max_input_vars

Определяет максимальное количество переменных, которые PHP может принять из формы.

Для административной панели рекомендуется значение от:

10000

до:

50000

в зависимости от выбранного профиля.

realpath_cache_size

Хранит результаты определения путей к PHP-файлам.

iEXExchanger использует большое количество PHP-классов, поэтому realpath-кеш уменьшает количество повторных обращений к файловой системе.

opcache.memory_consumption

Определяет объём оперативной памяти для хранения скомпилированного PHP-кода.

Пример:

opcache.memory_consumption=256

Память OPcache не нужно увеличивать вместе с memory_limit. Если весь PHP-код помещается в кеш, дальнейшее увеличение не даст заметного ускорения.

opcache.max_accelerated_files

Определяет максимальное количество PHP-файлов, которые могут находиться в OPcache.

Для большинства проектов достаточно:

opcache.max_accelerated_files=50000

Для крупного проекта:

opcache.max_accelerated_files=100000

Режимы OPcache

1

Безопасный режим

Во всех основных профилях используется:

opcache.validate_timestamps=1
opcache.revalidate_freq=2

PHP проверяет изменения файлов каждые две секунды. После обновления новая версия кода начинает использоваться автоматически.

Этот режим рекомендуется большинству клиентов.

2

Максимальная производительность

Если после каждого обновления гарантированно перезапускается PHP-FPM, можно использовать:

opcache.validate_timestamps=0
opcache.revalidate_freq=0

PHP перестанет проверять изменения файлов при обработке запросов.

При отключённой проверке файлов после каждого обновления обязательно перезапускайте PHP-FPM. Иначе сервер может продолжить выполнять предыдущую версию PHP-кода.

3

JIT

Для обычной работы iEXExchanger рекомендуется оставить JIT выключенным:

opcache.jit=off
opcache.jit_buffer_size=0

Включение JIT не гарантирует ускорение Laravel-приложения и дополнительно использует оперативную память.

Что означают настройки PostgreSQL

shared_buffers

Определяет объём памяти собственного кеша PostgreSQL.

Пример:

shared_buffers = '1GB'

Чем больше данных находится в кеше, тем реже PostgreSQL обращается к диску.

Передавать PostgreSQL большую часть оперативной памяти не нужно. База также использует файловый кеш операционной системы.

effective_cache_size

Сообщает планировщику PostgreSQL, какой объём кеша предположительно доступен.

Пример:

effective_cache_size = '3GB'

Параметр не резервирует указанный объём памяти. Он влияет только на выбор плана выполнения запросов.

work_mem

Ограничивает память одной операции сортировки или хеширования.

Пример:

work_mem = '8MB'

Один запрос может одновременно выполнять несколько таких операций. Несколько подключений также могут использовать work_mem одновременно.

Не устанавливайте глобально:

work_mem = '128MB'

без предварительного расчёта.

maintenance_work_mem

Используется при:

• создании индексов;
• выполнении VACUUM;
• добавлении внешних ключей;
• обслуживании таблиц.

Пример:

maintenance_work_mem = '512MB'

autovacuum_work_mem

Ограничивает память одного процесса autovacuum.

Пример:

autovacuum_work_mem = '256MB'

Если одновременно работают несколько процессов autovacuum, каждый из них может использовать память отдельно.

max_connections

Ограничивает количество одновременных подключений к PostgreSQL.

Пример:

max_connections = 100

Большое значение не ускоряет базу. Каждое подключение использует оперативную память, поэтому лимит должен соответствовать мощности сервера.

min_wal_size и max_wal_size

Определяют объём журнала WAL, который PostgreSQL хранит и использует между контрольными точками.

Пример:

min_wal_size = '1GB'
max_wal_size = '4GB'

Увеличение max_wal_size помогает распределить дисковую нагрузку, но требует свободного места на диске.

checkpoint_completion_target

Значение:

checkpoint_completion_target = 0.9

распределяет запись контрольной точки по большей части доступного интервала и уменьшает резкие пики дисковой нагрузки.

wal_compression

Значение:

wal_compression = on

уменьшает объём части данных, записываемых в WAL. Это снижает дисковую нагрузку, но немного увеличивает использование процессора.

Обязательные параметры PostgreSQL

Следующие параметры должны оставаться включёнными:

fsync = on
full_page_writes = on
synchronous_commit = on
autovacuum = on

Не отключайте их ради дополнительной скорости.

Отключение fsync, full_page_writes или synchronous_commit может привести к потере подтверждённых данных после сбоя сервера.

Нужно ли переводить значения в байты

PostgreSQL принимает значения с единицами измерения:

512MB
1GB
8GB

Используйте значения в том виде, в котором они указаны в профилях.

Переводить их в байты не требуется.

Если FastPanel не позволяет сохранить переменные

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

Подключитесь к серверу по SSH и выполните:

Подключение к серверу по SSH

sudo -u postgres psql -X -d postgres <<'SQL'
GRANT pg_read_all_settings TO fastuser;

GRANT ALTER SYSTEM ON PARAMETER
    shared_buffers,
    effective_cache_size,
    work_mem,
    maintenance_work_mem,
    autovacuum_work_mem,
    max_connections,
    min_wal_size,
    max_wal_size,
    checkpoint_completion_target,
    wal_compression,
    autovacuum
TO fastuser;

GRANT EXECUTE
ON FUNCTION pg_catalog.pg_reload_conf()
TO fastuser;
SQL

Роль fastuser используется только для подключения FastPanel к PostgreSQL.

Не назначайте fastuser суперпользователем и не используйте эту роль для подключения iEXExchanger к базе данных.

Как применить настройки PHP

После изменения параметров нажмите «Сохранить».

Затем откройте: «Настройки» — «Сервисы»

Найдите PHP-FPM 8.4 и выполните перезапуск.

После этого новые параметры начнут использоваться сайтом.

Как применить настройки PostgreSQL

После сохранения переменных проверьте, требуется ли перезапуск:

sudo -u postgres psql -X -d postgres -c "
SELECT
    name,
    setting,
    pending_restart
FROM pg_settings
WHERE pending_restart = true
ORDER BY name;
"

Параметры shared_buffers и max_connections требуют полного перезапуска PostgreSQL.

Выполните:

pg_ctlcluster 18 main restart

Проверьте доступность:

pg_isready -h 127.0.0.1 -p 5432

Ожидаемый результат:

127.0.0.1:5432 - accepting connections

Проверка настроек PHP

Проверьте основные значения:

/opt/php84/bin/php -i | grep -E \
'memory_limit|post_max_size|upload_max_filesize|max_execution_time|realpath_cache|opcache.memory_consumption'

Если параметры настроены отдельно для Backend-сайта, значения PHP-FPM могут отличаться от настроек PHP в командной строке.

Проверка настроек PostgreSQL

Выполните:

sudo -u postgres psql -X -d postgres -P pager=off -c "
SELECT
    name,
    setting,
    unit,
    source,
    pending_restart
FROM pg_settings
WHERE name IN (
    'shared_buffers',
    'effective_cache_size',
    'work_mem',
    'maintenance_work_mem',
    'autovacuum_work_mem',
    'max_connections',
    'min_wal_size',
    'max_wal_size',
    'checkpoint_completion_target',
    'wal_compression',
    'autovacuum'
)
ORDER BY name;
"

После перезапуска в поле pending_restart должно отображаться:

false

Частые ошибки

Сайт показывает 502 после изменения PHP

Почему возникает

PHP-FPM не запустился или указано недопустимое значение.

Что проверить

Откройте:

«Настройки» — «Сервисы»

Проверьте состояние PHP-FPM 8.4.

Как исправить

Верните предыдущее значение и повторно запустите PHP-FPM.

PHP не принимает большой файл

Почему возникает

post_max_size меньше upload_max_filesize.

Как исправить

Например, для файла до 200 МБ используйте:

post_max_size=220M
upload_max_filesize=200M

Изменения PHP не применились

Почему возникает

Не был перезапущен PHP-FPM или изменения внесены для другой версии PHP.

Как исправить

Проверьте, что Backend использует PHP 8.4, и перезапустите PHP-FPM 8.4.

Изменения кода не отображаются

Почему возникает

Отключена проверка изменений файлов:

opcache.validate_timestamps=0

Как исправить

Перезапустите PHP-FPM.

Настройка PostgreSQL сохранилась, но не применилась

Почему возникает

Параметр требует перезапуска PostgreSQL.

Как исправить

Выполните:

pg_ctlcluster 18 main restart

PostgreSQL не запускается

Почему возникает

Указано недопустимое значение или выбран слишком высокий профиль.

Что проверить

systemctl status postgresql@18-main --no-pager

Проверьте журнал:

journalctl -u postgresql@18-main -n 100 --no-pager

Как исправить

Верните значения предыдущего профиля и повторно запустите PostgreSQL.

Серверу не хватает оперативной памяти

Почему возникает

Выбран профиль выше характеристик сервера или завышены work_mem, shared_buffers и max_connections.

Что проверить

free -h

Как исправить

Перейдите на предыдущий профиль. В первую очередь уменьшите work_mem, shared_buffers и max_connections.

Частые вопросы

Какой профиль выбрать для сервера с 12 ГБ ОЗУ?

Сначала используйте профиль «Рекомендуемый» для 8 ГБ.

После проверки можно изменить PostgreSQL:

shared_buffers = '2GB'
effective_cache_size = '6GB'

work_mem = '8MB'
maintenance_work_mem = '512MB'
autovacuum_work_mem = '256MB'

max_connections = 100

min_wal_size = '1GB'
max_wal_size = '6GB'

Чем больше memory_limit, тем быстрее работает PHP?

Нет. Параметр только разрешает одному скрипту использовать больше памяти.

Нужно ли устанавливать upload_max_filesize равным 1 ГБ?

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

Можно ли установить max_connections равным 1000?

Технически можно, но это не ускорит PostgreSQL. Большое количество подключений увеличивает потребление памяти и может снизить производительность.

Можно ли использовать максимальный профиль на сервере с 16 ГБ?

Нет. Используйте профиль «Высокая производительность».

Нужно ли включать JIT?

Для обычной работы iEXExchanger рекомендуется оставить JIT выключенным:

opcache.jit=off
opcache.jit_buffer_size=0

Нужно ли отключать autovacuum?

Нет. Autovacuum необходим для очистки устаревших версий строк и обновления статистики PostgreSQL.

---

Рекомендуемый профиль для большинства клиентов

Для большинства проектов iEXExchanger рекомендуется следующая конфигурация.

1

Сервер

4 vCPU
8 ГБ ОЗУ
80 ГБ NVMe SSD
PHP 8.4
PostgreSQL 18

2

PHP 8.4

memory_limit=768M

post_max_size=220M
upload_max_filesize=200M

max_execution_time=120
max_input_time=120

max_input_vars=20000

realpath_cache_size=8192K
realpath_cache_ttl=600

opcache.enable=1
opcache.memory_consumption=256
opcache.interned_strings_buffer=32
opcache.max_accelerated_files=50000
opcache.max_wasted_percentage=10
opcache.save_comments=1

opcache.validate_timestamps=1
opcache.revalidate_freq=2

opcache.jit=off
opcache.jit_buffer_size=0

3

PostgreSQL 18

shared_buffers = '1GB'
effective_cache_size = '3GB'

work_mem = '4MB'
maintenance_work_mem = '256MB'
autovacuum_work_mem = '128MB'

max_connections = 75

min_wal_size = '1GB'
max_wal_size = '4GB'

checkpoint_completion_target = 0.9
wal_compression = on

autovacuum = on

Этот профиль обеспечивает сбалансированную работу PHP и PostgreSQL без чрезмерного потребления оперативной памяти.

Коротко

Выберите профиль по фактическому объёму ОЗУ сервера.

Настройки PHP отвечают за допустимую память, загрузку файлов, время выполнения и кеширование PHP-кода. Настройки PostgreSQL управляют памятью базы, подключениями и журналом WAL.

После сохранения параметров перезапустите PHP-FPM и PostgreSQL. Не устанавливайте максимальный профиль на слабом сервере и не отключайте параметры надёжности PostgreSQL.