在宝塔面板安装Laravel需三步:先安装LNMP环境并启用PHP 8.1/8.2及九项核心扩展;再创建站点并设运行目录为/public、伪静态选Laravel 5;最后用Composer部署项目、配置.env为生产模式、清缓存并设storage与bootstrap/cache权限为755。

在宝塔面板环境下安装Laravel框架,需绕过手动编译和复杂依赖配置,直接利用面板的LNMP环境、可视化网站管理与终端命令协同完成——从PHP扩展启用到项目骨架生成,每一步都依赖宝塔特定路径和权限约束。
安装匹配的LNMP运行环境
登录宝塔面板后台,在左侧菜单点击「软件商店」→ 搜索框输入“LNMP” → 找到官方发布的LNMP一键安装包(版本号必须≥7.9)。
点击安装按钮,在弹窗中【务必勾选PHP 8.2或8.1】,同时确认已启用opcache、fileinfo、openssl、pdo、mbstring、tokenizer、xml、ctype、json这九项核心扩展——缺任一者,后续composer install或artisan命令会直接中断报错。
点击立即安装,等待状态变为“运行中”。安装完成后,进入「PHP管理」→ 点击对应PHP版本 → 「配置修改」→ 检查open_basedir字段为空;若非空,手动清空并保存。
创建支持伪静态的Laravel站点
进入「网站」模块 → 点击「添加站点」→ 填写域名(如test.laravel.com,本地测试可用IP+端口)、根目录设为/www/wwwroot/laravel-test。
PHP版本选择刚安装的8.2,其他选项保持默认 → 提交创建。
创建成功后,立即点击该站点右侧的「设置」→ 切换至「网站目录」选项卡 → 将「运行目录」下拉选择【/public】(不是“不设置”,也不是“/”)→ 点击「保存」。
接着切换到「伪静态」选项卡 → 在下拉菜单中选择「Laravel 5」→ 点击「保存」。此时Nginx配置会自动重载,无需手动点「重载配置」按钮。
通过终端部署Laravel项目骨架
方法一:使用Composer直接拉取稳定版(推荐,兼容所有宝塔环境)
① 点击面板左侧「终端」→ 输入命令切换至站点根目录:cd /www/wwwroot/laravel-test
② 执行Laravel官方create-project命令:composer create-project laravel/laravel . --no-dev
③ 命令执行完毕后,运行cp .env.example .env复制环境配置文件。
④ 再执行php artisan key:generate生成APP_KEY——这一步漏掉会导致CSRF验证失败、Session无法写入。
方法二:用curl管道脚本(仅限已启用Docker的宝塔环境)
在终端中运行:curl -s https://laravel.build/example-app | bash。若提示command not found或Permission denied,说明Docker未安装或未启动,立刻退回方法一,不要强行启用Docker。
注意:执行上述任一方法前,确保当前用户有/www/wwwroot/laravel-test目录的写权限。宝塔终端默认以www用户运行,若上传过代码但属主是root,需先执行chown -R www:www /www/wwwroot/laravel-test。
配置生产环境关键项
进入「文件」管理器 → 定位到/www/wwwroot/laravel-test → 找到.env文件 → 双击编辑 → 修改以下三行:
APP_ENV=production
APP_DEBUG=false
APP_URL=https://test.laravel.com(若未配SSL,暂用http,但上线前必须同步为HTTPS)
回到终端,仍在项目根目录下,依次执行:php artisan config:clearphp artisan cache:clearphp artisan view:clear
最后,右键点击storage和bootstrap/cache两个文件夹 → 「权限」→ 将数字权限改为755,属主保持www → 点击确定。这一步不做,日志写不进、缓存无法生成、队列启动失败都会发生。


















