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

部署 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; } - 或者直接选择“Laravel”伪静态模板(宝塔自带)
基本上就这些。刷新网站,看到 Laravel 欢迎页说明部署成功。如果报错,查看 storage/logs/laravel.log 或通过 php artisan serve 测试本地运行情况。整个过程在一键 PHP 环境中非常友好,关键是路径和权限别出错。











