Laravel 9升级后Composer检测PHP版本不符问题求助

1. 先查错误日志定位问题 #

Ubuntu环境下，直接查看Nginx和PHP-FPM的实时错误日志，能快速找到500错误的根源：

• 查看Nginx错误日志：

  sudo tail -f /var/log/nginx/error.log
  

  如果是站点自定义日志，替换成对应路径即可。
• 查看PHP8.2-FPM错误日志：

  sudo tail -f /var/log/php8.2-fpm.log
  

  访问网站时盯着日志输出，就能看到具体的错误信息（比如缺扩展、权限不对、配置写错）。

2. 检查并补全Laravel 9所需的PHP扩展 #

Laravel 9要求必须安装这些核心扩展：bcrypt, ctype, fileinfo, json, mbstring, openssl, pdo, tokenizer, xml，另外常用的gd、mysql、zip也建议装上。
先检查已安装的扩展：

php8.2 -m

缺什么装什么，比如一次性装常用扩展：

sudo apt install php8.2-bcmath php8.2-gd php8.2-mbstring php8.2-mysql php8.2-xml php8.2-zip

装完重启PHP-FPM生效：

sudo systemctl restart php8.2-fpm

3. 修复Laravel目录权限 #

Laravel的storage和bootstrap/cache目录需要服务器用户（一般是www-data）有写入权限，执行以下命令：

sudo chown -R www-data:www-data /你的项目绝对路径
sudo chmod -R 755 /你的项目绝对路径/storage
sudo chmod -R 755 /你的项目绝对路径/bootstrap/cache

替换成你实际的项目路径即可。

4. 清除旧缓存并重新生成 #

升级后旧的缓存文件可能和新环境不兼容，执行以下命令清理：

cd /你的项目绝对路径
php artisan config:clear
php artisan cache:clear
php artisan route:clear
php artisan view:clear
composer dump-autoload

5. 检查Nginx站点配置是否正确 #

确保Nginx配置里的root指向Laravel的public目录，且fastcgi_pass正确指向PHP8.2-FPM的sock文件，示例配置：

server {
    listen 80;
    server_name 你的域名;
    root /你的项目绝对路径/public;

    index index.php index.html index.htm;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}

检查配置语法是否正确：

sudo nginx -t

没问题就重启Nginx：

sudo systemctl restart nginx

6. 验证PHP版本是否正确加载 #

在Laravel的public目录下临时创建phpinfo.php文件，内容：

<?php phpinfo(); ?>

访问http://你的域名/phpinfo.php，确认显示的PHP版本是8.2.x，且运行模式是PHP-FPM。
用完记得删除这个文件，避免泄露服务器信息：

rm /你的项目绝对路径/public/phpinfo.php

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