部署Laravel项目遭遇Parse Error错误，寻求解决方案

问题详情 #

部署Laravel项目时触发语法错误，错误信息如下：

Parse error: syntax error, unexpected '|', expecting variable (T_VARIABLE) in /home/vol18_2/epizy.com/epiz_34191254/htdocs/BCM_Bank/vendor/nunomaduro/termwind/src/Functions.php on line 17

错误代码片段（vendor/nunomaduro/termwind/src/Functions.php第17行附近）：

<?php

declare(strict_types=1);

namespace Termwind;

use Closure;
use Symfony\Component\Console\Output\OutputInterface;
use Termwind\Repositories\Styles as StyleRepository;
use Termwind\ValueObjects\Style;
use Termwind\ValueObjects\Styles;

if (! function_exists('Termwind\\renderUsing')) {
    /**
     * Sets the renderer implementation.
     */
    function renderUsing(OutputInterface|null $renderer): void
    {
        Termwind::renderUsing($renderer);
    }
}

当前项目配置（composer.json） #

{
    "name": "laravel/laravel",
    "type": "project",
    "description": "The Laravel Framework.",
    "keywords": ["framework", "laravel"],
    "license": "MIT",
    "require": {
        "php": "^8.1",
        "carbondate/carbon": "*",
        "guzzlehttp/guzzle": "^7.2",
        "laravel/breeze": "^1.20",
        "laravel/framework": "^10.8",
        "laravel/sanctum": "^3.2",
        "laravel/tinker": "^2.8",
        "livewire/livewire": "^2.12",
        "simplesoftwareio/simple-qrcode": "^4.2"
    },
    "require-dev": {
        "fakerphp/faker": "^1.9.1",
        "laravel/pint": "^1.0",
        "laravel/sail": "^1.18",
        "mockery/mockery": "^1.4.4",
        "nunomaduro/collision": "^7.0",
        "phpunit/phpunit": "^10.1",
        "spatie/laravel-ignition": "^2.0"
    },
    "autoload": {
        "psr-4": {
            "App\\": "app/",
            "Database\\Factories\\": "database/factories/",
            "Database\\Seeders\\": "database/seeders/"
        }
    },
    "autoload-dev": {
        "psr-4": {
            "Tests\\": "tests/"
        }
    },
    "scripts": {
        "post-autoload-dump": [
            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
            "@php artisan package:discover --ansi"
        ],
        "post-update-cmd": [
            "@php artisan vendor:publish --tag=laravel-assets --ansi --force"
        ],
        "post-root-package-install": [
            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
        ],
        "post-create-project-cmd": [
            "@php artisan key:generate --ansi"
        ]
    },
    "extra": {
        "laravel": {
            "dont-discover": []
        }
    },
    "config": {
         "platform": {
            "php": "8.1"
         },
        "platform-check": false,
        "optimize-autoloader": true,
        "preferred-install": "dist",
        "sort-packages": true,
        "allow-plugins": {
            "pestphp/pest-plugin": true,
            "php-http/discovery": true
        }
    },
    "minimum-stability": "stable",
    "prefer-stable": true
}

问题原因 #

错误里的OutputInterface|null是PHP 8.0+引入的联合类型语法，但服务器实际运行的PHP版本低于8.0。虽然composer.json里指定了php: ^8.1，且配置了platform.php: 8.1，但这个配置只是让Composer在安装依赖时认为环境是PHP8.1，不会改变服务器实际运行的PHP版本。

解决步骤 #

方案1：升级服务器PHP版本 #

• 登录主机控制面板，找到PHP版本管理选项，将PHP版本切换到8.1或更高。
• 切换完成后，重新访问项目验证错误是否消失。

方案2：降级依赖适配低版本PHP #

如果服务器无法升级PHP版本（比如最高只支持7.4），需要调整项目依赖：

1. 修改composer.json：
   • 将require.php改为^7.4
   • 将laravel/framework改为^9.x（Laravel 9支持PHP7.4+）
   • 同步调整其他依赖版本：
     • laravel/breeze改为^1.15
     • nunomaduro/collision改为^6.0
     • phpunit/phpunit改为^9.5
     • spatie/laravel-ignition改为^1.0
   • 删除config.platform配置（或改为服务器实际PHP版本）
2. 执行命令重新安装依赖：

   composer update --no-plugins
   

3. 清理缓存并重新配置项目：

   php artisan config:clear
   php artisan cache:clear
   

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