Laravel5.4项目Homestead正常，VPS（PHP5.6）报语法错误求助

这个问题的核心原因很明确：Laravel 5.4官方要求的最低PHP版本是7.0，你的VPS使用的PHP5.6不支持框架核心代码里用到的PHP7专属语法特性（比如返回类型声明function foo(): string这类写法），这就是你看到syntax error, unexpected ':', expecting ';' or '{'的直接原因。

下面给你两种可行的解决方案，按优先级推荐：

方案一：升级服务器PHP版本到7.0+（强烈推荐） #

PHP5.6早在2018年就停止了安全维护，继续使用会存在严重的安全风险。升级到PHP7.0及以上不仅能解决这个语法错误，还能显著提升项目性能和安全性。具体操作步骤根据服务器系统不同略有差异：

对于Ubuntu/Debian系统 #

• 添加PHP官方PPA源：

  sudo add-apt-repository ppa:ondrej/php
  sudo apt-get update
  

• 安装PHP7.0及Laravel必需的扩展：

  sudo apt-get install php7.0 php7.0-fpm php7.0-mysql php7.0-mbstring php7.0-xml php7.0-curl php7.0-zip
  

• 切换Web服务器的PHP版本（以Nginx为例，修改站点配置里的fastcgi_pass为unix:/run/php/php7.0-fpm.sock；Apache则禁用php5.6模块，启用php7.0模块）。

对于CentOS/RHEL系统 #

• 安装Remi源：

  sudo yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm
  sudo yum-config-manager --enable remi-php70
  

• 安装PHP7.0及必需扩展：

  sudo yum install php70 php70-php-fpm php70-php-mysqlnd php70-php-mbstring php70-php-xml php70-php-curl php70-php-zip
  

• 重启Web服务器和PHP-FPM服务：

  sudo systemctl restart httpd # 若用Nginx则替换为nginx
  sudo systemctl restart php70-php-fpm
  

升级完成后，重新部署你的Laravel项目，语法错误即可解决。

方案二：降级Laravel版本到兼容PHP5.6的版本（仅当无法升级PHP时使用） #

如果因为某些限制无法升级PHP，你可以将Laravel版本降级到5.3（Laravel5.3最低支持PHP5.6.4，刚好匹配你的服务器环境）。操作步骤如下：

1. 修改项目根目录下的composer.json文件，将laravel/framework的版本从5.4.*改为5.3.*：

   "require": {
       "laravel/framework": "5.3.*"
   }
   

2. 运行Composer更新命令，确保所有依赖包兼容Laravel5.3：

   composer update laravel/framework --with-all-dependencies
   

3. 检查项目代码中是否使用了Laravel5.4新增特性（比如路由隐式模型绑定简化写法、集合flatMap方法、请求验证validateWithBag方法等），如有需要修改为Laravel5.3兼容的写法。
4. 清除缓存确保配置生效：

   php artisan cache:clear
   php artisan config:clear
   

完成后，项目即可在PHP5.6环境正常运行。

额外注意事项 #

• 无论选择哪种方案，都要确保服务器安装了Laravel必需的PHP扩展：OpenSSL、PDO、Mbstring、Tokenizer、XML、Curl、Zip。
• 降级版本仅作为临时方案，Laravel5.3也早已停止维护，长期来看仍推荐升级PHP版本保障项目安全。

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