如何在VultrAlmaLinux8配置Laravel10-php教程-PHP中文网

almalinux 8默认php 8.0不满足laravel 10≥8.1要求，需启用remi仓库安装php 8.2+并配置mbstring、openssl等扩展，同时严格设置nginx指向public目录、修复selinux上下文以保障storage写入权限。

如何在vultralmalinux8配置laravel10

直接在 Vultr 的 AlmaLinux 8 实例上部署 Laravel 10 是可行的，但必须绕开默认仓库中过旧的 PHP 版本（系统自带 php-8.0 不满足 Laravel 10 最低要求），且不能依赖 dnf install php 一键拉取完整运行栈——否则会卡在 mbstring 缺失、openssl 扩展未启用或 php-fpm 服务无法绑定 socket 等环节。

为什么 AlmaLinux 8 默认 PHP 不支持 Laravel 10

Laravel 10 要求 PHP ≥ 8.1，并启用 mbstring、xml、ctype、json、openssl、pdo_mysql 等扩展。AlmaLinux 8 默认启用的是 php-8.0（来自 AppStream），而 php-8.1+ 需手动启用 powertools 仓库并安装 SCL（Software Collections）版本或使用 Remi 仓库。

dnf module list php 显示可用模块，但 php:remi-8.2 或 php:remi-8.3 不在默认列表中
直接 dnf install php 仍会装 php-8.0.30，运行 php artisan serve 会报错：Class "Illuminate\Foundation\Application" not found
Remi 仓库提供更新、维护活跃的 PHP 版本，且与 AlmaLinux 8 ABI 兼容，是生产环境首选

启用 Remi 仓库并安装 PHP 8.2

AlmaLinux 8 原生不带 Remi，需手动导入 GPG 密钥并启用仓库。注意：不要同时启用多个 PHP SCL 模块（如 php:stream 和 php:remi-8.2），会导致 php-fpm 启动冲突。

linux-performance-analyzer

Linux 性能分析与调优专家，覆盖 CPU、内存、磁盘 I/O、网络、内核参数、编译优化、容器/K8s。适用场景：系统卡顿/高负载、内存不足/OOM/Swap 高、CPU 异常/iowait 高。

下载

执行：dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm
启用 PHP 8.2 模块：dnf module reset php && dnf module enable php:remi-8.2
安装核心组件：dnf install -y php php-cli php-fpm php-mysqlnd php-opcache php-gd php-curl php-mbstring php-xml php-zip php-bcmath php-pdo php-json
验证：php -v 应输出 PHP 8.2.x；php -m | grep -E "mbstring|openssl|pdo" 必须全部有回显

Nginx 配置必须指向 public 目录且禁用 .env 访问

Vultr 实例默认不装 Nginx，需自行安装并严格按 Laravel 文档配置 root 和 try_files。常见错误是把 root 设为项目根目录而非 public，导致路由 404 或 .env 文件被直接下载。

安装：dnf install -y nginx，启动：systemctl enable --now nginx

编辑 /etc/nginx/conf.d/laravel.conf，关键段落必须包含：

server {
    listen 80;
    server_name example.com;
    root /var/www/myapp/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        fastcgi_pass 127.0.0.1:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(env|git|log|htaccess) {
        deny all;
    }
}

确认 php-fpm 监听 127.0.0.1:9000（检查 /etc/php-fpm.d/www.conf 中 listen = 127.0.0.1:9000，非 socket 路径）
重载：nginx -t && systemctl reload nginx

权限与 SELinux 是最容易被忽略的崩溃点

AlmaLinux 8 默认开启 SELinux，而 Laravel 的 storage 和 bootstrap/cache 目录需要写入权限。直接 chmod 777 不解决 SELinux 上下文问题，Nginx 进程仍会被拒绝访问。

设置目录所有权：chown -R nginx:nginx /var/www/myapp/storage /var/www/myapp/bootstrap/cache
修复 SELinux 上下文：semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/myapp/storage(/.*)?"，然后 restorecon -Rv /var/www/myapp/storage
允许 HTTPD 网络连接（若需调用外部 API）：setsebool -P httpd_can_network_connect 1
验证 SELinux 是否放行：ausearch -m avc -ts recent | grep nginx，无输出即正常

别跳过 SELinux 步骤——哪怕你本地测试一切正常，Vultr 实例上只要 SELinux 处于 enforcing 模式，php artisan config:cache 就可能静默失败，日志里只有一行 failed to open stream: Permission denied，根本不会提示 SELinux。