温馨提示×

linux laravel如何配置环境

小樊
44
2026-10-24 19:15:17
栏目: 智能运维

下面按最常见的 Linux 服务器(Ubuntu / CentOS 类似)给你一份Laravel 环境配置实战指南,从零到可运行项目。


一、系统准备(以 Ubuntu 为例)

sudo apt update
sudo apt upgrade -y

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

1. 添加 PHP 源(Ubuntu 默认版本可能偏低)

sudo apt install -y software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update

2. 安装 PHP 及必要扩展

sudo apt install -y php8.2 php8.2-cli php8.2-fpm \
php8.2-mysql php8.2-pgsql php8.2-sqlite3 \
php8.2-mbstring php8.2-xml php8.2-curl \
php8.2-zip php8.2-gd php8.2-bcmath

✅ 验证:

php -v

三、安装 Composer(Laravel 依赖管理)

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

✅ 验证:

composer -V

四、安装数据库(MySQL 示例)

sudo apt install -y mysql-server
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;

五、安装 Nginx(推荐)

sudo apt install -y nginx

Nginx 配置示例

server {
    listen 80;
    server_name example.com;
    root /var/www/laravel/public;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";

    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}
sudo nginx -t
sudo systemctl restart nginx

六、部署 Laravel 项目

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

或已有项目:

git clone your_repo laravel
cd laravel
composer install

七、配置 .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
DB_USERNAME=laravel
DB_PASSWORD=password

八、权限设置(非常重要)

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

九、运行迁移

php artisan migrate

十、常用命令

php artisan serve        # 本地开发
php artisan config:clear
php artisan cache:clear
php artisan queue:work

十一、可选(生产环境)

  • ✅ HTTPS(Certbot)
  • ✅ Supervisor(队列)
  • ✅ Redis(缓存 / 队列)
  • ✅ Laravel Octane(性能)

如果你告诉我:

  • 用的是 Ubuntu / CentOS / AlmaLinux
  • 是否 Docker / 宝塔 / 云服务器
  • Laravel 版本

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

0 踩