温馨提示×

CentOS怎么搭建Laravel环境

小樊
45
2026-08-29 16:25:43
栏目: 智能运维

下面给你一套在 CentOS(以 CentOS 7 / 8 为例)上搭建 Laravel 运行环境的完整流程和注意事项,适合新手一步步操作。


一、准备环境

1️⃣ 系统更新

yum update -y

2️⃣ 安装常用工具

yum install -y wget curl unzip git

二、安装 LNMP / LAMP(推荐 LNMP)

Laravel 通常需要:

  • Nginx / Apache
  • PHP(8.0+ 推荐)
  • MySQL / MariaDB
  • Composer

三、安装 PHP(重点)

✅ 1. 安装 EPEL 和 Remi 源(CentOS 7)

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

✅ 2. 启用 PHP 8.1(示例)

yum install -y yum-utils
yum-config-manager --enable remi-php81

✅ 3. 安装 PHP 及 Laravel 所需扩展

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

检查版本:

php -v

四、安装 Composer

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

验证:

composer -V

五、安装 Nginx

1️⃣ 安装

yum install -y nginx

2️⃣ 启动并设置开机自启

systemctl start nginx
systemctl enable nginx

3️⃣ 配置 Nginx 支持 Laravel

编辑配置文件:

vim /etc/nginx/conf.d/laravel.conf

示例配置:

server {
    listen 80;
    server_name your_domain_or_ip;

    root /var/www/laravel/public;
    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 $document_root$fastcgi_script_name;
        include        fastcgi_params;
    }
}

4️⃣ 重启 Nginx

systemctl restart nginx

六、安装 MySQL / MariaDB

✅ 安装 MariaDB(推荐)

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

✅ 初始化数据库

mysql_secure_installation

✅ 创建 Laravel 数据库

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

七、部署 Laravel 项目

1️⃣ 创建项目目录

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

2️⃣ 用 Composer 创建 Laravel 项目

composer create-project laravel/laravel .

或指定版本:

composer create-project laravel/laravel=10.* .

八、配置 Laravel

1️⃣ 配置 .env

cp .env.example .env
vim .env

修改数据库部分:

DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=password

2️⃣ 生成 APP_KEY

php artisan key:generate

3️⃣ 设置权限

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

九、启动 PHP-FPM

systemctl start php-fpm
systemctl enable php-fpm

十、测试访问

浏览器访问:

http://服务器IP

看到 Laravel 欢迎页 ✅ 成功!


十一、常见问题

❌ 403 Forbidden

  • root 路径是否正确
  • 权限是否给 nginx

❌ 500 错误

tail -f storage/logs/laravel.log

❌ PHP 版本过低

Laravel 9+ 需要 PHP ≥ 8.0


十二、可选优化

  • ✅ 开启 HTTPS(Certbot)
  • ✅ 安装 Redis
  • ✅ 使用 Supervisor 管理队列
  • ✅ 使用 Docker(生产环境推荐)

如果你愿意,我可以:

  • ✅ 帮你写 一键自动化脚本
  • ✅ 给你 CentOS 8 / Rocky / AlmaLinux 版本
  • ✅ 用 Docker + Laravel 方案

告诉我你现在用的是 CentOS 几?

0