一键PHP环境如何部署Laravel项目_Laravel项目部署教程-php教程-PHP中文网

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

雪夜

发布： 2025-10-08 11:15:02

原创

847人浏览过

部署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 目录有写权限。

笔目鱼英文论文写作器

写高质量英文论文，就用笔目鱼

查看详情

立即学习“PHP免费学习笔记（深入）”；

注意事项：

在宝塔数据库页面创建 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;
}

登录后复制