kylin v10 上运行 laravel 9 可行但需绕过 php 8.1+/composer 2.5+ 兼容性陷阱：手动启用 pcntl、升级 libzip、离线预装 vendor、配置 nginx + php-fpm 权限及 kysec 策略。
Kylin V10 上运行 Laravel 9 是可行的，但必须绕过官方不支持的「PHP 8.1+」和「Composer 2.5+」在国产系统上的兼容性陷阱——尤其是当使用 ARM64 架构或离线环境时，composer install 极易卡在 ext-pcntl 检测、git clone 超时或 php -v 报错 symbol not found。核心前提是：别直接套用 Ubuntu/CentOS 的一键脚本。
确认 PHP 版本与关键扩展是否真正可用
Laravel 9 要求 PHP ≥ 8.0，且强制依赖 ext-mbstring、ext-xml、ext-curl、ext-zip 和 ext-pcntl（队列/artisan serve 需要）。Kylin V10 SP2/SP3 默认源中提供的 PHP 通常为 7.4 或 8.0，但 php -m | grep pcntl 很可能为空——因为 Kylin 的 RPM 包常把 pcntl 编译成独立模块且未启用。
实操建议：
- 先运行
php -v确认版本；若低于 8.0，不要尝试升级系统源里的 php，改用 SURY PHP PPA 的 ARM64 构建版（需提前下载php8.1-cli、php8.1-mbstring等 RPM 包离线安装） - 检查
pcntl：运行php -r "echo extension_loaded('pcntl') ? 'yes' : 'no';"；返回no则需手动加载——编辑/etc/php.d/99-pcntl.ini，写入extension=pcntl.so，再重启php-fpm或确保 CLI 使用同一配置 - ARM64 下
ext-zip依赖libzip≥ 1.6，而 Kylin 默认libzip是 1.5.1；需单独下载libzip-1.9.2-1.aarch64.rpm并rpm -Uvh --force升级
离线安装 Composer 并跳过 git 依赖
Kylin V10 离线环境里，curl -sS https://getcomposer.org/installer | php 必然失败；更麻烦的是 Laravel 9 的 vendor 里大量包声明了 "type": "package" 或依赖 GitHub repo，composer install 会反复尝试 git clone 并报 sh: git: not found 或 Connection refused。
实操建议：
- 在能联网的同架构机器上，用
php composer.phar install --no-dev --prefer-dist --optimize-autoloader预装好vendor目录，连同composer.lock一起打包传入 Kylin - 若必须在线装，先确保已装
git（Kylin 源里有git-2.24.0-1.ky10.aarch64.rpm，注意 ARM/x86 包不可混用），再执行：php composer.phar config -g github-oauth.github.com your_token（避免限流） - 彻底禁用 git：运行
php composer.phar config -g disable-tls true和php composer.phar config -g secure-http false，并设置php composer.phar config -g repo.packagist composer https://packagist.org
适配 Web 服务器：Nginx + PHP-FPM 路径权限陷阱
Kylin V10 默认用 nginx（非 httpd），但其默认配置不识别 Laravel 的 public/index.php 入口，且 SELinux-like 的 KySec 模块可能拦截 open_basedir 外的文件访问，导致 500 错误但日志只显示 PHP message: PHP Warning: Unknown: failed to open stream。
实操建议：
- 修改
/etc/nginx/conf.d/default.conf，确保root指向 Laravel 项目根目录的public子目录，且location /块包含：try_files $uri $uri/ /index.php?$query_string;
- 检查 PHP-FPM 进程用户：Kylin 默认用
nginx用户跑 PHP-FPM，但项目目录属主可能是root；运行chown -R nginx:nginx /var/www/laravel，并确认/var/lib/php/session可写 - 临时关闭 KySec 安全策略验证：
kysecctl --set-policy off（仅调试用），或添加白名单：kysecctl --add-path /var/www/laravel --perm rwx
最易被忽略的一点：Laravel 9 的 storage 和 bootstrap/cache 目录在 Kylin 上必须由 PHP-FPM 进程用户（而非当前 shell 用户）拥有可写权限，且 chmod -R 775 不够——Kylin 的默认 umask 是 0027，导致新生成的缓存文件权限为 640，PHP 无法读取。务必在部署后执行：sudo -u nginx php artisan storage:link && sudo -u nginx php artisan optimize:clear。
