PHP 怎么PHP 升级指南

wen PHP项目 2026-07-26 2

PHP 版本升级完全指南

升级前准备

1 检查当前版本

php -v
phpinfo();  // 或创建phpinfo.php文件查看

2 检查兼容性

查看官方迁移指南：PHP官方发布每个大版本的迁移指南

检查废弃功能：使用工具检查代码兼容性

# 使用PHP CodeSniffer
composer require --dev squizlabs/php_codesniffer
./vendor/bin/phpcs --standard=PHPCompatibility --runtime-set testVersion 8.1  /path/to/code

3 备份重要数据

# 备份项目文件
tar -czf project_backup_$(date +%Y%m%d).tar.gz /path/to/project
# 备份数据库
mysqldump -u root -p database_name > database_backup.sql

不同环境的升级方法

1 Linux 环境（以 Ubuntu/Debian 为例）

使用 PPA 源升级

# 添加 PHP PPA 源
sudo add-apt-repository ppa:ondrej/php
sudo apt update
# 安装新版本（如 PHP 8.2）
sudo apt install php8.2 php8.2-cli php8.2-fpm php8.2-mysql php8.2-xml php8.2-mbstring
# 切换默认版本（如有多个版本）
sudo update-alternatives --set php /usr/bin/php8.2
sudo update-alternatives --set phar /usr/bin/phar8.2
# 配置 Apache/Nginx 使用新版 PHP-FPM
sudo systemctl disable php7.4-fpm
sudo systemctl enable php8.2-fpm
sudo systemctl restart nginx  # 或 sudo systemctl restart apache2

使用 Remi 源（CentOS/RHEL）

# 安装 EPEL 和 Remi 仓库
sudo yum install epel-release
sudo yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm
# 安装新版 PHP
sudo yum --enablerepo=remi-php82 install php php-fpm php-mysqlnd
# 配置服务
sudo systemctl enable php-fpm
sudo systemctl start php-fpm

2 Windows 环境

手动升级

下载新版 PHP：https://windows.php.net/download/

解压并配置：

# 关闭旧版 PHP 服务
net stop Apache2.4  # 或其他 Web 服务器
# 重命名旧版本文件夹备份
mv C:\php C:\php_old
# 解压新版本到 C:\php
# 复制旧的 php.ini 和扩展配置
copy C:\php_old\php.ini C:\php\
copy C:\php_old\ext\*.dll C:\php\ext\

调整路径和配置：
- 修改系统环境变量 PATH
- 更新 php.ini 中的 extension_dir
- 安装缺失的 VC++ Redistributable

使用 WAMP/XAMPP 集成环境

# 对于 XAMPP
# 下载新版 XAMPP 或独立 PHP 包
# 替换 C:\xampp\php 目录
# 关闭控制面板服务，重启 Apache

3 Docker 环境

更新 Dockerfile

FROM php:8.2-fpm  # 或 php:8.2-apache
# 安装所需扩展
RUN docker-php-ext-install pdo_mysql mbstring exif pcntl
RUN pecl install redis && docker-php-ext-enable redis

更新 docker-compose.yml

version: '3.8'
services:
  php:
    image: php:8.2-fpm
    # 原有配置保持不变

4 macOS 环境

使用 Homebrew

# 更新 Homebrew
brew update
# 安装新版 PHP
brew install php@8.2
# 切换版本
brew unlink php@7.4
brew link --force --overwrite php@8.2
# 验证版本
php -v

使用 Laravel Valet

# 安装新版 PHP
brew install php@8.2
# 配置 Valet 使用新版本
valet use php@8.2
valet restart

配置调整

1 php.ini 配置迁移

; 记忆体限制
memory_limit = 256M
; 上传限制
upload_max_filesize = 64M
post_max_size = 64M
; 时区设置
date.timezone = Asia/Shanghai
; 错误报告 (开发环境)
error_reporting = E_ALL
display_errors = On
; 生产环境
; display_errors = Off
; log_errors = On

2 扩展安装

# Ubuntu/Debian 常用扩展
sudo apt install php8.2-{mysql,xml,mbstring,curl,gd,intl,zip,bcmath,redis,imagick}
# CentOS/RHEL 常用扩展
sudo yum --enablerepo=remi-php82 install php-{mysqlnd,pecl-redis,pecl-imagick,xml,mbstring,curl,gd,intl,zip,bcmath}
# macOS
brew install php@8.2-{redis,imagick}

