laravel 10 在火山引擎 velinux 1 上安装失败的根本原因是 php 版本低于 8.1、proc_open 函数被禁用或 composer 未配置国内镜像，需分别升级 php 至 8.1、启用 proc_open 及切换阿里云镜像解决。
Laravel 10 在火山引擎 VeLinux 1（基于 CentOS/RHEL 8/9 的定制发行版）上安装失败，根本原因几乎总是 PHP 环境不达标或关键扩展被禁用，而非 VeLinux 本身“不兼容”。VeLinux 默认 PHP 版本常为 7.4 或 8.0，而 Laravel 10 明确要求 PHP ≥ 8.1，且必须启用 proc_open、mbstring、openssl 等扩展。
下面直击真实报错场景和对应解法：
PHP 版本低于 8.1 导致 composer create-project 直接退出
现象：composer create-project laravel/laravel myapp 运行几秒后报错类似：
Problem 1 - laravel/framework[v10.0.0, ..., v10.x-dev] require php >=8.1.0 -> your php version (7.4.33) does not satisfy that requirement.
VeLinux 仓库默认 PHP 版本偏低，必须手动升级：
- 确认当前版本：
php -v，若显示7.4.x或8.0.x，必须换源升级 - VeLinux 推荐使用
dnf module reset php && dnf module enable php:remi-8.1（如已配置 remi 源），或直接启用 EPEL + Remi：sudo dnf install epel-release -y && sudo dnf install https://rpms.remirepo.net/enterprise/remi-release-8.rpm -y - 安装 PHP 8.1 核心及扩展：
sudo dnf module enable php:remi-8.1 && sudo dnf install php php-cli php-mbstring php-xml php-zip php-bcmath php-opcache php-gd php-curl php-json php-process php-common php-pdo php-mysqlnd -y - 重启 PHP-FPM（如使用）：
sudo systemctl restart php-fpm；CLI 下执行php -v应输出PHP 8.1.x
php.ini 禁用 proc_open 导致 composer 卡死或报 “Class not found”
现象：执行 composer create-project 后卡在 Loading composer repositories，或报错 Call to undefined function proc_open()
VeLinux（尤其安全加固版）常在 /etc/php.d/99-disable-functions.ini 或主 php.ini 中禁用高危函数，proc_open 和 proc_get_status 正是 Laravel 安装器必需的：
- 查找禁用项：
grep -r "disable_functions" /etc/php* - 编辑对应文件（如
/etc/php.d/99-disable-functions.ini），删掉或注释掉proc_open和proc_get_status - 重启服务：
sudo systemctl restart php-fpm（或httpd/nginx，取决于 Web 服务器） - 验证：
php -r "echo function_exists('proc_open') ? 'ok' : 'fail';"必须输出ok
Composer 镜像未切国内源，导致超时或 404
现象：create-project 卡在 Updating dependencies，或报 Could not fetch https://repo.packagist.org/packages.json
VeLinux 默认无国内镜像，Packagist 域名解析或连接极不稳定：
- 全局设置阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 同时增加超时与内存限制（避免中途断）：
composer config -g process-timeout 1200 && composer config -g memory-limit -1 - 强制使用 dist 包加速：
composer create-project laravel/laravel myapp --prefer-dist
VeLinux 不是“特殊系统”，它本质仍是 RHEL 兼容系。真正卡点永远落在三处：PHP 版本硬门槛、proc_open 被锁死、网络不通。其他报错（如权限、扩展缺失）都是这三者的衍生表现——先过这三关，再谈其他。
