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

发布时间 - 2025-12-05 00:00:00    点击率:
部署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服务器并配置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 等)。

运行迁移(可选):

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


# mysql  # php  # linux  # laravel  # html  # bootstrap  # git  # composer  # php8  # nginx  # include  # xml  # cURL  # Error  # public  # var  # location  # postgresql  # 数据库  # mariadb  # https  # ssl  # ubuntu  # unix  # 可选  # 可通过  # 虚拟主机  # 如果你  # 完成后  # 自定义  # 详细介绍  # 实际情况  # 为例  # 要给 


相关栏目: 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571


相关推荐: 微信小程序 配置文件详细介绍  JS碰撞运动实现方法详解  如何快速查询网址的建站时间与历史轨迹?  Laravel如何使用Scope本地作用域_Laravel模型常用查询逻辑封装技巧【手册】  Python文件流缓冲机制_IO性能解析【教程】  浏览器如何快速切换搜索引擎_在地址栏使用不同搜索引擎【搜索】  如何在IIS管理器中快速创建并配置网站?  详解CentOS6.5 安装 MySQL5.1.71的方法  Laravel Telescope怎么调试_使用Laravel Telescope进行应用监控与调试  HTML5空格在Angular项目里怎么处理_Angular中空格的渲染问题【详解】  Laravel如何清理系统缓存命令_Laravel清除路由配置及视图缓存的方法【总结】  谷歌浏览器下载文件时中断怎么办 Google Chrome下载管理修复  如何在IIS中新建站点并解决端口绑定冲突?  Laravel如何升级到最新版本?(升级指南和步骤)  如何在橙子建站上传落地页?操作指南详解  Laravel用户认证怎么做_Laravel Breeze脚手架快速实现登录注册功能  Laravel如何使用Facades(门面)及其工作原理_Laravel门面模式与底层机制  如何在阿里云ECS服务器部署织梦CMS网站?  Android GridView 滑动条设置一直显示状态(推荐)  ChatGPT 4.0官网入口地址 ChatGPT在线体验官网  小视频制作网站有哪些,有什么看国内小视频的网站,求推荐?  如何在阿里云高效完成企业建站全流程?  laravel怎么配置Redis作为缓存驱动_laravel Redis缓存配置教程  如何快速生成凡客建站的专业级图册?  Win11怎么关闭专注助手 Win11关闭免打扰模式设置【操作】  googleplay官方入口在哪里_Google Play官方商店快速入口指南  JavaScript如何操作视频_媒体API怎么控制播放  Laravel怎么创建自己的包(Package)_Laravel扩展包开发入门到发布  用v-html解决Vue.js渲染中html标签不被解析的问题  PythonWeb开发入门教程_Flask快速构建Web应用  如何基于云服务器快速搭建网站及云盘系统?  JavaScript如何实现路由_前端路由原理是什么  Python文本处理实践_日志清洗解析【指导】  javascript读取文本节点方法小结  Laravel如何处理跨站请求伪造(CSRF)保护_Laravel表单安全机制与令牌校验  网站制作壁纸教程视频,电脑壁纸网站?  Android自定义控件实现温度旋转按钮效果  Win11怎么开启自动HDR画质_Windows11显示设置HDR选项  香港服务器建站指南:外贸独立站搭建与跨境电商配置流程  Laravel Asset编译怎么配置_Laravel Vite前端构建工具使用  Laravel Eloquent:优雅地将关联模型字段扁平化到主模型中  详解Oracle修改字段类型方法总结  大同网页,大同瑞慈医院官网?  免费的流程图制作网站有哪些,2025年教师初级职称申报网上流程?  中国移动官方网站首页入口 中国移动官网网页登录  Laravel如何使用Service Provider服务提供者_Laravel依赖注入与容器绑定【深度】  php中::能调用final静态方法吗_final修饰静态方法调用规则【解答】  海南网站制作公司有哪些,海口网是哪家的?  悟空浏览器如何设置小说背景色_悟空浏览器背景色设置【方法】  在centOS 7安装mysql 5.7的详细教程