常见兼容性问题及解决方案

1 代码兼容性修复

废弃函数替换

// PHP 7.x → PHP 8.x
// mysql_* 系列 → PDO 或 mysqli
$conn = mysqli_connect($host, $user, $pass, $db);
// each() → foreach
foreach ($array as $key => $value) {
    // 代替 while (list($key, $value) = each($array))
}
// create_function() → 匿名函数
$func = function($arg) { return $arg * 2; };
// __autoload() → spl_autoload_register()
spl_autoload_register(function($class) {
    include 'classes/' . $class . '.php';
});

严格类型模式

declare(strict_types=1);
function add(int $a, int $b): int {
    return $a + $b;
}
// 返回值类型声明
function getUser(): ?array {
    return $user ?? null;
}

匹配表达式 (PHP 8.0+)

// 传统 switch
switch ($status) {
    case 'active':
        $result = '活跃';
        break;
    case 'inactive':
        $result = '不活跃';
        break;
    default:
        $result = '未知';
}
// 改用 match (PHP 8.0+)
$result = match ($status) {
    'active' => '活跃',
    'inactive' => '不活跃',
    default => '未知',
};

命名参数 (PHP 8.0+)

// 传统调用
createUser('John', 'Doe', null, true);
// 使用命名参数
createUser(firstName: 'John', lastName: 'Doe', isAdmin: true);

构造器属性提升 (PHP 8.0+)

// 传统方式
class User {
    private string $name;
    private int $age;
    public function __construct(string $name, int $age) {
        $this->name = $name;
        $this->age = $age;
    }
}
// 使用属性提升
class User {
    public function __construct(
        private string $name,
        private int $age
    ) {}
}

2 框架兼容性

Laravel

# 升级 Laravel 框架
composer require laravel/framework:^10.0 --no-update
composer update
# 检查依赖兼容性
composer why-not php 8.2

Symfony

# 升级 Symfony
composer require symfony/framework-bundle:^6.2 --no-update
composer update
# 使用 Symfony 兼容性检查器
php bin/console about

WordPress

# 升级 WordPress 核心
# 手动下载最新版本覆盖
wget https://wordpress.org/latest.tar.gz
tar -xzf latest.tar.gz --strip-components=1
# 更新插件和主题
wp plugin update --all
wp theme update --all

测试与验证

1 运行测试套件

# PHPUnit 测试
./vendor/bin/phpunit
# 代码质量检查
./vendor/bin/phpcs --standard=PSR12 .

2 兼容性测试脚本

<?php
// 检查新特性支持
echo "PHP Version: " . phpversion() . "\n";
// 检查扩展
$required_extensions = ['pdo_mysql', 'mbstring', 'xml', 'curl', 'gd', 'zip'];
foreach ($required_extensions as $ext) {
    echo "$ext: " . (extension_loaded($ext) ? '✅' : '❌') . "\n";
}
// 检查新特性
echo "match expression: " . (version_compare(PHP_VERSION, '8.0', '>=') ? '✅' : '❌') . "\n";
echo "named arguments: " . (version_compare(PHP_VERSION, '8.0', '>=') ? '✅' : '❌') . "\n";
echo "enum support: " . (version_compare(PHP_VERSION, '8.1', '>=') ? '✅' : '❌') . "\n";
echo "readonly properties: " . (version_compare(PHP_VERSION, '8.1', '>=') ? '✅' : '❌') . "\n";

3 性能基准测试

# 使用 Apache Bench 或 Lighthouse
ab -n 1000 -c 10 http://localhost/test.php

回滚方案

# Linux 回滚
sudo apt install php7.4 php7.4-fpm
sudo update-alternatives --set php /usr/bin/php7.4
sudo systemctl disable php8.2-fpm
sudo systemctl enable php7.4-fpm
sudo systemctl restart nginx
# Docker 回滚
git checkout -- docker-compose.yml  # 恢复旧版本
docker-compose up -d --build

最佳实践

逐步升级：先升级到中间版本（如先到 PHP 7.4，再到 8.0，最后到 8.2）
使用自动化工具：利用 CI/CD 管道自动测试兼容性
监控：升级后密切监控错误日志和应用性能
文档化：记录所有自定义配置和特殊处理
保持更新：定期应用安全补丁

升级后重置 PHP-FPM 或 Web 服务器服务，确保所有变更生效。