LNMP环境部署Laravel详细步骤

作者:技术拾光

时间:2026-05-08

浏览:458

在LNMP环境中部署Laravel应用,需依次安装Nginx、MySQL、PHP及必要扩展。关键步骤包括配置PHP-FPM与Nginx服务器块,上传项目代码并设置文件权限。随后创建数据库,配置Laravel的.env文件,运行数据库迁移并安装Composer依赖。最后可选用Let'sEncrypt配置SSL证书以启用HTTPS。

文章目录

在LNMP(Linux, Nginx, MySQL, PHP)技术栈上部署Laravel应用,是开发者将项目从本地迁移到生产环境的关键环节。虽然步骤较多,但只要遵循清晰的流程,就能高效完成。本文将详细介绍在LNMP环境中部署Laravel应用的核心步骤。

LNMP环境部署Laravel详细步骤

1. 安装Nginx

首先,确保服务器已安装Nginx。若未安装,可通过以下命令快速安装:

sudo apt update
sudo apt install nginx

2. 安装MySQL

接下来,安装MySQL数据库服务器,为Laravel应用提供数据存储支持:

sudo apt update
sudo apt install mysql-server

3. 安装PHP

Laravel基于PHP构建,需安装PHP及其必要扩展,以确保框架功能完整运行:

sudo apt update
sudo apt install php-fpm php-mysql php-zip php-gd php-mbstring php-curl php-xml php-pear php-bcmath

4. 配置PHP-FPM

为使Nginx正确处理PHP请求,需配置PHP-FPM。编辑其配置文件,确保监听方式正确:

sudo nano /etc/php/7.4/fpm/pool.d/www.conf

找到以下行并进行修改:

;listen = /run/php/php7.4-fpm.sock
listen = /tmp/php-cgi.sock

修改完成后,重启PHP-FPM服务使配置生效:

sudo systemctl restart php7.4-fpm

5. 配置Nginx

此步骤为Laravel应用创建Nginx服务器块(虚拟主机)。创建新的配置文件:

sudo nano /etc/nginx/sites-a vailable/yourdomain.com

粘贴以下配置内容,注意将`yourdomain.com`替换为实际域名,并确认网站根目录路径正确:

server {
    listen 80;
    server_name yourdomain.com www.yourdomain.com;
    root /var/www/yourdomain.com/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:/tmp/php-cgi.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

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

随后,启用配置文件并测试Nginx配置是否正确:

sudo ln -s /etc/nginx/sites-a vailable/yourdomain.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl restart nginx

6. 部署Laravel应用程序

将Laravel项目代码上传至服务器预设目录,如`/var/www/yourdomain.com`。可使用FTP、SCP或Git等方式进行上传。

7. 设置文件权限

正确的文件权限对Web应用的安全和运行至关重要。运行以下命令,将网站目录所有权赋予Web服务器用户(通常为www-data),并设置合理权限:

sudo chown -R www-data:www-data /var/www/yourdomain.com
sudo find /var/www/yourdomain.com -type f -exec chmod 644 {} \;
sudo find /var/www/yourdomain.com -type d -exec chmod 755 {} \;

8. 配置数据库

登录MySQL,为Laravel应用创建专用数据库和用户,并授予相应权限:

CREATE DATABASE laravel_db;
CREATE USER 'laravel_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON laravel_db.* TO 'laravel_user'@'localhost';
FLUSH PRIVILEGES;

9. 配置Laravel

进入Laravel项目目录,编辑`.env`文件,填入已创建的数据库连接信息:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=laravel_user
DB_PASSWORD=your_password

10. 运行Laravel迁移

若项目使用了数据库迁移,可运行以下命令创建数据表结构:

cd /var/www/yourdomain.com
sudo -u www-data php artisan migrate

11. 安装Composer依赖

在服务器上安装项目所需的所有PHP依赖包:

sudo -u www-data composer install --no-interaction --prefer-dist --optimize-autoloader

12. 设置文件权限(再次)

Laravel的`storage`和`bootstrap/cache`目录需要可写权限,以便框架存储日志和缓存文件:

sudo chown -R www-data:www-data /var/www/yourdomain.com/storage
sudo chown -R www-data:www-data /var/www/yourdomain.com/bootstrap/cache

13. 配置SSL(可选)

为提升网站安全性,建议启用HTTPS。可使用Let’s Encrypt免费获取SSL证书:

sudo apt install certbot python3-certbot-nginx
sudo certbot --nginx -d yourdomain.com -d www.yourdomain.com

根据Certbot提示完成证书申请和Nginx配置的自动更新。

完成以上步骤后,您的Laravel应用程序应已在LNMP环境中稳定运行。整个过程涵盖了环境搭建、服务配置、代码部署和数据初始化,每一步都确保到位后,访问域名即可看到应用界面。

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章