NeoKylin 7安装Laravel 10失败主因是环境兼容性断层：PHP版本低于8.1、必需扩展（mbstring/xml/zip/pdo等）缺失、OpenSSL版本过旧导致Composer SSL握手失败、SELinux阻止storage目录写入、以及libmysqlclient库路径未被PHP识别。
NeoKylin 7 是基于 CentOS/RHEL 的国产操作系统，内核和软件生态与主流 Linux 发行版存在差异。Laravel 10 安装失败不是 Laravel 本身的问题，而是环境兼容性断层导致的——核心矛盾在于 PHP 扩展、系统库版本、以及 Composer 运行时依赖不满足 Laravel 10 的硬性要求。
PHP 版本和扩展缺失是最常见拦路虎
Laravel 10 要求 PHP >= 8.1，且必须启用以下扩展：mbstring、xml、curl、json、pdo、tokenizer、zip、openssl。NeoKylin 7 默认源中 PHP 多为 7.2 或 7.4，且 php-zip 和 php-opcache 常被拆包或未默认安装。
- 执行
php -v确认版本；若低于 8.1，需手动编译或添加第三方源（如 Webtatic 或 Remi） - 检查扩展：运行
php -m | grep -E "mbstring|xml|zip|opcache"，缺哪个就装哪个，例如：yum install php-mbstring php-xml php-zip php-opcache - 注意：
php-zip在 NeoKylin 7 中可能叫php-pecl-zip或需启用 EPEL 源
Composer 因 OpenSSL 或 cURL 配置异常直接中断
NeoKylin 7 自带的 OpenSSL 版本较旧（如 1.0.2k），而 Composer 2.5+ 默认要求 TLS 1.2+ 握手能力，部分镜像站会拒绝连接，表现为 file could not be downloaded: SSL operation failed 或超时无响应。
- 临时绕过验证（仅调试用）：
composer config -g secure-http false，但不推荐长期使用 - 更稳妥方式：升级系统 OpenSSL（需确认兼容性）或改用国内镜像源：
composer config -g repo.packagist composer https://packagist.phpcomposer.com - 若仍卡在
laravel/framework下载，尝试加--prefer-dist强制 ZIP 包安装：composer create-project --prefer-dist laravel/laravel myapp
SELinux 和文件权限策略阻止 Artisan 正常写入
NeoKylin 7 默认启用 SELinux 且策略较严，storage 和 bootstrap/cache 目录即使 chmod 777 也常因上下文标签（context）被拒绝写入，报错类似 file_put_contents(...): failed to open stream: Permission denied。
- 先确认 SELinux 状态：
sestatus；若为enforcing，临时设为 permissive 测试：sudo setenforce 0 - 若问题消失，说明是 SELinux 干预，应修复上下文而非关禁用：
sudo semanage fcontext -a -t httpd_sys_rw_content_t "/path/to/laravel/(storage|bootstrap/cache)(/.*)?"，再restorecon -Rv /path/to/laravel/ - 避免用
sudo chmod -R 777，这在 NeoKylin 上反而可能触发额外策略拦截
数据库驱动（尤其是 PDO MySQL）加载失败
即使 php -m 显示 pdo 和 pdo_mysql，NeoKylin 7 的 libmysqlclient 库路径可能未被 PHP 动态链接器识别，导致 DB::connection()->getPdo() 报 driver not found。
- 检查实际加载的库：
ldd $(php -r "echo ini_get('extension_dir');")/pdo_mysql.so | grep mysql - 若显示
not found，需软链系统 MySQL client 库：sudo ln -sf /usr/lib64/mysql/libmysqlclient.so.18 /usr/lib64/libmysqlclient.so（路径依实际版本调整） - 重启 PHP-FPM 或 Apache 后再试：
sudo systemctl restart php-fpm
NeoKylin 7 不是“不能跑 Laravel 10”，而是它把所有隐性依赖都显性化了——你得亲手确认每个扩展是否真能被加载、每条系统调用是否被 SELinux 放行、每个网络请求是否被 OpenSSL 版本掐断。跳过任一环，composer create-project 就会在不同阶段静默失败。
