温馨提示×

centos下laravel怎么部署

小樊
37
2026-09-11 18:05:07
栏目: 智能运维

下面按生产环境常见做法,给你一套在 CentOS 下部署 Laravel 的完整流程(以 CentOS 7/8 + Nginx + PHP-FPM 为例)。


一、环境准备

1. 更新系统

sudo yum update -y

2. 安装必要组件

sudo yum install -y epel-release
sudo yum install -y nginx git unzip

二、安装 PHP(推荐 PHP 8.1+)

1. 添加 Remi 源(CentOS 7)

sudo yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
sudo yum-config-manager --enable remi-php81

CentOS 8 可用 dnf

2. 安装 PHP 及扩展

sudo yum install -y php php-cli php-fpm php-mysqlnd \
php-zip php-gd php-mbstring php-curl php-xml php-bcmath

3. 启动 PHP-FPM

sudo systemctl start php-fpm
sudo systemctl enable php-fpm

三、安装 Composer

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

四、部署 Laravel 项目

1. 克隆项目

cd /var/www
git clone your-repo.git example.com
cd example.com

2. 安装依赖

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

3. 配置环境

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

编辑 .env

APP_ENV=production
APP_DEBUG=false
APP_URL=http://example.com

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

4. 权限设置(非常重要)

sudo chown -R nginx:nginx /var/www/example.com
sudo chmod -R 755 /var/www/example.com
sudo chmod -R 775 storage bootstrap/cache

五、配置 Nginx

1. 新建站点配置

sudo vi /etc/nginx/conf.d/example.com.conf

示例配置:

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

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";

    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 $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

2. 检查并重启 Nginx

sudo nginx -t
sudo systemctl restart nginx
sudo systemctl enable nginx

六、数据库(MySQL / MariaDB)

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

创建数据库:

CREATE DATABASE laravel;
CREATE USER 'laravel'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON laravel.* TO 'laravel'@'localhost';
FLUSH PRIVILEGES;

执行迁移:

php artisan migrate --force

七、优化(生产必做)

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

八、常见问题

1. 500 错误

tail -f /var/www/example.com/storage/logs/laravel.log

2. 权限错误

sudo chown -R nginx:nginx storage

3. 使用 HTTPS(推荐)

sudo yum install -y certbot python3-certbot-nginx
sudo certbot --nginx -d example.com

九、可选(进阶)

  • 使用 Supervisor 管理队列
  • 使用 Redis 做缓存 / 队列
  • 使用 GitHub Actions / GitLab CI 自动部署

如果你告诉我:

  • CentOS 版本(7 / 8 / Stream)
  • PHP 版本需求
  • 是否用 MySQL / PostgreSQL
  • 是否要 HTTPS / 队列 / 定时任务

我可以给你更精确的部署方案

0