部署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_HOST、DB_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
以上就是Laravel项目怎么部署到Linux_Laravel Nginx配置详解的详细内容,更多请关注php中文网其它相关文章!