如何在DigitalOceanFedora38配置Laravel11-php教程-PHP中文网

fedora 38 部署 laravel 11 不推荐，因默认 php 8.1 不满足 ≥8.2 要求，须启用 remi 仓库安装 php 8.2+、禁用 selinux、使用 composer 3.x 并正确配置 nginx 与权限。

如何在digitaloceanfedora38配置laravel11

Fedora 38 上部署 Laravel 11 不是官方推荐路径，Laravel 文档和社区生态默认以 Ubuntu 或 Debian 为主；Fedora 的包管理、PHP 默认版本、SELinux 策略和 systemd 服务行为都更激进，容易在初始化阶段就卡住——比如 composer create-project 失败、php artisan serve 启动但无法响应、或 storage 目录权限拒绝写入。

直接结论：能配，但不建议生产用；若必须用 Fedora 38，请跳过系统自带 PHP，手动编译或启用 Remi 仓库安装 PHP 8.2+，并全程关闭 SELinux（不是设为 permissive）。

`php -v` 输出必须是 8.2.0+，且扩展真实加载

Fedora 38 自带的 php 包来自 fedora-modular，默认是 PHP 8.1（dnf list php 可确认），而 Laravel 11 强制要求 PHP ≥ 8.2。
只改 php.ini 或软链接无用，必须换版本。

运行 php -v，输出必须含 8.2. 或更高（如 8.2.25）
运行 php -m | grep -E "(mbstring|openssl|pdo|tokenizer|xml|ctype|json|intl)"，每项都得有输出，缺一不可
intl 扩展在 Fedora 上常缺失：装 php-intl 后仍需检查 php --ini 显示的 Loaded Configuration File 路径，确认 extension=intl 未被注释

正确做法：

sudo dnf install -y dnf-plugins-core
sudo dnf install -y https://rpms.remirepo.net/fedora/remi-release-38.rpm
sudo dnf module reset php
sudo dnf module enable php:remi-8.2
sudo dnf install -y php php-cli php-mbstring php-xml php-zip php-curl php-tokenizer php-json php-opcache php-intl php-pdo php-mysqlnd

装完立刻验证：php -v 和 php -m 两步缺一不可。

`composer create-project` 必须加 `--no-interaction` 且用 Composer 3.x

Fedora 默认 dnf install composer 安装的是 Composer 2.x（截至 2026 年 9 月仍是），而 Laravel 11 的 composer.json 已依赖 Composer 3 的插件解析机制。
现象是卡在 Resolving dependencies... 数分钟不动，或报错 Your requirements could not be resolved。

运行 composer --version，必须输出 3.x（如 3.4.0）

正确安装方式（绕过 dnf）：

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'e21205b207c3ff031906575712edab6f13eb0b361f2085f1f1237b7126d785e8') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer

创建项目命令只有一条有效：

composer create-project laravel/laravel:^11.0 myapp --no-interaction

进目录后立刻执行：

cd myapp && php artisan key:generate

漏掉这步，APP_KEY 是占位值，所有加密/Session/CSRF 全失效，但错误不会立即暴露。

Git Commit PR Workflow

用于完整的Git工作流：根据需要创建分支、提交、推送，以及创建或更新PR，附上简洁的概述和测试计划。

下载

`Nginx` 配置要绕开 SELinux + 修正 `fastcgi_pass` socket 路径

Fedora 38 默认启用 SELinux，且策略比 Ubuntu 严格得多。nginx 进程默认无权读取 /var/www/myapp/storage 或连接 PHP-FPM socket，现象是 502 Bad Gateway 或 403 Forbidden，日志里却只写 Permission denied，不提 SELinux。

最简方案：彻底禁用 SELinux（别信 setenforce 0 临时切换，重启即恢复）
```
sudo nano /etc/selinux/config
# 改成 SELINUX=disabled
sudo reboot
```
PHP-FPM socket 路径不是 Ubuntu 的 /var/run/php/php8.2-fpm.sock，Fedora 默认是 /run/php-fpm/www.sock（看 systemctl cat php-fpm 确认）

Nginx 配置中 root 必须指向 public/ 目录，且 try_files 和 fastcgi_param SCRIPT_FILENAME 必须匹配：

location ~ \.php$ {
  fastcgi_pass unix:/run/php-fpm/www.sock;
  fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
  include fastcgi_params;
}

storage 和 bootstrap/cache 目录权限必须为 775，属组为 nginx：

sudo chgrp -R nginx storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

Laravel 在 Fedora 上最隐蔽的坑，不是装不上，而是“看似跑起来了”——首页能打开，表单能提交，但上传失败、队列不消费、日志不落盘、缓存不生效。这些全是 SELinux 拦截或 socket 权限链断裂的静默表现。动手前先 getenforce 看一眼，是 Enforcing 就别折腾策略规则，直接关掉。