CentOS下Laravel如何部署

下面给你一套在 CentOS 上部署 Laravel 项目的完整流程，适用于 CentOS 7 / 8 / Stream，涵盖环境准备、部署、权限、队列、定时任务等常见场景。

一、环境准备

1. 系统更新

yum update -y

二、安装 LNMP / LAMP 环境

方案一（推荐）：Nginx + PHP + MySQL

三、安装 Nginx

1. 安装 EPEL 源

yum install -y epel-release

2. 安装 Nginx

yum install -y nginx

3. 启动并设置开机自启

systemctl start nginx
systemctl enable nginx

四、安装 PHP（推荐 PHP 8.1 / 8.2）

1. 添加 Remi 源

yum install -y yum-utils
yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm

2. 启用 PHP 8.2

yum-config-manager --enable remi-php82

3. 安装 PHP 及扩展

yum install -y php \
php-cli \
php-fpm \
php-common \
php-mysql \
php-pdo \
php-mbstring \
php-xml \
php-curl \
php-zip \
php-gd \
php-opcache \
php-redis \
php-bcmath

4. 启动 PHP-FPM

systemctl start php-fpm
systemctl enable php-fpm

五、安装 MySQL / MariaDB

1. 安装 MariaDB（推荐）

yum install -y mariadb mariadb-server
systemctl start mariadb
systemctl enable mariadb

2. 初始化数据库

mysql_secure_installation

3. 创建数据库

CREATE DATABASE laravel CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'laravel'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON laravel.* TO 'laravel'@'localhost';
FLUSH PRIVILEGES;

六、部署 Laravel 项目

1. 安装 Composer

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

2. 拉取项目代码

cd /var/www
git clone https://github.com/yourname/laravel.git
cd laravel

3. 安装依赖

composer install --no-dev --optimize-autoloader

七、配置 Laravel

1. 配置环境文件

cp .env.example .env

编辑 .env：

APP_ENV=production
APP_DEBUG=false
APP_URL=http://your_domain

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=password

2. 生成 APP_KEY

php artisan key:generate

3. 数据库迁移

php artisan migrate --force

4. 存储目录权限（非常重要）

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

八、配置 Nginx

1. 新建站点配置

vim /etc/nginx/conf.d/laravel.conf

2. 示例配置

server {
    listen 80;
    server_name your_domain.com;

    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;
        fastcgi_param  SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}

3. 重载 Nginx

nginx -t
systemctl reload nginx

九、配置 PHP-FPM 用户（重要）

编辑：

vim /etc/php-fpm.d/www.conf

确认：

user = nginx
group = nginx

重启：

systemctl restart php-fpm

十、队列 & 定时任务（生产必备）

1. 队列

php artisan queue:work --daemon

使用 Supervisor 管理（推荐）：

yum install -y supervisor

配置示例：

[program:laravel-worker]
command=php /var/www/laravel/artisan queue:work --sleep=3 --tries=3
autostart=true
autorestart=true
user=nginx

2. 定时任务（调度器）

crontab -e

* * * * * php /var/www/laravel/artisan schedule:run >> /dev/null 2>&1

十一、防火墙 & SELinux

1. 开放端口

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

2. SELinux（可选关闭）

setenforce 0

或放行 Nginx：

setsebool -P httpd_read_user_content 1

十二、常见问题排查

十三、推荐生产优化

php artisan config:cache
php artisan route:cache
php artisan view:cache

如果你愿意，我可以：

• ✅ 给你 CentOS 7 / 8 专用脚本
• ✅ 对接 Docker 部署
• ✅ 配置 HTTPS（Let’s Encrypt）
• ✅ 排查你当前报错

直接把你的 CentOS 版本 + Laravel 版本 发我即可。