0

0

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

尼克

尼克

发布时间:2025-12-05 14:27:07

|

537人浏览过

|

来源于php中文网

原创

部署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_HOSTDB_DATABASE 等)。

运行迁移(可选):

Figma Slides
Figma Slides

Figma Slides 是 Figma 发布的PPT制作和演示文稿生成工具,可以帮助创建、设计、定制和分享演示文稿

下载
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

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2513

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1597

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1491

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

952

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1416

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1234

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1445

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1306

2023.11.13

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

36

2026.01.14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 1.8万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 792人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号