已经安装pterodactyl 2.0的ubuntu或debian测试环境，可按官方文档安装php 8.4及对应扩展，再切换web服务器的fpm入口、重启pteroq并检查依赖。2.0目前仍应按测试版范围评估；本文不把1.x直接升级为2.0，也不建议仍在1.x上的环境照搬php 8.4切换。
先核对Panel版本并保存原配置
官方列出的2.x要求是PHP 8.3或8.4，1.11.10起的1.x则列出8.2或8.3。保存现有站点配置、PHP-FPM配置和可恢复的应用数据，记下原运行版本与socket。后面的示例使用NGINX和默认站点路径，实际路径不同须对应调整。
Pterodactyl官方PHP版本要求与扩展安装步骤
安装新版本及同版本扩展
Ubuntu使用官方文档给出的ondrej/php仓库；Debian应使用安装指南配置的Sury仓库，不能在Debian上套用Ubuntu PPA。具备对应软件源后，以有权限的管理员执行：
apt update
apt -y install php8.4 php8.4-{common,cli,gd,mysql,mbstring,bcmath,xml,fpm,curl,zip,intl}
php -v确认php -v实际显示8.4，并确认新FPM服务正常。CLI与Web服务可能指向不同版本，只更新命令行并不能使网页自动切换。Intl及其他必需扩展也必须安装到实际运行的版本。
切换FPM入口并重启队列
编辑/etc/nginx/sites-available/pterodactyl.conf，将旧PHP-FPM的socket改为新版本对应路径，例如unix:/run/php/php8.4-fpm.sock。先检查socket真实存在，再校验配置；只有校验通过才重载NGINX。
立即学习“PHP免费学习笔记（深入）”；
nginx -t systemctl reload nginx systemctl restart pteroq
Pterodactyl官方NGINX入口切换、队列重启及依赖检查
同时核对命令行依赖与网页任务
cd /var/www/pterodactyl composer check-platform-reqs --no-dev
检查结果应满足安装所需的PHP与扩展条件，再打开Panel确认登录、页面请求与队列任务。若FPM入口或扩展不匹配，先恢复已保存的旧配置和受支持运行时；不要先删除旧PHP包。全部验证完成后，再决定是否卸载不再被其他站点使用的版本。
