温馨提示×

centos上laravel怎样配置

小樊
45
2026-09-14 22:57:50
栏目: 智能运维

下面按在 CentOS 上从零配置 Laravel 运行环境的思路,给你一份实用、可落地的配置指南(以 CentOS 7/8 + PHP 8.x + Nginx + MySQL 为例,Laravel 9/10/11 通用)。


一、系统准备

sudo yum update -y
sudo yum install -y epel-release

二、安装 Nginx

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

三、安装 PHP(以 PHP 8.1 为例)

1. 添加 Remi 源

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

2. 安装 PHP 及扩展

sudo yum module reset php -y
sudo yum module enable php:remi-8.1 -y

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

3. 启动 PHP-FPM

sudo systemctl enable php-fpm
sudo systemctl start php-fpm

四、安装 Composer

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

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

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

创建数据库:

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

六、部署 Laravel 项目

cd /var/www
composer create-project laravel/laravel demo

或上传已有项目:

unzip laravel.zip -d /var/www/demo
cd /var/www/demo
composer install

配置权限(非常重要)

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

七、配置 .env

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

示例数据库配置:

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

八、配置 Nginx(关键)

编辑:

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

示例配置:

server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/demo/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 ~ /\.(?!well-known).* {
        deny all;
    }
}

重启 Nginx:

sudo nginx -t
sudo systemctl restart nginx

九、防火墙 & SELinux

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

SELinux(如报错):

sudo setsebool -P httpd_read_user_content 1
sudo setsebool -P httpd_can_network_connect_db 1

十、验证

浏览器访问:

http://服务器IP

看到 Laravel 欢迎页即成功 ✅


常见问题速查

问题 解决
500 错误 看 storage/logs/laravel.log
权限问题 检查 storage / bootstrap 权限
502 php-fpm 未启动或 sock 路径错
路由 404 Nginx try_files 配错

如果你愿意,我可以:

  • 给你 CentOS + Laravel + Supervisor 队列配置
  • 或 Laravel + HTTPS(Let’s Encrypt)
  • 或 Docker 方式部署 Laravel

你当前是 新项目还是已有项目迁移?CentOS 几?

0 踩