温馨提示×

centos下laravel如何配置环境

小樊
33
2026-10-17 11:33:35
栏目: 智能运维

在 CentOS 下配置 Laravel 运行环境,通常包含以下几个核心步骤:
PHP + Composer + Nginx/Apache + MySQL + Laravel 项目配置

下面以 CentOS 7/8 + PHP 8.1 + Nginx + MySQL 为例说明。


一、系统更新

sudo yum update -y

二、安装 PHP(Laravel 需要 PHP 8.0+)

1. 添加 Remi 源(推荐)

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

2. 安装 PHP 及常用扩展

sudo yum install -y yum-utils
sudo yum-config-manager --enable remi-php81
sudo yum install -y php php-cli php-fpm php-mysqlnd php-zip php-gd php-mbstring php-curl php-xml php-bcmath php-json

3. 验证

php -v

三、安装 Composer

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

四、安装 Nginx

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

五、安装 MySQL(或 MariaDB)

MySQL 示例

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

创建数据库:

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

六、部署 Laravel 项目

1. 上传或克隆项目

cd /var/www
git clone your-laravel-project.git
cd your-laravel-project

2. 安装依赖

composer install

3. 配置环境

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
DB_USERNAME=laravel
DB_PASSWORD=password

4. 权限设置

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

七、配置 Nginx

编辑:

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

示例配置:

server {
    listen 80;
    server_name your-domain.com;
    root /var/www/your-laravel-project/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:

sudo systemctl restart nginx

八、启动 PHP-FPM

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

九、防火墙(如有)

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

十、常见问题排查

  • 500 错误:检查 storage 权限
  • No input file:Nginx root 指向 public
  • Composer 内存不足:
php -d memory_limit=-1 composer install

如果你告诉我:

  • CentOS 版本(7 / 8 / Stream)
  • 使用 Nginx 还是 Apache
  • Laravel 版本

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

0 踩