CentOS如何运行Laravel项目

在 CentOS 上运行 Laravel 项目，一般流程如下（以 CentOS 7/8 + Nginx + PHP + MySQL 为例，适用于大多数情况）：

一、环境准备

1️⃣ 更新系统

sudo yum update -y

二、安装 Nginx

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

启动并设置开机自启：

sudo systemctl start nginx
sudo systemctl enable nginx

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

1️⃣ 添加 Remi 源（CentOS 7）

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

2️⃣ 启用 PHP 8.2

sudo yum install -y yum-utils
sudo yum-config-manager --enable remi-php82

3️⃣ 安装 PHP 及扩展

sudo yum install -y php php-cli php-fpm php-mysql php-mbstring php-xml php-curl php-zip php-gd php-json php-tokenizer

检查版本：

php -v

四、配置 PHP-FPM

编辑配置文件：

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

确认以下配置（重要）：

user = nginx
group = nginx
listen = /run/php-fpm/www.sock
listen.owner = nginx
listen.group = nginx

重启 PHP-FPM：

sudo systemctl restart php-fpm
sudo systemctl enable php-fpm

五、安装 MySQL（或 MariaDB）

安装 MariaDB（推荐）

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

初始化数据库：

sudo mysql_secure_installation

创建数据库：

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

六、安装 Composer

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

七、部署 Laravel 项目

1️⃣ 上传或克隆项目

cd /var/www
git clone https://github.com/your/laravel-project.git

或上传压缩包并解压。

2️⃣ 安装依赖

cd laravel-project
composer install --no-dev --optimize-autoloader

3️⃣ 配置环境文件

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

编辑数据库配置：

DB_DATABASE=laravel_db
DB_USERNAME=laravel_user
DB_PASSWORD=password

4️⃣ 权限设置（非常重要）

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

八、配置 Nginx

新建配置文件：

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

示例配置：

server {
    listen 80;
    server_name your_domain_or_ip;

    root /var/www/laravel-project/public;
    index index.php index.html index.htm;

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

测试并重载 Nginx：

sudo nginx -t
sudo systemctl reload nginx

九、运行 Laravel

执行数据库迁移

php artisan migrate

访问项目

浏览器访问：

http://服务器IP

十、常见坑位排查

❌ 502 Bad Gateway
→ PHP-FPM 未启动或 sock 权限错误

❌ permission denied
→ storage / bootstrap/cache 权限未设置

❌ PHP 扩展缺失

php -m

十一、可选优化

安装 Redis：yum install redis
使用 Supervisor 管理队列
配置 HTTPS（Let’s Encrypt）

如果你用的是 CentOS 8 / Rocky / AlmaLinux、PHP 版本不同 或 Apache，我可以给你针对性方案。