温馨提示×

centos怎样部署laravel

小樊
59
2026-09-02 19:08:21
栏目: 智能运维

下面给你一套在 CentOS 上部署 Laravel 的完整常见方案(以 CentOS 7/8 + Nginx + PHP + MySQL 为例,适合生产环境)。


一、环境准备

1. 更新系统

sudo yum update -y

2. 安装必要工具

sudo yum install -y git unzip wget curl

二、安装 PHP(Laravel 需要 PHP 8.0+)

1. 添加 Remi 源(推荐)

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

2. 启用 PHP 8.1

sudo yum-config-manager --enable remi-php81

3. 安装 PHP 及扩展

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

4. 验证

php -v

三、安装 Composer

cd /tmp
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
sudo mv composer.phar /usr/local/bin/composer
composer -V

四、安装 Nginx

sudo yum install -y nginx
sudo systemctl enable nginx
sudo systemctl start nginx

五、安装 MySQL(可选,也可用 SQLite)

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

创建数据库:

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

六、部署 Laravel 项目

1. 上传或克隆代码

cd /var/www
git clone your_repo laravel
# 或上传 zip 解压

2. 安装依赖

cd /var/www/laravel
composer install --optimize-autoloader --no-dev

3. 配置环境

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

编辑 .env:

APP_ENV=production
APP_DEBUG=false
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/laravel
sudo chmod -R 755 /var/www/laravel
sudo chmod -R 777 /var/www/laravel/storage

七、配置 Nginx

sudo vi /etc/nginx/conf.d/laravel.conf

示例配置:

server {
    listen 80;
    server_name your_domain.com;

    root /var/www/laravel/public;
    index index.php index.html;

    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;
    }
}

重启 Nginx:

sudo nginx -t
sudo systemctl restart nginx

八、配置 PHP-FPM

sudo vi /etc/php-fpm.d/www.conf

确保:

user = nginx
group = nginx
sudo systemctl restart php-fpm

九、生产优化(重要)

php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan migrate --force

十、防火墙 & SELinux

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

如访问异常:

sudo setsebool -P httpd_read_user_content 1

十一、常见错误排查

问题 解决
500 错误 看 storage/logs/laravel.log
权限问题 storage 目录权限
空白页 APP_DEBUG=true 看错误
502 php-fpm 未启动或 sock 路径错

如果你愿意,我可以:

  • 给你 CentOS 8 / Stream 版本
  • 用 Docker 部署 Laravel
  • 配置 HTTPS(Let’s Encrypt)
  • 或写一份 一键部署脚本

你现在是 本地测试还是服务器生产环境?

0 踩