当前位置：首页 > 文章列表 > 文章 > php教程 > 一键部署Laravel项目PHP环境教程

一键部署Laravel项目PHP环境教程

2025-10-08 20:37:47 0浏览收藏

想要快速部署 Laravel 项目？本文为你提供一份详细的**一键 PHP 环境部署 Laravel 项目教程**，以宝塔面板为例，手把手教你轻松搞定。首先，你需要将网站根目录指向 public 文件夹，这是 Laravel 项目的关键入口。接着，上传项目代码，并通过 `composer install` 安装依赖，生成应用密钥。配置好数据库连接信息，并确保 storage 和 bootstrap/cache 目录拥有写入权限。最后，启用伪静态规则，让你的 URL 更加美观。通过本教程，即使是新手也能在宝塔面板等一键 PHP 环境中快速部署 Laravel 项目，解决常见问题，让你的项目顺利上线！别再犹豫，快来学习吧！

部署Laravel项目到宝塔面板需配置网站根目录指向public，上传代码后运行composer install、生成密钥、配置数据库及权限，启用伪静态规则，确保storage和cache目录可写，最后通过日志排查错误。

一键PHP环境如何部署Laravel项目_Laravel项目部署教程

部署 Laravel 项目到一键 PHP 环境（如宝塔面板、phpStudy、WampServer 等）其实并不复杂，只要配置好路径、权限和环境依赖即可。以下是以宝塔面板为例的完整部署流程，其他一键环境大同小异。

设置网站根目录指向 Laravel 的 public 文件夹

Laravel 的入口文件 index.php 在 public/ 目录下，必须确保 Web 服务器（Nginx/Apache）的根目录指向这个文件夹。

操作步骤：

在宝塔面板中添加站点，填写域名（如 laravel.test）
创建完成后，进入“网站设置” → “网站目录”
将“运行目录”改为 /public，并保存
如果使用 Nginx，可点击“配置文件”检查 root 路径是否为：/www/wwwroot/你的项目名/public

上传并安装 Laravel 项目依赖

将本地 Laravel 项目上传到服务器指定目录（如 /www/wwwroot/laravel.test），然后通过命令行安装依赖。

关键操作：

使用 FTP 或宝塔文件管理上传代码到对应目录
进入“终端”或使用宝塔“计划任务”执行 Shell 命令
运行 composer install 安装依赖（需服务器已安装 Composer）
复制 .env.example 为 .env：cp .env.example .env
生成应用密钥：php artisan key:generate

配置数据库与权限

Laravel 需要正确配置数据库连接，并确保 storage 和 bootstrap/cache 目录有写权限。

注意事项：

在宝塔数据库页面创建 MySQL 数据库，填写 .env 中的 DB_CONNECTION、DB_DATABASE、DB_USERNAME、DB_PASSWORD
运行迁移命令：php artisan migrate（如有数据填充可加 --seed）
进入“文件”管理，选中 storage 和 bootstrap/cache 文件夹，右键“权限”，改为 755 或 777
确保 runtime（用于日志）也有写入权限

启用伪静态（URL 重写）

Laravel 路由基于前端控制器，需开启 URL 重写以去除 index.php。

Nginx 配置示例：

在宝塔“网站设置” → “配置文件”中，找到 server 模块

在 location / {} 块中添加或替换为以下规则：

if (!-d $request_filename) {
    set $rule_0 1$rule_0;
}
if (!-f $request_filename) {
    set $rule_0 2$rule_0;
}
if ($rule_0 = "21") {
    rewrite ^/(.*)$ /index.php/$1 last;
}