Laravel项目怎么部署到Linux_Laravel Nginx配置详解-Laravel-PHP中文网

Laravel项目怎么部署到Linux_Laravel Nginx配置详解

尼克

发布： 2025-12-05 14:27:07

原创

493人浏览过

部署Laravel项目到Linux服务器需先配置环境，安装PHP、Nginx、数据库等组件，再部署代码并设置依赖与密钥。1. 安装必要软件如PHP 8.1、Composer、Nginx和MySQL；2. 将项目克隆至/var/www/laravel-app并运行composer install；3. 配置Nginx虚拟主机指向public目录，设置location规则支持Laravel路由；4. 调整文件权限为www-data用户，避免使用777；5. 可选启用HTTPS通过Certbot获取SSL证书。完成后重启Nginx即可访问应用，出错时可通过error.log排查问题。

laravel项目怎么部署到linux_laravel nginx配置详解

将Laravel项目部署到Linux服务器并配置Nginx，是上线PHP应用的关键步骤。整个过程包括环境准备、代码部署、Web服务器配置和权限设置等。下面以常见的Ubuntu系统为例，详细介绍如何完成Laravel项目的部署与Nginx配置。

1. 准备Linux服务器环境

确保你的Linux服务器（如Ubuntu 20.04/22.04）已安装以下基础组件：

PHP 8.0+：Laravel要求的最低版本，建议使用PHP 8.1或更高
Composer：用于安装PHP依赖
Nginx：作为Web服务器
MySQL/MariaDB 或 PostgreSQL：数据库服务
Git（可选）：用于拉取代码

安装命令示例（Ubuntu）：

sudo apt update
sudo apt install nginx mysql-server php-fpm php-mysql php-cli php-curl php-mbstring php-xml php-zip git composer

检查PHP-FPM是否运行：

sudo systemctl status php8.1-fpm

2. 部署Laravel项目代码

将Laravel项目上传到服务器的网站目录，通常为 /var/www/html 或自定义路径如 /var/www/laravel-app。

通过Git克隆或直接上传代码包：

cd /var/www
sudo git clone https://your-repo/laravel-app.git laravel-app

进入项目目录，安装依赖：

cd /var/www/laravel-app
sudo composer install --optimize-autoloader --no-dev

生成应用密钥：

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

配置好数据库连接信息（修改 .env 文件中的 DB_HOST、DB_DATABASE 等）。

运行迁移（可选）：

Riffo

Riffo是一个免费的文件智能命名和管理工具

216

查看详情

php artisan migrate --force

设置存储链接：

php artisan storage:link

3. 配置Nginx虚拟主机

Laravel推荐将Web根目录指向 public 目录。创建Nginx配置文件：

sudo nano /etc/nginx/sites-available/laravel-app

写入以下配置内容（根据实际情况修改域名和路径）：

server {
listen 80;
server_name your-domain.com;
root /var/www/laravel-app/public;

index index.php index.html index.htm;

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

location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}

location ~ /\.ht {
deny all;
}
}

启用站点：

sudo ln -s /etc/nginx/sites-available/laravel-app /etc/nginx/sites-enabled/
sudo nginx -t # 测试配置是否正确
sudo systemctl reload nginx

4. 设置文件权限和安全

确保Web服务器（www-data）有正确权限访问Laravel目录：

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

不要给整个项目777权限，这会带来安全风险。

如果你使用HTTPS，可通过Let's Encrypt免费获取SSL证书：

sudo certbot --nginx -d your-domain.com

证书会自动配置到Nginx，并开启HTTPS。

基本上就这些。部署完成后，访问你的域名，应该能看到Laravel欢迎页或应用首页。如果遇到问题，查看Nginx错误日志定位原因：

sudo tail -f /var/log/nginx/error.log

以上就是Laravel项目怎么部署到Linux_Laravel Nginx配置详解的详细内容，更多请关注php中文网其它相关文章！