按流程30分钟内可完成Laravel项目部署:安装LNMP(PHP 8.2+必要扩展)、创建站点并选Laravel5伪静态、上传项目设storage/cache权限755、配置.env与数据库、执行key:generate及缓存清理。

想把本地写好的Laravel项目放到服务器上跑起来,但卡在环境配置、权限设置、伪静态规则这些环节,页面直接500或404?别折腾了,按这个流程走,30分钟内完成从零到可访问。
安装LNMP环境并启用必要PHP扩展
宝塔面板是最快捷的起点,它能自动匹配Laravel所需的底层组件。登录宝塔后台后,先进入「软件商店」→「运行环境」→搜索“LNMP”,找到官方发布的套件(版本号必须≥7.9),点击安装。
安装时务必勾选PHP 8.2(不是8.0或8.1),并在扩展列表中确认已启用:fileinfo、openssl、mbstring、tokenizer、xml、ctype、json、bcmath、gmp——【缺任何一个,composer install都会报错退出】。
等所有服务状态变为“运行中”,再继续下一步。
创建站点并配置Laravel专属伪静态
进入「网站」模块,点击「添加站点」,填入你的域名(测试可用test.laravel.local)和根目录(如/www/wwwroot/myapp)。
PHP版本选择刚装好的8.2,其他保持默认即可。站点创建成功后,立刻点击该站点右侧的「设置」→「伪静态」→下拉菜单中选择「Laravel5」→保存。
这一步不能跳过,否则所有路由都会返回404,因为Laravel依赖Nginx将请求重写到public/index.php入口文件。
上传项目并初始化关键目录权限
用宝塔「文件」管理器打开站点根目录,清空里面原有的index.html。
方法一:直接拖拽整个Laravel项目文件夹(含app、bootstrap、config等目录)上传到/www/wwwroot/myapp,然后解压;
方法二:用终端执行命令快速拉取骨架:cd /www/wwwroot/myapp && composer create-project laravel/laravel . --no-dev。
上传完成后,右键选中storage和bootstrap/cache两个文件夹 →「权限」→ 设置为755 → 勾选「递归修改」→ 提交。这一步不执行,日志写入失败、缓存无法生成,后续必然报错。
配置.env文件与数据库连接
第一步:在文件管理器中找到.env文件,双击编辑。
第二步:修改关键项:
APP_ENV=production
APP_DEBUG=false
APP_URL=https://yourdomain.com(换成你的真实域名,不要留localhost)
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db(后面要新建同名数据库)
DB_USERNAME=your_db_user
DB_PASSWORD=your_db_pass
第三步:回到宝塔「数据库」模块,点击「添加数据库」,类型选MySQL,数据库名填laravel_db,用户名自动生成或手动输入,密码设一个强密码——【DB_USERNAME和DB_PASSWORD必须与这里完全一致,大小写敏感】。
执行Artisan命令完成最后收尾
打开宝塔「终端」,执行以下三步命令:
① 切换到项目根目录:cd /www/wwwroot/myapp
② 生成应用密钥:php artisan key:generate —— 这步漏掉会导致CSRF验证失败,表单提交全挂。
③ 清除配置缓存:php artisan config:clear && php artisan cache:clear
做完这三步,浏览器访问你的域名,应该能看到Laravel欢迎页。


















