银河麒麟系统升级PHP至8.2需源码编译：先确认架构与glibc≥2.29，安装开发工具及依赖；下载PHP 8.2.30源码，配置--prefix=/usr/local/php82、--enable-fpm等参数后编译安装；再配置php-fpm.d/www.conf与systemd服务，启用php82-fpm并验证版本与socket。

银河麒麟系统默认不预装 PHP 8.2，且官方仓库（截至2026年）仍以 PHP 7.4 或 8.1 为主流支持版本。直接通过 dnf install php 无法获取 8.2，必须采用源码编译方式升级——这是当前最可靠、适配性最强的路径，尤其适用于 V10 SP2/SP3 和 V11 系统。

确认当前环境与依赖准备

先检查系统架构和基础工具链是否就绪：

• 执行 uname -m 确认是 x86_64 还是 aarch64，后续下载的 PHP 源码包和依赖需严格匹配
• 安装编译必需工具： sudo dnf groupinstall -y "Development Tools"
sudo dnf install -y libxml2-devel openssl-devel curl-devel libjpeg-devel libpng-devel freetype-devel libzip-devel oniguruma-devel sqlite-devel systemd-devel
• 特别注意：V11 系统（内核 6.6，glibc 2.38）已满足 PHP 8.2 的最低运行要求；若为 V10 旧版（如 glibc 2.28），需先确认是否兼容——PHP 8.2 要求 glibc ≥ 2.29，不满足则建议升级系统或改用 PHP 8.1

下载并编译安装 PHP 8.2.x

推荐使用稳定小版本，例如 PHP 8.2.30（截至2026年10月最新安全更新版）：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 下载源码：wget https://windows.php.net/downloads/releases/php-8.2.30.tar.gz
• 解压并进入目录：tar -xzf php-8.2.30.tar.gz && cd php-8.2.30
• 配置编译参数（适配麒麟常见部署习惯）：
  ./configure \
--prefix=/usr/local/php82 \
--with-config-file-path=/usr/local/php82/etc \
--enable-fpm \
--with-fpm-user=www \
--with-fpm-group=www \
--enable-mbstring \
--with-curl \
--with-openssl \
--with-zlib \
--with-mysqli=mysqlnd \
--with-pdo-mysql=mysqlnd \
--enable-gd \
--with-jpeg \
--with-freetype \
--with-zip \
--with-systemd
• 编译并安装：make -j$(nproc) && sudo make install

配置与启用 PHP-FPM 服务

安装完成后需手动注册为 systemd 服务，并确保与 Web 服务器协同工作：

立即学习“PHP免费学习笔记（深入）”；

• 复制配置文件：sudo cp /usr/local/php82/etc/php-fpm.conf.default /usr/local/php82/etc/php-fpm.conf
sudo cp /usr/local/php82/etc/php-fpm.d/www.conf.default /usr/local/php82/etc/php-fpm.d/www.conf
• 编辑 /usr/local/php82/etc/php-fpm.d/www.conf，确认以下关键项：
  user = www
group = www
listen = /run/php82-fpm.sock
listen.owner = www
listen.group = www
listen.mode = 0660
• 创建 systemd 服务单元文件：/etc/systemd/system/php82-fpm.service，内容如下：
  

  [Unit]<br>
    Description=The PHP 8.2 FastCGI Process Manager<br>
    After=network.target<br>
    <br>
    [Service]<br>
    Type=notify<br>
    PIDFile=/run/php82-fpm.pid<br>
    ExecStart=/usr/local/php82/sbin/php-fpm --nodaemonize --fpm-config /usr/local/php82/etc/php-fpm.conf<br>
    ExecReload=/bin/kill -USR2 $MAINPID<br>
    Restart=always<br>
    User=root<br>
    Group=www<br>
    <br>
    [Install]<br>
    WantedBy=multi-user.target

• 启用并启动：sudo systemctl daemon-reload && sudo systemctl enable php82-fpm && sudo systemctl start php82-fpm

验证与切换使用

最后确认新版本可用，并可按需设为默认：

• 检查版本：/usr/local/php82/bin/php -v 应输出 PHP 8.2.30
• 检查 FPM 状态：systemctl is-active php82-fpm 返回 active，且 ls -l /run/php82-fpm.sock 存在
• 如需全局调用，可添加软链接（谨慎操作，避免影响原有 PHP）：
  sudo ln -sf /usr/local/php82/bin/php /usr/local/bin/php82
sudo ln -sf /usr/local/php82/sbin/php-fpm /usr/local/bin/php82-fpm
• 若 Nginx/Apache 需对接，修改其配置中 fastcgi_pass 指向 unix:/run/php82-fpm.sock 即可