Ansible更新PHP版本时apt因虚拟包报错的解决方法问询

问题场景 #

在Ansible角色中升级已安装的PHP包版本时，通过dpkg -l获取已安装包列表并替换版本号生成目标包列表，执行apt模块时因php8.2-json这类虚拟包报错，提示无安装候选，但目标列表中已包含提供该虚拟包的实包（如php8.2-cli、php8.2-fpm等）。

解决方案 #

核心思路：从目标安装包列表中移除虚拟包条目，因为对应的实包已经包含虚拟包的功能，无需单独安装虚拟包。

具体步骤 #

1. 在生成目标PHP包列表后，添加过滤逻辑，剔除已知的虚拟包（如phpX.Y-json）；
2. 修正任务命名错误（原代码中最后一个apt任务实际是卸载旧包，需调整名称）。

修改后的Ansible任务代码 #

---

- name: 获取已安装的PHP包列表
  shell: "dpkg -l | grep php | awk '{print $2}'"
  register: update_php_installed_packages

- name: 定义当前已安装PHP包列表变量
  set_fact:
    php_packages_installed: "{{ update_php_installed_packages.stdout_lines }}"

- name: 生成目标版本PHP包列表
  set_fact:
    php_packages_wanted: "{{ php_packages_wanted | default([]) + [item.replace( update_php_current_php_version , update_php_wanted_php_version )] }}"
  loop: "{{ php_packages_installed }}"

- name: 过滤目标列表中的虚拟PHP包（如phpX.Y-json）
  set_fact:
    php_packages_wanted: "{{ php_packages_wanted | reject('search', 'php' + update_php_wanted_php_version + '-json') | list }}"

- name: 安装新版本PHP{{ update_php_wanted_php_version }}包
  apt:
    name: "{{ php_packages_wanted }}"
    state: present
    update_cache: true

- name: 切换PHP版本到{{ update_php_wanted_php_version }}
  alternatives:
    name: php
    path: "/usr/bin/php{{ update_php_wanted_php_version }}"

- name: 设置Apache2默认PHP版本为{{ update_php_wanted_php_version }}
  command: "a2dismod php{{ update_php_current_php_version }}"
- command: "a2enmod php{{ update_php_wanted_php_version }}"
  notify: 
  - restart httpd
  - restart php-fpm

- name: 卸载旧版本PHP{{ update_php_current_php_version }}包
  apt:
    name: "{{ php_packages_installed }}"
    state: absent

扩展优化（可选） #

如果需要更通用的虚拟包过滤逻辑，可以通过apt-cache show命令判断包是否为虚拟包，再批量过滤：

- name: 检查目标包是否为虚拟包
  shell: "apt-cache show {{ item }} 2>/dev/null | grep -q '^Priority: extra' && echo 'virtual' || echo 'real'"
  register: package_type
  loop: "{{ php_packages_wanted }}"

- name: 过滤所有虚拟包
  set_fact:
    php_packages_wanted: "{{ php_packages_wanted | zip(package_type.results | map(attribute='stdout')) | selectattr(1, 'equalto', 'real') | map(attribute=0) | list }}"

内容的提问来源于stack exchange，提问作者Arny80Hexa