正文

宝塔面板部署Laravel项目详细流程

admin
admin V管理员 /905阅读/0评论
0303
文章最后更新时间2026年03月03日，若文章内容或图片失效，请留言反馈！
宝塔面板是强大且灵活的服务器管理工具，广泛应用于Linux服务器，本文详细介绍了在宝塔面板上部署Laravel项目的步骤：，1. 安装宝塔面板并配置。，2. 创建网站并上传Laravel项目。，3. 配置Web服务器（如Nginx或Apache）。，4. 设置文件权限和依赖项。，5. 启动和优化Laravel服务。

随着PHP技术的不断发展，Laravel框架已经成为了开发Web应用的首选之一，而宝塔面板作为一款功能强大的服务器管理面板，为开发者提供了便捷的远程服务器管理方案,本文将详细介绍如何使用宝塔面板部署Laravel项目。

准备工作

在开始部署之前,你需要做好以下准备工作：

  1. 一台运行Linux操作系统的服务器，建议使用CentOS 7以上版本。

  2. 已安装PHP，建议版本为PHP 7.3及以上。

  3. 已安装MySQL 或 MariaDB ,并创建了一个数据库和用户。

  4. 已安装Composer ,这是PHP的依赖管理工具。

  5. 准备好了要部署的Laravel项目。

使用宝塔面板部署Laravel项目

登录宝塔面板

通过浏览器访问你的服务器IP地址，并在URL中输入宝塔面板的登录地址（默认为http://your_server_ip:8888）,然后输入账号和密码进行登录。

添加站点并上传项目

  • 在宝塔面板首页，点击左侧菜单栏中的“网站”选项。

  • 点击右上角的“添加站点”按钮，填写站点信息，包括域名、端口、根目录等。

  • 将你的Laravel项目上传到站点根目录下，你可以使用FTP工具（如FileZilla）或宝塔面板的文件管理器上传。

配置Web服务器

Laravel项目需要配合Nginx或Apache服务器运行,这里以Nginx为例：

  • 点击左侧菜单栏中的“软件商店”,搜索并安装Nginx。

  • 在宝塔面板中，点击“网站”选项，选择你的站点，然后点击右侧的“设置”按钮。

  • 在设置页面中，找到“配置文件”一项，修改为Nginx的配置文件路径（通常位于/etc/nginx/sites-available/或/usr/local/nginx/conf/）。

  • 编辑Nginx配置文件,添加以下内容：

server {
    listen 80;
    server_name your_domain.com;
    root /path/to/your/laravel-project/public;
    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-XSS-Protection "1; mode=block";
    add_header X-Content-Type-Options "nosniff";
    index index.html index.htm index.php;
    charset utf-8;
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }
    error_page 404 /index.php;
    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php7.3-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }
    location ~ /\.(?!well-known).* {
        deny all;
    }
}
  • 保存配置文件,并重启Nginx服务：
sudo service nginx restart

安装Laravel依赖

进入你的Laravel项目根目录,运行以下命令安装项目依赖：

composer install

配置数据库连接

编辑.env文件,填写数据库连接信息，

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_database_user
DB_PASSWORD=your_database_password

然后运行以下命令生成数据库迁移文件和数据表结构：

php artisan migrate

优化配置和部署

  • 清除浏览器缓存和Nginx缓存。

  • 修改.env文件中的APP_URL为你的域名。

  • 在宝塔面板中，点击左侧菜单栏中的“网站”选项，选择你的站点，然后点击右侧的“重启”按钮重启Nginx服务。

至此,你已经成功使用宝塔面板部署了Laravel项目。

通过本文的详细步骤，你应该已经学会了如何使用宝塔面板部署Laravel项目，在实际操作中，可能会遇到一些问题，比如权限设置错误、端口冲突等，这时，你需要根据自己的实际情况进行排查和解决，希望本文能帮助你顺利部署Laravel项目,提升开发效率。