MacOS Ventura下切换多版本PHP遇Apache启动失败求助

问题背景 #

使用2021款MBP（MacOS 13.4），为测试PHP应用跨版本兼容性，通过brew安装PHP 8.2后，用brew tap shivammathur/php安装PHP 7.4。CLI版本切换正常，但Apache始终识别8.2，于是编写bash脚本通过独立的php.conf配置文件切换Apache模块。但切换到7.4时Apache启动失败，报错：

Syntax error on line 1 of /opt/homebrew/etc/httpd/php.conf: Can't locate API module structure `php_module' in file /opt/homebrew/opt/php@7.4/lib/httpd/modules/libphp7.so: dlsym(0x968e8d00, php_module): symbol not found

问题原因 #

PHP 7.x和PHP 8.x的Apache模块结构名称不同：

• PHP 7.x的模块结构名为php7_module
• PHP 8.x的模块结构名为php_module

之前的脚本和配置文件统一使用php_module作为模块名，导致Apache加载PHP 7.4模块时找不到对应符号。

解决方案 #

1. 更新php.conf占位符 #

修改/opt/homebrew/etc/httpd/php.conf的占位符内容，新增模块名称变量：

LoadModule #{php_module_name} #{php_module_path}

<FilesMatch \.php$>
    SetHandler application/x-httpd-php
</FilesMatch>

2. 修改bash脚本，添加模块名逻辑 #

更新脚本中的update_php_conf函数，针对不同PHP版本设置对应的模块名和路径：

#!/bin/bash

# Specify the paths for each version of PHP
php_7_4_path="/opt/homebrew/opt/php@7.4/lib/httpd/modules/libphp7.so"
php_8_1_path="/opt/homebrew/opt/php@8.1/lib/httpd/modules/libphp.so"
php_8_2_path="/opt/homebrew/opt/php@8.2/lib/httpd/modules/libphp.so"

php_conf_file="/opt/homebrew/etc/httpd/php.conf"
php_conf_backup="php_conf_file.backup"

# Function to update the php.conf file with the correct PHP version
update_php_conf() {
    php_version="$1"
    php_module_path=""
    php_module_name=""

    case "$php_version" in
        7.4)
            php_module_path="$php_7_4_path"
            php_module_name="php7_module"
            ;;
        8.1)
            php_module_path="$php_8_1_path"
            php_module_name="php_module"
            ;;
        8.2)
            php_module_path="$php_8_2_path"
            php_module_name="php_module"
            ;;
        *)
            echo "Invalid PHP version specified."
            exit 1
            ;;
    esac

    cp "$php_conf_backup" "$php_conf_file"  # Restore the original php.conf file
    sed -i '' "s|#{php_module_name}|$php_module_name|" "$php_conf_file"
    sed -i '' "s|#{php_module_path}|$php_module_path|" "$php_conf_file"
}

# Usage: switch_php_version <version>
switch_php_version() {
    desired_version="$1"

    # Use Brew to switch the PHP version
    brew unlink php
    brew link --overwrite --force "php@$desired_version"

    # Backup the original php.conf file (if not already done)
    if [ ! -f "$php_conf_backup" ]; then
        cp "$php_conf_file" "$php_conf_backup"
    fi

    # Update the php.conf file with the correct PHP version
    update_php_conf "$desired_version"

    # Restart Apache
    apachectl restart
}

# Usage example: ./switch-php.sh 8.2
switch_php_version "$1"

3. 重新初始化备份文件 #

删除旧的备份文件，用新的占位符配置生成备份：

rm php_conf_file.backup
cp /opt/homebrew/etc/httpd/php.conf php_conf_file.backup

4. 测试切换 #

运行脚本切换到PHP 7.4，先检查配置正确性再重启Apache：

./switch-php.sh 7.4
apachectl configtest
apachectl restart

此时Apache应该能正常加载PHP 7.4模块，CLI和Apache的PHP版本也会同步切换。

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