centos装laravel要注意啥

在 CentOS 上部署/安装 Laravel，比起 Ubuntu 有一些坑和注意点，下面按「系统环境 → PHP → 依赖 → 权限 → 常见坑」给你梳理一遍。

一、系统版本注意

• CentOS 7 / 8 / Stream 都行，但：
  • CentOS 7 默认 PHP 太老（5.4），必须换源
  • CentOS 8 已 EOL，建议用 Stream 或 Rocky/AlmaLinux
• 推荐：

  CentOS 8 Stream / Rocky Linux 9
  

二、PHP 版本（非常关键）

Laravel 对 PHP 版本要求严格：

✅ 不要用系统自带 PHP

推荐安装方式（Remi 源）

yum install -y epel-release
yum install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm
yum module reset php
yum module enable php:remi-8.2
yum install php php-cli php-fpm php-mysqlnd php-mbstring php-xml php-curl php-zip php-gd php-bcmath

检查：

php -v

三、Composer 安装

curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
composer -v

⚠️ 注意：

• composer 需要 PHP ≥ 7.2
• 国内服务器建议配置镜像：

composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/

四、必要 PHP 扩展（Laravel 必用）

php-mbstring
php-xml
php-curl
php-zip
php-gd
php-bcmath
php-openssl（默认有）

少一个都可能报：

Class ‘XXX’ not found

五、目录权限（最容易踩坑）

Laravel 需要写：

storage
bootstrap/cache

✅ 正确做法（不要用 777）：

chown -R nginx:nginx /var/www/laravel
chmod -R 755 /var/www/laravel
chmod -R 775 storage bootstrap/cache

如果你用 php artisan serve 测试，也要确保当前用户有权限。

六、Web 服务器（Nginx 推荐）

Nginx + PHP-FPM

yum install nginx
systemctl enable --now nginx php-fpm

Nginx 配置要点

server {
    root /var/www/laravel/public;
    index index.php;

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

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

⚠️ 注意：

• root 必须指向 public
• SELinux 可能拦截：

setsebool -P httpd_read_user_content 1

七、SELinux（CentOS 特有坑）

报错常见于：

• 502
• Permission denied
• 无法写 storage

查看：

getenforce

临时关闭（不推荐长期）：

setenforce 0

正确做法：

semanage fcontext -a -t httpd_sys_rw_content_t "/var/www/laravel/storage(/.*)?"
restorecon -Rv /var/www/laravel

八、防火墙

firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --reload

九、.env 与 key

cp .env.example .env
php artisan key:generate

⚠️ 生产环境：

• APP_DEBUG=false
• APP_ENV=production

十、常见错误速查

总结一句话

CentOS 装 Laravel = 新 PHP + Composer + 正确权限 + Nginx + SELinux

如果你愿意，我可以：

• 给你一份 CentOS 9 + Laravel 11 完整脚本
• 或针对 Docker / 宝塔 / 云服务器 给方案