CentOS Laravel怎么配置

下面以 CentOS 7/8 + Nginx + PHP + MySQL（或 MariaDB） 为例，给你一套完整、常用的 Laravel 配置流程。如果你用的是 Apache 或 CentOS 版本不同，也可以再告诉我。

一、环境准备

1. 更新系统

sudo yum update -y

二、安装 Nginx

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

验证：

systemctl status nginx

浏览器访问服务器 IP，看到 Nginx 欢迎页说明成功。

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

1. 添加 Remi 源（CentOS 7）

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

2. 安装 PHP 及扩展

sudo yum install -y yum-utils
sudo yum-config-manager --enable remi-php82
sudo yum install -y php php-cli php-fpm php-mysql php-xml php-mbstring php-curl php-zip php-gd php-json

3. 配置 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 start 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;
CREATE USER 'laravel'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON laravel.* TO 'laravel'@'localhost';
FLUSH PRIVILEGES;

五、安装 Composer

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

六、部署 Laravel 项目

1. 安装 Git（如果没有）

sudo yum install -y git

2. 拉取项目

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

3. 安装依赖

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

4. 配置环境

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

编辑 .env：

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

5. 权限设置（非常重要）

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

七、配置 Nginx（重点）

编辑 Nginx 配置：

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

示例配置：

server {
    listen 80;
    server_name your_domain_or_ip;

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

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

重启 Nginx：

sudo systemctl restart nginx

八、测试 Laravel

php artisan migrate

浏览器访问服务器 IP，能看到 Laravel 页面即成功 ✅

九、常见问题排查

1. 500 错误

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

2. 权限问题

sudo chown -R nginx:nginx /var/www/laravel

3. PHP 不解析

检查 php-fpm 是否运行
检查 fastcgi_pass 路径是否正确

十、可选优化

php artisan config:cache
php artisan route:cache

如果你告诉我：

✅ CentOS 7 还是 8 / Stream
✅ Apache 还是 Nginx
✅ Laravel 版本

我可以给你更精确的配置方案。