温馨提示×

linux laravel怎么配置环境

小樊
49
2026-09-19 08:26:46
栏目: 智能运维

下面给你一份在 Linux 上配置 Laravel 运行环境的常见、实用方案(以 Ubuntu / Debian 为例,CentOS 类似)。


一、安装基础环境(LNMP / LAMP)

Laravel 需要:

  • PHP ≥ 8.1(推荐 8.2 / 8.3)
  • Composer
  • 数据库(MySQL / PostgreSQL / SQLite)
  • Web 服务器(Nginx 或 Apache)

二、安装 PHP 及扩展

1. 添加 PHP 源(Ubuntu)

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

2. 安装 PHP 及 Laravel 所需扩展

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

查看 PHP 版本:

php -v

三、安装 Composer

cd /tmp
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 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
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;

    index index.php;

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

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }
}
sudo nginx -t
sudo systemctl restart nginx

六、部署 Laravel 项目

1. 创建项目

composer create-project laravel/laravel example-app

或 clone 已有项目:

git clone repo.git
cd project
composer install

2. 配置环境

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

编辑 .env:

APP_NAME=Laravel
APP_ENV=local
APP_KEY=base64:xxxx
APP_DEBUG=true

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

3. 权限设置

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

七、运行与测试

php artisan migrate
php artisan serve

或访问:

http://your-server-ip

八、常见问题

✅ 500 错误

  • 查看 storage/logs/laravel.log
  • 检查权限 & .env

✅ Composer 内存不足

php -d memory_limit=-1 composer install

✅ 生产环境

  • APP_ENV=production
  • APP_DEBUG=false
  • 使用 Nginx + PHP-FPM

如果你用的是 CentOS / Rocky / Alma / Docker / 宝塔,可以告诉我,我可以给你对应版本配置。

0 踩