温馨提示×

centos怎么配置laravel环境

小樊
40
2026-08-03 10:30:34
栏目: 智能运维

下面给你一套在 CentOS 上配置 Laravel 运行环境的常见、稳定方案(以 CentOS 7/8 + Nginx + PHP + MySQL 为例)。
如果你用的是 CentOS Stream / Rocky / Alma,步骤基本一致。


一、系统准备

1. 更新系统

yum update -y

2. 安装常用工具

yum install -y wget curl git unzip

二、安装 Nginx

yum install -y nginx
systemctl start nginx
systemctl enable nginx

验证:

nginx -v

三、安装 PHP(推荐 PHP 8.1 / 8.2)

Laravel 10+ 要求 PHP ≥ 8.1

1. 添加 Remi 源(CentOS 7)

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

2. 启用 PHP 8.2

yum install -y yum-utils
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-intl 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

初始化:

mysql_secure_installation

创建 Laravel 数据库:

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;

五、安装 Composer

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

验证:

composer -V

六、部署 Laravel 项目

1. 创建项目目录

mkdir -p /var/www
cd /var/www

2. 使用 Composer 创建项目

composer create-project laravel/laravel example-app

或克隆已有项目:

git clone your_project.git
cd your_project
composer install

3. 配置环境

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

修改 .env

DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=password

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

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

七、配置 Nginx

编辑配置:

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

示例配置:

server {
    listen 80;
    server_name your_domain_or_ip;

    root /var/www/example-app/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;
    }
}

重启 Nginx:

nginx -t
systemctl restart nginx

八、防火墙放行

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

九、测试

浏览器访问:

http://服务器IP

看到 Laravel 欢迎页即成功 ✅


十、常见问题

1. 502 Bad Gateway

  • 检查 php-fpm 是否运行
  • 检查 fastcgi_pass socket 路径

2. 权限问题

chown -R nginx:nginx /var/www/example-app

3. PHP 版本过低

php -v

Laravel 10+ 需要 PHP ≥ 8.1


如果你愿意,可以告诉我:

  • ✅ CentOS 版本(7 / 8 / Stream)
  • ✅ Laravel 版本
  • ✅ 是否用 Docker / 宝塔 / 云服务器

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

0